Files
ADS3-Design-System/.claude/skills/reference-interpreter/SKILL.md
Richie 2205862c2f Add workflow tooling: claude2figma skills, Storybook addons, Figma permissions
Install @storybook/addon-designs for embedding Figma frames in stories
and claude2figma skills (preflight, component-rules, style-binding,
reference-interpreter) for enforcing design token compliance when
writing to Figma. Add PostToolUse hook for use_figma QA reminders and
pre-allow Figma MCP + Code Connect tools in settings.json.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-21 11:28:15 +10:00

2.4 KiB

name, description, disable-model-invocation
name description disable-model-invocation
reference-interpreter Triggers when user shares a screenshot, image, URL, or design description — or says 'analyze this', 'make a brief', 'interpret this reference'. Outputs a structured Design Brief mapping visual intent to design system tokens. Waits for 'confirmed' before designing. false

Reference Interpreter

Analyze a reference (screenshot, URL, or description) and produce a Design Brief that maps visual observations to design system tokens. Output the Brief, then stop and wait for user confirmation before building anything.

Prerequisite: figma-preflight should have run so the Token Map and Style Registry are available.


Phase 1 — Analyze

Examine the reference across these dimensions:

  1. Layout — structure, columns, section heights, grid width, alignment
  2. Typography — heading/body hierarchy, weight contrast, tracking
  3. Color — dark/light sections, accent usage, neutral dominance
  4. Spacing — generous vs compact, section padding, internal gap
  5. Visual Anchor — what draws the eye: large type, hero image, illustration
  6. Components — what UI elements are visible: cards, buttons, forms, nav

Phase 2 — Map to Design System

For each observation, identify the specific Token or Style from the session's Token Map:

"Large dark headline" → Text Style: heading/h1 · Color: text/primary
"Neutral section bg"  → Variable: background/surface-2
"Tight card spacing"  → Gap: gap/xs · Padding: padding/sm

If no token exists, flag it:

⚠️ Gap: [observation] — no matching token. Options: (a) nearest match: [name], (b) add token first.

Phase 3 — Output the Design Brief

## Design Brief

**Reference**: [source]
**Section**: [what this covers]
**Aesthetic**: [3-5 keywords]

### Layout
[structure, height, alignment]

### Typography
- Heading: [Style name] — [why]
- Body: [Style name]

### Colors
- Background: [Variable] — [context]
- Text: [Variable]
- Accent: [Variable] — [used for]

### Spacing
- Section padding: [Variable]
- Internal gap: [Variable]

### Components needed
- [Name]: [from library? source]

### Gaps
- [Gap description] — awaiting decision
- (none) [if all mapped]

Phase 4 — Wait

Output exactly:

Brief complete. Type `confirmed` to begin building, or tell me what to adjust.

Do NOT call use_figma or place any nodes until user types confirmed.