dvy1987/agent-loom / .agents/skills/design-system
design-system
VerifiedTurn a chosen design direction into a canonical DESIGN.md plus production tokens that don't look vibecoded — state-level colors (8-step neutral ramp, rest/hover/active/ disabled, focus ring), APCA-checked contrast, typography, spacing/radius/motion/elevation, an icon strategy, and component contracts for the core atoms. Emits tokens in the project's stack format (shadcn HSL vars or Tailwind v4 @theme). Load when the user asks to build a design system, generate design tokens, create a DESIGN.md, set up a theme, design a color or type system, pick icons, or when frontend-design routes here. Replaces design-tokens-craft and icon-craft. Sub-skill of frontend-design. Reads DIRECTION.md first.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.5 KB |
| references/banned-palettes.md | markdown | 2.8 KB |
| references/design-md-template.md | markdown | 3.8 KB |
| references/examples.md | markdown | 1.8 KB |
| references/icon-strategies.md | markdown | 4.3 KB |
| references/state-tokens.md | markdown | 4.2 KB |
| references/svg-craft.md | markdown | 3.6 KB |
| references/token-recipes.md | markdown | 7.4 KB |
| references/typography-pairings.md | markdown | 5.2 KB |
references/examples.md
View on GitHub# Design System — Full Session Examples
Read when you need a complete walkthrough beyond the inline teaser in SKILL.md.
---
## Example 1 — Ledger direction → tokens
**Input:** DIRECTION.md chosen: **Ledger** (Stripe-like B2B)
**Agent actions:**
1. Seed from archetype `enterprise-trust` recipe.
2. Build 8-step neutral ramp + semantic slots (bg, fg, muted, accent) with hover/focus/disabled states.
3. Typography: display GT Sectra / body Inter; spatial 4px grid; motion 150ms ease-out.
4. APCA pass on all text pairs — fix `--secondary-foreground` on dark.
5. Icon strategy: Lucide 1.5px stroke; component contracts for Button, Table, Badge.
6. Emit `DESIGN.md` + `src/styles/tokens.css`.
**Impact Report:** 24 color slots, APCA all pass, 6 component contracts, handoff to `frontend-design`.
---
## Example 2 — Dark mode is not invert
**Input:** Agent inverts light tokens for dark
**Response:** Block — dark is hand-set per DIRECTION.md; inverted lightness reads cheap.
---
## Example 3 — Skip DESIGN.md
**Input:** "Just write the CSS variables"
**Response:** DESIGN.md is the contract — without it each screen re-negotiates and drifts.
---
## Example 4 — Accent-only palette
**Input:** "Primary blue + greys is enough"
**Response:** Slop lives in unstated states — define hover, focus, disabled, error for every semantic slot.
---
## Example 5 — shadcn HSL emit
**Input:** Stack uses shadcn + Tailwind v4
**Output:** Emit HSL tokens in `tokens.css` matching shadcn conventions; document slot mapping in DESIGN.md §Integration.
---
## Verification checklist (full session)
- [ ] Examples demonstrate SKILL.md hard rules, not generic chat
- [ ] Anti-skip or rationalization defense included where applicable
- [ ] Output artifacts or Impact Report shape is explicit
- [ ] Reader can trace input → concrete agent actions → outcome
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |