Skip to content
Content
Skill

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

From plugin
claude2figma
2034 skills
Install
$ npx -y skills add senlindesign/claude2figma --skill reference-interpreter --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/reference-interpreter

Context preview

The summary Claude sees to decide when to auto-load this skill.

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.

SKILL.md

reference-interpreter.SKILL.md
name: reference-interpreter
description: "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."
disable-model-invocation: 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`.

Read more
Ships withclaude2figma

Design System compliance for AI-generated Figma designs. 4 skills, 3-step preflight, zero raw values. Quick start: Clone, copy skills to .claude/skills/, paste your Figma URL into CLAUDE.md, say "let's start". Full install guide below.

Get the whole plugin
Stats
203
Stars
17
Forks
Maintained
Maintenance
MIT
License
4mo ago
Last commit
4mo ago
Created

Repo: senlindesign/claude2figma

Other skills on claude2figma.