Skip to content

dvy1987/agent-loom / .agents/skills/design-system

design-system

Verified

Turn 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.

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
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall