awesome-design-md
Primary design skill — the default for ALL design tasks across every project. Loaded automatically whenever a design, UI, UX, or visual task is requested. After any design deliverable is produced, thi
SKILL.mdskills/awesome-design-md/SKILL.md
GitHubAwesome Design MD
Primary design execution skill — loaded by default for every design task.
Workflow
Every design task follows this two-phase workflow:
Phase 1 — Execute
- Understand the request — identify the product domain, audience, and key interaction patterns
- Select reference design(s) — search
design-refs/for the closest match (or fuse two) - Apply design tokens — extract colors, typography, spacing, motion, and component patterns from the reference
- Implement — produce UI code, design tokens, or component specs using the reference as the north star
- Annotate — document design decisions, token mappings, and deviations from the reference
Phase 2 — Review Pass (MANDATORY)
Never mark design work complete without running this pass.
The review pass checks:
- Visual fidelity — do the implemented components match the reference's aesthetic?
- Token adherence — are CSS variables / design tokens correctly mapped?
- Typography consistency — font family, scale, weight, and tracking match reference?
- Spacing & rhythm — do margins, padding, and gap values follow the reference system?
- Component completeness — are all states covered (default, hover, active, disabled, error)?
- Accessibility — contrast ratios, focus states, and semantic HTML
- Responsive behavior — does the design scale gracefully across breakpoints?
Review findings → document as a numbered list of fixes. Apply fixes before declaring done.
Delegation
If the design task spans multiple domains, delegate sub-tasks to specialized agents:
frontendskill → implement UI componentsfigmaskill → produce Figma assets or import design to Figmahuashu-designskill → HTML prototypes, app mockups, design philosophy exploration, animation/MP4/GIF exportdesign-reviewskill → external design audit (optional deep pass)copywritingskill → product copy and microcopy within the design
Always delegate AFTER Phase 1 execution, not instead of it.
Reference Library: design-refs/
59 design systems are available. Search by product domain or keyword:
| File | Domain / Aesthetic |
|---|---|
| airbnb.md | Travel marketplace, warm coral accent, photography-driven, rounded UI |
| airtable.md | Collaborative spreadsheet, colorful, blocks-based |
| apple.md | Premium hardware/software, minimal, typography-first |
| bmw.md | Luxury automotive, dark, precision engineering |
| cal.md | Calendar/scheduling, clean, time-focused |
| claude.md | AI chat, conversational, readable, warm |
| clay.md | Sales/pipeline, dark luxury, gradient accents |
| clickhouse.md | Data/analytics, technical, monospace, high-density |
| cohere.md | AI/ML platform, minimal, developer-friendly |
| coinbase.md | Crypto exchange, clean, trust-forward |
| composio.md | AI integrations, tool-focused, developer aesthetic |
| cursor.md | AI IDE, minimal dark, coding-first |
| elevenlabs.md | Audio/AI, futuristic, sound-wave motifs |
| expo.md | React Native dev, approachable, friendly |
| ferrari.md | Luxury automotive, deep red, precision |
| figma.md | Design tool, grid-focused, minimal chrome |
| framer.md | No-code web builder, kinetic, modern |
| hashicorp.md | Infrastructure tooling, developer, minimal |
| ibm.md | Enterprise software, systematic, IBM Plex |
| intercom.md | Customer messaging, friendly, conversational |
| kraken.md | Crypto exchange, bold, dark |
| lamborghini.md | Super-luxury automotive, angular, aggressive |
| linear.app.md | Project management, minimal, keyboard-first |
| lovable.md | AI app builder, friendly, accessible |
| mintlify.md | Documentation, clean, developer-focused |
| miro.md | Whiteboard/collaboration, infinite canvas |
| mistral.ai.md | AI/ML platform, elegant, European minimal |
| mongodb.md | Database, technical, leaf-green brand |
| notion.md | All-in-one workspace, block-based, versatile |
| nvidia.md | GPU/AI hardware, futuristic, dark |
| ollama.md | Local AI, developer, terminal-forward |
| opencode.ai.md | AI code platform, developer, minimal |
| pinterest.md | Visual discovery, grid, masonry, inspirational |
| posthog.md | Product analytics, clean, data-forward |
| raycast.md | Productivity tool, spotlight-style, fast |
| renault.md | Automotive, electric, modern European |
| replicate.md | AI model hosting, developer, minimal |
| resend.md | Email API, developer, clean |
| revolut.md | Fintech, dark, premium, card-forward |
| runwayml.md | Video/AI, creative, dark cinematic |
| sanity.md | CMS, developer-friendly, structured |
| semrush.md | SEO/marketing, data-dense, professional |
| sentry.md | Error monitoring, technical, dark |
| spacex.md | Aerospace, futuristic, stark |
| spotify.md | Music streaming, dark, green brand, card-based |
| stripe.md | Payments, clean, confident, trust-forward |
| supabase.md | Backend-as-a-service, developer, open-source |
| superhuman.md | Email client, speed-obsessed, keyboard-first |
| tesla.md | EV/tech, minimal, large type, dark |
| together.ai.md | AI compute, developer, modern |
| uber.md | Mobility/logistics, map-centric, card UI |
| vercel.md | Deployment platform, minimal, monochrome |
| voltagent.md | AI agent platform, clean, technical |
| warp.md | Terminal, retro-futuristic, opinionated |
| webflow.md | No-code web, visual, responsive-first |
| wise.md | Global finance, clean, multi-currency |
| x.ai.md | AI (x.ai Grok), bold, modern |
| zapier.md | Automation, workflow, connector-focused |
Usage Example
User: Build a checkout page inspired by Stripe
→ Load design-refs/stripe.md
→ Extract: colors (#6366f1, #0f172a), typography (Inter, specific scale),
spacing (4px base unit), shadows, border-radius, component states
→ Implement checkout page using these tokens
→ Run Phase 2 Review: token check, state check, accessibility check
→ If issues found: fix before marking done
Design Token Extraction
When applying a reference, extract into this structure:
## Applied Design Tokens (from [reference].md)
### Colors
- Primary: [hex] — usage: [where]
- Background: [hex]
- Text: [hex]
- Accent: [hex]
- Border: [hex]
### Typography
- Font family: [name] with [fallback]
- Heading: [size] / [weight] / [tracking]
- Body: [size] / [weight] / [line-height]
- Mono: [font] for [purpose]
### Spacing
- Base unit: [n]px
- Component padding: [values]
- Section gaps: [values]
### Motion
- Duration: [ms]
- Easing: [function]
- Motion principle: [description]
### Components
- Button: [styles per state]
- Input: [styles per state]
- Card: [shadow, radius, border]
Design Review Checklist
Used in Phase 2 after any implementation:
[ ] Visual hierarchy matches reference
[ ] Color palette applied correctly (primary, secondary, accent, surface)
[ ] Typography scale and weight consistent with reference
[ ] Spacing system follows base unit
[ ] All interactive states implemented (default, hover, active, disabled, focus, error)
[ ] Border radius consistent
[ ] Shadows match reference intensity
[ ] No placeholder or TODOs left in UI
[ ] Accessible contrast (WCAG AA minimum)
[ ] Focus indicators visible
[ ] Responsive at mobile / tablet / desktop
[ ] Design tokens documented in the output
[ ] Any deviations from reference documented and justified
Notes
- When the user's project already has a design system, use it as the primary and layer the reference design on top — don't replace existing tokens wholesale.
- For ambiguous requests, pick the most relevant reference and note the choice in the output. You may fuse two references with a clear justification.
- This skill replaces generic "design" prompts with structured, reference-driven work.