nexu-io/open-design / plugins/_official/atoms/design-extract
design-extract
VerifiedExtract design tokens (color / typography / spacing) from imported source code, screenshots, or Figma exports into the canonical token bag token-map consumes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.2 KB |
| open-design.json | config | 889 B |
SKILL.md
View on GitHub---
name: design-extract
description: Extract design tokens (color / typography / spacing) from imported source code, screenshots, or Figma exports into the canonical token bag token-map consumes.
od:
scenario: code-migration
mode: extract
---
# Design extract
Spec §10 / §21.3.2: tokens scattered across a repo's CSS / theme
files / Tailwind config / styled-components helpers / SCSS partials
need to be lifted into one bag before `token-map` can crosswalk
them onto the active OD design system. This atom does the lifting;
the input shape is intentionally generic so the same atom serves
both code-migration and figma-migration when fed different sources.
## Inputs
- `code/index.json` from `code-import` (code-migration), OR
- `figma/tree.json` from `figma-extract` (figma-migration), OR
- A folder of screenshot images (tune-collab quick-tune flows).
## Output
```text
project-cwd/
└── code/
└── tokens.json # { colors[], typography[], spacing[], radius[], shadow[] }
```
Each token entry carries:
```jsonc
{
"kind": "color",
"name": "primary-500", // optional source name
"value": "#5b8def", // canonical value
"sources": ["styles/global.css:42", "tailwind.config.js:24"],
"usage": ["Header.tsx", "Footer.tsx"]
}
```
`sources[]` and `usage[]` are the audit trail `token-map.unmatched.json`
references when a target token can't be found.
## Convergence
The atom completes when `code/tokens.json` exists. Empty token bags
emit a warning event but do not abort — `token-map` handles the
empty case by skipping its mapping pass.
## Anti-patterns the prompt fragment forbids
- Hard-coded hex values inside JSX literals (`color: '#fff'`) are
tokens for this atom's purposes; record them with `kind:'color'`
and a synthetic name so they don't disappear into the noise.
- Tailwind utility scans must dedupe palette references against the
active theme — never list `bg-blue-500` and `bg-blue-600` as one
token.
## Status
Implemented by the daemon runner in
`apps/daemon/src/plugins/atoms/design-extract.ts`. It scans the indexed
source files, extracts CSS, Tailwind, and JavaScript token evidence, and
writes `code/tokens.json`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |