Design Stylecards
Specs beat vibes. A stylecard is a named aesthetic recipe with exact values — the difference
between "add a nice shadow" (reinvented differently every session) and elevation/md (identical
every time, reviewed once, versioned forever).
design-stylecards list # Catalog index
design-stylecards elevation/md # Show one recipe
design-stylecards apply glass/dark to src/components/Panel.tsx
Why declarative recipes
Pipeline skills (design-to-code, design-context-extract) answer how to produce design output.
Stylecards answer what good looks like — as literal values an agent pastes, not adjectives it
interprets. Inspired by MengTo/Skills' stylecard micro-skills (MIT), consolidated into one catalog
to avoid manifest sprawl.
Workflow
1. Resolve the request to a recipe
Read("references/stylecards.md") # The catalog — always read before choosing
# Match the user's intent to ONE recipe by its Use-When line.
# No match → say so and offer the closest two; never freehand values.
2. Show or apply
- Show: print the recipe verbatim — values, Use-When, Avoid. No paraphrasing values.
- Apply: edit the target file using the recipe's exact values. Adapt only the syntax
(Tailwind arbitrary class ↔ plain CSS ↔ CSS custom property), never the numbers.
3. Respect the recipe's Avoid block
Every recipe ends with falsifiable Avoid rules (e.g. "never stack two elevation recipes on one
element"). Violating an Avoid rule to satisfy a user request requires saying so explicitly.
Catalog index
Full recipes with exact values: references/stylecards.md.
| Recipe |
Use when |
elevation/sm md lg |
Layered neutral shadows — compact controls / cards / hero surfaces |
glass/dark |
Frosted glass panel on a dark backdrop |
border/gradient |
1px gradient border without a wrapper hack |
background/mesh |
2–3 hue radial mesh page background |
type/editorial |
Display + body + mono role split with tracking values |
motion/budget |
The four allowed durations + the one-signature-moment rule |
Authoring a new stylecard
Add to references/stylecards.md following the contract — a recipe without all three parts is
not shippable:
- Use when — one line, concrete surfaces ("cards, panels, popovers"), not adjectives.
- Values — copy-paste-ready code. Numbers, not descriptions.
- Avoid — falsifiable don'ts observed from real misuse.
Source recipes from shipped, reviewed UI (this repo's playground standard, production apps you've
extracted with design-context-extract) — never from imagination.
Anti-Patterns
- NEVER freehand shadow/gradient/blur values when a recipe exists — that defeats the catalog
- NEVER paraphrase a recipe's values ("roughly 6% black") — paste them exactly
- NEVER mix two recipes of the same category (two elevations, two glass treatments) on one element
Quality Bar
Done means all of these hold:
- The chosen recipe's Use-When line actually matches the user's surface (quote both if challenged)
- Applied values are byte-identical to the catalog entry — only syntax adapted, never numbers
- No Avoid rule of the applied recipe is violated in the final diff
- New recipes carry all three contract parts: Use-When, exact values, Avoid
Related Skills
ork:design-context-extract — mines new recipe candidates from real apps
ork:design-system-tokens — where recipes graduate into project token architecture
ork:design-to-code — pipeline that consumes stylecards during generation
1---2name: design-stylecards3license: MIT4compatibility: "Claude Code 2.1.277+"5description: "Catalog of named aesthetic recipes: shadow stacks, glass, gradients, type scales as copy-paste values. Use for polished elevation, glassmorphism, mesh backgrounds or any make-it-look-like-X ask."6argument-hint: "[list | <recipe-name> | apply <recipe> to <file>]"7context: fork8# user-typed commands stay interactive; CC >= 2.1.218 backgrounds forks by default (#3093)9background: false10user-invocable: true11model: sonnet12allowed-tools: "Read Grep Glob Edit Write"13skills:14 - design-system-tokens15metadata:16 source: https://skillmd.com/skills/yonatangross/design-stylecards17 category: document-asset-creation18 version: "1.0.0"19 author: "OrchestKit"20 complexity: "low"21 tags: "design, stylecards, shadows, glass, gradients, typography, tailwind, css, aesthetics"22triggers:23 keywords: ["stylecard", "beautiful shadows", "glassmorphism", "glass card", "border gradient", "mesh gradient", "elevation recipe", "make it look polished"]24 examples:25 - "give the cards a polished layered shadow"26 - "apply a glass surface treatment to this panel"27 - "add a subtle border gradient like Linear"28 anti-triggers: [extract, screenshot, audit, tokens-from-source]29---3031# Design Stylecards3233Specs beat vibes. A stylecard is a named aesthetic recipe with **exact values** — the difference34between "add a nice shadow" (reinvented differently every session) and `elevation/md` (identical35every time, reviewed once, versioned forever).3637```bash38design-stylecards list # Catalog index39design-stylecards elevation/md # Show one recipe40design-stylecards apply glass/dark to src/components/Panel.tsx41```4243## Why declarative recipes4445Pipeline skills (`design-to-code`, `design-context-extract`) answer *how to produce* design output.46Stylecards answer *what good looks like* — as literal values an agent pastes, not adjectives it47interprets. Inspired by MengTo/Skills' stylecard micro-skills (MIT), consolidated into one catalog48to avoid manifest sprawl.4950## Workflow5152### 1. Resolve the request to a recipe5354```python55Read("references/stylecards.md") # The catalog — always read before choosing56# Match the user's intent to ONE recipe by its Use-When line.57# No match → say so and offer the closest two; never freehand values.58```5960### 2. Show or apply6162- **Show**: print the recipe verbatim — values, Use-When, Avoid. No paraphrasing values.63- **Apply**: edit the target file using the recipe's exact values. Adapt only the syntax64 (Tailwind arbitrary class ↔ plain CSS ↔ CSS custom property), never the numbers.6566### 3. Respect the recipe's Avoid block6768Every recipe ends with falsifiable Avoid rules (e.g. "never stack two elevation recipes on one69element"). Violating an Avoid rule to satisfy a user request requires saying so explicitly.7071## Catalog index7273Full recipes with exact values: `references/stylecards.md`.7475| Recipe | Use when |76|--------|----------|77| `elevation/sm` `md` `lg` | Layered neutral shadows — compact controls / cards / hero surfaces |78| `glass/dark` | Frosted glass panel on a dark backdrop |79| `border/gradient` | 1px gradient border without a wrapper hack |80| `background/mesh` | 2–3 hue radial mesh page background |81| `type/editorial` | Display + body + mono role split with tracking values |82| `motion/budget` | The four allowed durations + the one-signature-moment rule |8384## Authoring a new stylecard8586Add to `references/stylecards.md` following the contract — a recipe without all three parts is87not shippable:88891. **Use when** — one line, concrete surfaces ("cards, panels, popovers"), not adjectives.902. **Values** — copy-paste-ready code. Numbers, not descriptions.913. **Avoid** — falsifiable don'ts observed from real misuse.9293Source recipes from shipped, reviewed UI (this repo's playground standard, production apps you've94extracted with `design-context-extract`) — never from imagination.9596## Anti-Patterns9798- **NEVER** freehand shadow/gradient/blur values when a recipe exists — that defeats the catalog99- **NEVER** paraphrase a recipe's values ("roughly 6% black") — paste them exactly100- **NEVER** mix two recipes of the same category (two elevations, two glass treatments) on one element101102## Quality Bar103104Done means all of these hold:105- The chosen recipe's Use-When line actually matches the user's surface (quote both if challenged)106- Applied values are byte-identical to the catalog entry — only syntax adapted, never numbers107- No Avoid rule of the applied recipe is violated in the final diff108- New recipes carry all three contract parts: Use-When, exact values, Avoid109110## Related Skills111112- `ork:design-context-extract` — mines new recipe candidates from real apps113- `ork:design-system-tokens` — where recipes graduate into project token architecture114- `ork:design-to-code` — pipeline that consumes stylecards during generation