Design Context Skill

When to Use

• Before presenting wireframes (Ask mode DIVERGE)
• Before implementing UI changes (Agent mode)
• At every DIVERGE Loop to stay grounded in existing patterns

Instructions

Phase 1: Design System Check

Read /docs/design-system/components.md
Read /docs/design-system/spacing.md
Read /docs/design-system/colors.md (if color decisions needed)
Read /docs/design-system/interactions.md (if interaction patterns needed)

• Design tokens (

  h-13

  ,

  px-4

  ,

  gap-3

  )
• Component patterns (Button variants, DataTable, Dialog)
• Spacing conventions (p-4 for cards, gap-6 for sections)

Phase 2: Storybook Patterns

Glob **/*.stories.tsx

• Components matching current wireframe needs
• Existing variants and props
• Documented states (loading, error, empty)

• /src/stories/

  - General component stories

• /features/*/components/*.stories.tsx

  - Feature-specific stories

Phase 3: Codebase Search

SemanticSearch "How is [pattern] implemented in the codebase?"

• Similar features already built
• Reusable hooks and utilities
• Existing layout patterns

Phase 4: Library Documentation (Context7 MCP)

1. resolve-library-id with libraryName (e.g., "radix-ui")
2. query-docs with libraryId and specific question

• /radix-ui/primitives

  - Dialog, Dropdown, Select patterns

• /tanstack/query

  - Data fetching patterns

• /tanstack/table

  - Table patterns

Output Format

## Design Context

| Source | Relevant Patterns |
|--------|-------------------|
| Design System | [tokens, components] |
| Storybook | [stories that apply] |
| Codebase | [existing implementations] |
| Libraries | [patterns from docs] |

### Applicable Components
- [Component]: [How it applies to current wireframe]

### Design Tokens to Use
- Spacing: [tokens]
- Colors: [tokens]
- Typography: [tokens]

Invocation

Related Skills

• problem-framing

  - Run before design-context

• competitor-scan

  - Compare with external patterns