auv-design
Use this skill to generate well-branded interfaces and assets for AUV (the Moeru AI command-replay / inspect runtime), either for production or throwaway prototypes/mocks. Contains essential design guidelines, colors, type, fonts, assets, and UI kit components for prototyping.
Install
npx skills add https://github.com/moeru-ai/auv/tree/main/docs/design
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install moeru-ai-auv@llmmart
git clone https://github.com/moeru-ai/auv.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole moeru-ai/auv collection as a plugin from our marketplace. Git is the plain clone.
README
auv Design System (vendored)
This directory is a vendored copy of the AUV Design System bundle that was handed off from Claude Design (claude.ai/design) on 2026-05-21.
The original handoff bundle's own README files are preserved verbatim:
HANDOFF_README.md— Claude Design's per-handoff instructions to coding agents.SOURCE_README.md— the design system's own README (product context, voice, visual foundations).SKILL.md— agent-skill metadata.
For agents picking up the already-landed viewer implementation or remaining follow-on design work, read:
IMPLEMENTATION_HANDOFF.md— cold- start spec: what shipped, what's left, exact visual + data contracts for each remaining phase. Designed so an agent with no prior session context can implement a phase end-to-end.
Why vendor it?
The Rust runtime today consumes exactly one part of the design
system at compile time — the cursor sprite + brand pill in
crates/auv-driver-overlay-macos/native/swift/Sources/AuvMacosOverlayNative/Overlay.swift,
which ports rect data verbatim from assets/cursor-auv.svg.
The rest of the bundle is reference material for surfaces that do not
exist in the repo yet (the browser-based inspect viewer, an HTML CLI
mock, the broader component library). Keeping the canonical assets +
tokens in docs/design/ means future implementations can match
pixel-perfectly against the same source the Overlay.swift sprite came
from, without re-fetching the original bundle.
Layout
| Path | Purpose |
|---|---|
assets/ |
Logo marks, cursor sprites, accents, sprite icons. All SVG (pixel-art, viewBox="0 0 24 24", shape-rendering="crispEdges"). |
colors_and_type.css |
Single source of truth for design tokens — colors, type stack, spacing, radii, shadows, motion. |
preview/ |
One-card-per-concept HTML previews (color cards, type cards, component cards). |
ui_kits/cli/ |
High-fidelity HTML recreation of auv-cli terminal output. Not yet wired into the Rust CLI. |
ui_kits/viewer/ |
Speculative recreation of the still-unbuilt browser viewer described in docs/ai/references/inspect/2026-05-19-trace-run-inspect-design.md. |
What's implemented from this bundle
| Bundle element | Repo location | Status |
|---|---|---|
assets/cursor-auv.svg rect data |
crates/auv-driver-overlay-macos/.../Overlay.swift (auvSprite) |
done (Phase A) |
assets/cursor-you.svg rect data |
crates/auv-driver-overlay-macos/.../Overlay.swift (youSprite) |
ported (used by viewer mocks, not by the live overlay yet) |
Brand cyan pill (#009ba6) |
crates/auv-driver-overlay-macos/.../Overlay.swift |
done (Phase A) |
assets/logo-mark.svg (top-bar pixel logo) |
crates/auv-inspect-server/viewer/src/App.vue |
done (Phase C.1; served from Vite build) |
colors_and_type.css core tokens (shell, brand, status) |
crates/auv-inspect-server/viewer/src/styles/viewer.css |
done (Phase C.1; served from Vite build) |
ui_kits/viewer/Sidebar.jsx (run list) |
crates/auv-inspect-server/viewer/src/App.vue + src/viewer.ts |
done (Phase C.1; served from Vite build) |
ui_kits/viewer/SpanTree.jsx |
crates/auv-inspect-server/viewer/src/App.vue + src/viewer.ts |
done (Phase C.2; served from Vite build) |
ui_kits/viewer/EventsRail.jsx |
crates/auv-inspect-server/viewer/src/App.vue + src/viewer.ts |
done (Phase C.3a; served from Vite build) |
ui_kits/viewer/ArtifactPanel.jsx |
crates/auv-inspect-server/viewer/src/App.vue + src/viewer.ts |
done (Phase C.3b; served from Vite build) |
WebSocket live streaming on /runs/:id/stream |
crates/auv-inspect-server/viewer/src/viewer.ts + crates/auv-inspect-server/src/server.rs |
done (Phase C.4; served from Vite build) |
Extract assets to /assets/:name route |
crates/auv-inspect-server/src/server.rs |
done (Phase C.5, landed early) |
assets/cursor-auv-click.svg (4-ray burst) |
— | pending (future Overlay click-state) |
ui_kits/cli/* |
— | reference only; the Rust CLI ships plain text today |
Editing this directory
This is a vendored bundle. If the design system updates upstream, replace
the contents wholesale rather than hand-editing files here. The original
bundle ID was Cnhoa_hmraSs_HJx96DFxw; re-fetch from
https://api.anthropic.com/v1/design/h/<id> to obtain a fresh tarball.
The one file in this directory that is not part of the upstream
bundle is this README.md — it records the vendoring decision and the
implementation status. Keep it in sync with what the repo actually
consumes from the bundle.
Skill manifest
AUV Design
Read README.md in this skill first — it establishes product context, content
fundamentals (the deliberately anti-marketing AUV voice), visual foundations,
and iconography rules.
Then explore the other files:
colors_and_type.css— all design tokens (--auv-*).assets/— logo mark + wordmark.preview/— small reference cards for each system concept.ui_kits/cli/—auv-cliterminal output recreation.ui_kits/viewer/— speculative inspect-viewer mock (the browser viewer described in2026-05-19-trace-run-inspect-design.md; not built yet in the source repo).
Operating principles for this brand
- Honesty over polish. AUV documents what is
validated,candidate, andnot-validatedin JSON. Reflect that in every artifact. Never invent a status not on the canonical list. - Monospace carries identity. IDs, paths, span names, and JSON keys
live in
JetBrains Mono. Body prose lives inGeist. - No emoji. No gradients. No glassy overlays. This is forensic-grade UI.
- Status pill is the smallest unit. Use
.auv-status--{validated, candidate, boundary, frozen, running, failed}everywhere a status is shown — sidebars, lists, headers, terminal output, marketing.
When the user invokes this skill
If creating visual artifacts (slides, mocks, throwaway prototypes), copy
assets out of this skill and produce static HTML the user can view. Reuse the
<Terminal> / <SpanTree> / <Sidebar> components from the UI kits when the
output is product-facing.
If working on production code (Rust CLI, future browser viewer, future docs
site), copy colors_and_type.css and assets/logo-*.svg into the project,
and follow the rules in README.md (sections Content Fundamentals and
Visual Foundations) to extend the system.
If invoked without other guidance, ask the user what they want to build — typical asks are:
- a mock of
auv-clioutput for a docs page or social post - a wireframe / mock of the inspect viewer
- a slide deck explaining a phase-1 boundary
- copy in the AUV voice (status report, freeze note, boundary callout)
Then act as an expert designer on the AUV brand and output HTML artifacts or production code, depending on the need.
Files (auv)
-
assets
-
accent-bandage.svg 1.2 KB · in bundle
-
accent-hairclip.svg 751 B · in bundle
-
accent-heart.svg 630 B · in bundle
-
accent-star.svg 758 B · in bundle
-
cursor-auv-click.svg 2.3 KB · in bundle
-
cursor-auv.svg 1.8 KB · in bundle
-
cursor-you.svg 1.7 KB · in bundle
-
icon-bin.svg 827 B · in bundle
-
icon-json.svg 1.3 KB · in bundle
-
icon-png.svg 802 B · in bundle
-
logo-mark.svg 2.1 KB · in bundle
-
logo-wordmark.svg 4 KB · in bundle
-
moeru-ai-logo.png 6.5 KB · in bundle
-
moeru-ai-logo.svg 151.4 KB · in bundle
-
sparkle.svg 945 B · in bundle
-
sprite-check.svg 633 B · in bundle
-
sprite-hourglass.svg 826 B · in bundle
-
sprite-inspector.svg 6.6 KB · in bundle
-
sprite-moe.svg 1.2 KB · in bundle
-
sprite-prompt.svg 642 B · in bundle
-
sprite-x.svg 827 B · in bundle
-
-
preview
-
brand-cli-welcome.html 1.6 KB · in bundle
-
brand-hero.html 3.4 KB · in bundle
-
brand-logo.html 974 B · in bundle
-
brand-moeru.html 2.8 KB · in bundle
-
brand-pixel-motifs.html 4.6 KB · in bundle
-
brand-replay-cursor.html 6.1 KB · in bundle
-
brand-terminal.html 1.4 KB · in bundle
-
card.css 3.5 KB · in bundle
-
color-brand.html 2.9 KB · in bundle
-
color-disturbance.html 2.2 KB · in bundle
-
color-neutrals-paper.html 1.7 KB · in bundle
-
color-neutrals-shell.html 2.1 KB · in bundle
-
color-status.html 2.5 KB · in bundle
-
component-buttons.html 2.4 KB · in bundle
-
component-callouts.html 1.5 KB · in bundle
-
component-cursors.html 3.1 KB · in bundle
-
component-disturbance.html 1.7 KB · in bundle
-
component-manifest.html 1.4 KB · in bundle
-
component-pills-pixel.html 2.1 KB · in bundle
-
component-pills.html 1.3 KB · in bundle
-
component-recipe-card.html 1.4 KB · in bundle
-
component-run-list.html 2.9 KB · in bundle
-
component-span-tree.html 1.9 KB · in bundle
-
component-statusbar.html 1.8 KB · in bundle
-
spacing-radii.html 1.6 KB · in bundle
-
spacing-scale.html 3.6 KB · in bundle
-
spacing-shadows.html 1.7 KB · in bundle
-
type-families.html 1.9 KB · in bundle
-
type-mono.html 866 B · in bundle
-
type-pixel.html 1.5 KB · in bundle
-
type-scale.html 2.7 KB · in bundle
-
-
ui_kits
-
cli
-
index-print.html 4.9 KB · in bundle
-
index.html 2.7 KB · in bundle
-
Prompt.jsx 3.1 KB · in bundle
-
README.md 1.5 KB
Loading… -
Sessions.jsx 6.5 KB · in bundle
-
Terminal.jsx 3.4 KB · in bundle
-
tokens.js 867 B
Loading…
-
-
viewer
-
ArtifactPanel.jsx 6.4 KB · in bundle
-
data.js 5.5 KB
Loading… -
EventsRail.jsx 3.1 KB · in bundle
-
index.html 3.1 KB · in bundle
-
Layout.jsx 3.8 KB · in bundle
-
README.md 2 KB
Loading… -
Sidebar.jsx 4.9 KB · in bundle
-
SpanTree.jsx 4.6 KB · in bundle
-
-
-
colors_and_type.css 13.1 KB · in bundle
-
HANDOFF_README.md 1.5 KB
Loading… -
IMPLEMENTATION_HANDOFF.md 16.4 KB
Loading… -
README.md 4.6 KB
# `auv` Design System (vendored) This directory is a **vendored copy** of the AUV Design System bundle that was handed off from Claude Design (claude.ai/design) on **2026-05-21**. The original handoff bundle's own README files are preserved verbatim: - [`HANDOFF_README.md`](./HANDOFF_README.md) — Claude Design's per-handoff instructions to coding agents. - [`SOURCE_README.md`](./SOURCE_README.md) — the design system's own README (product context, voice, visual foundations). - [`SKILL.md`](./SKILL.md) — agent-skill metadata. For agents picking up the **already-landed viewer implementation** or remaining follow-on design work, read: - [`IMPLEMENTATION_HANDOFF.md`](./IMPLEMENTATION_HANDOFF.md) — cold- start spec: what shipped, what's left, exact visual + data contracts for each remaining phase. Designed so an agent with no prior session context can implement a phase end-to-end. ## Why vendor it? The Rust runtime today consumes exactly **one** part of the design system at compile time — the cursor sprite + brand pill in `crates/auv-driver-overlay-macos/native/swift/Sources/AuvMacosOverlayNative/Overlay.swift`, which ports rect data verbatim from `assets/cursor-auv.svg`. The rest of the bundle is reference material for surfaces that **do not exist in the repo yet** (the browser-based inspect viewer, an HTML CLI mock, the broader component library). Keeping the canonical assets + tokens in `docs/design/` means future implementations can match pixel-perfectly against the same source the Overlay.swift sprite came from, without re-fetching the original bundle. ## Layout | Path | Purpose | |---|---| | `assets/` | Logo marks, cursor sprites, accents, sprite icons. All SVG (pixel-art, `viewBox="0 0 24 24"`, `shape-rendering="crispEdges"`). | | `colors_and_type.css` | Single source of truth for design tokens — colors, type stack, spacing, radii, shadows, motion. | | `preview/` | One-card-per-concept HTML previews (color cards, type cards, component cards). | | `ui_kits/cli/` | High-fidelity HTML recreation of `auv-cli` terminal output. Not yet wired into the Rust CLI. | | `ui_kits/viewer/` | Speculative recreation of the still-unbuilt browser viewer described in `docs/ai/references/inspect/2026-05-19-trace-run-inspect-design.md`. | ## What's implemented from this bundle | Bundle element | Repo location | Status | |---|---|---| | `assets/cursor-auv.svg` rect data | `crates/auv-driver-overlay-macos/.../Overlay.swift` (auvSprite) | done (Phase A) | | `assets/cursor-you.svg` rect data | `crates/auv-driver-overlay-macos/.../Overlay.swift` (youSprite) | ported (used by viewer mocks, not by the live overlay yet) | | Brand cyan pill (`#009ba6`) | `crates/auv-driver-overlay-macos/.../Overlay.swift` | done (Phase A) | | `assets/logo-mark.svg` (top-bar pixel logo) | `crates/auv-inspect-server/viewer/src/App.vue` | done (Phase C.1; served from Vite build) | | `colors_and_type.css` core tokens (shell, brand, status) | `crates/auv-inspect-server/viewer/src/styles/viewer.css` | done (Phase C.1; served from Vite build) | | `ui_kits/viewer/Sidebar.jsx` (run list) | `crates/auv-inspect-server/viewer/src/App.vue` + `src/viewer.ts` | done (Phase C.1; served from Vite build) | | `ui_kits/viewer/SpanTree.jsx` | `crates/auv-inspect-server/viewer/src/App.vue` + `src/viewer.ts` | done (Phase C.2; served from Vite build) | | `ui_kits/viewer/EventsRail.jsx` | `crates/auv-inspect-server/viewer/src/App.vue` + `src/viewer.ts` | done (Phase C.3a; served from Vite build) | | `ui_kits/viewer/ArtifactPanel.jsx` | `crates/auv-inspect-server/viewer/src/App.vue` + `src/viewer.ts` | done (Phase C.3b; served from Vite build) | | WebSocket live streaming on `/runs/:id/stream` | `crates/auv-inspect-server/viewer/src/viewer.ts` + `crates/auv-inspect-server/src/server.rs` | done (Phase C.4; served from Vite build) | | Extract assets to `/assets/:name` route | `crates/auv-inspect-server/src/server.rs` | done (Phase C.5, landed early) | | `assets/cursor-auv-click.svg` (4-ray burst) | — | pending (future Overlay click-state) | | `ui_kits/cli/*` | — | reference only; the Rust CLI ships plain text today | ## Editing this directory This is a vendored bundle. If the design system updates upstream, replace the contents wholesale rather than hand-editing files here. The original bundle ID was `Cnhoa_hmraSs_HJx96DFxw`; re-fetch from `https://api.anthropic.com/v1/design/h/<id>` to obtain a fresh tarball. The one file in this directory that is **not** part of the upstream bundle is this `README.md` — it records the vendoring decision and the implementation status. Keep it in sync with what the repo actually consumes from the bundle. -
SKILL.md 2.6 KB
--- name: auv-design description: Use this skill to generate well-branded interfaces and assets for AUV (the Moeru AI command-replay / inspect runtime), either for production or throwaway prototypes/mocks. Contains essential design guidelines, colors, type, fonts, assets, and UI kit components for prototyping. user-invocable: true --- # AUV Design Read `README.md` in this skill first — it establishes product context, content fundamentals (the deliberately anti-marketing AUV voice), visual foundations, and iconography rules. Then explore the other files: - `colors_and_type.css` — all design tokens (`--auv-*`). - `assets/` — logo mark + wordmark. - `preview/` — small reference cards for each system concept. - `ui_kits/cli/` — `auv-cli` terminal output recreation. - `ui_kits/viewer/` — speculative inspect-viewer mock (the browser viewer described in `2026-05-19-trace-run-inspect-design.md`; **not built yet** in the source repo). ## Operating principles for this brand 1. **Honesty over polish.** AUV documents what is `validated`, `candidate`, and `not-validated` in JSON. Reflect that in every artifact. Never invent a status not on the canonical list. 2. **Monospace carries identity.** IDs, paths, span names, and JSON keys live in `JetBrains Mono`. Body prose lives in `Geist`. 3. **No emoji. No gradients. No glassy overlays.** This is forensic-grade UI. 4. **Status pill is the smallest unit.** Use `.auv-status--{validated, candidate, boundary, frozen, running, failed}` everywhere a status is shown — sidebars, lists, headers, terminal output, marketing. ## When the user invokes this skill If creating visual artifacts (slides, mocks, throwaway prototypes), copy assets out of this skill and produce static HTML the user can view. Reuse the `<Terminal>` / `<SpanTree>` / `<Sidebar>` components from the UI kits when the output is product-facing. If working on production code (Rust CLI, future browser viewer, future docs site), copy `colors_and_type.css` and `assets/logo-*.svg` into the project, and follow the rules in `README.md` (sections **Content Fundamentals** and **Visual Foundations**) to extend the system. If invoked without other guidance, ask the user what they want to build — typical asks are: - a mock of `auv-cli` output for a docs page or social post - a wireframe / mock of the inspect viewer - a slide deck explaining a phase-1 boundary - copy in the AUV voice (status report, freeze note, boundary callout) Then act as an expert designer on the AUV brand and output HTML artifacts or production code, depending on the need. -
SOURCE_README.md 13.7 KB
Loading…
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.