Reference Interpreter
Designreference-interpreterReference Interpreter is an Agent Skill for design published in the senlindesign/claude2figma repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/senlindesign/claude2figma/blob/HEAD/.claude/skills/reference-interpreter/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/reference-interpreter, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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:
- Layout — structure, columns, section heights, grid width, alignment
- Typography — heading/body hierarchy, weight contrast, tracking
- Color — dark/light sections, accent usage, neutral dominance
- Spacing — generous vs compact, section padding, internal gap
- Visual Anchor — what draws the eye: large type, hero image, illustration
- 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.