Agent skill

Token Map

Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume.

Apache-2.0Auto-check passedFrontend & Design

Install Token Map

skills CLI

$ npx skills add nexu-io/open-design --skill token-map -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install nexu-io/open-design token-map --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/nexu-io/open-design.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/_official/atoms/token-map .claude/skills/token-map && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "token-map" agent skill from https://github.com/nexu-io/open-design/tree/main/plugins/_official/atoms/token-map into .claude/skills/token-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "token-map", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/nexu-io/open-design/tree/main/plugins/_official/atoms/token-map

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add nexu-io/open-design --skill token-map -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install nexu-io/open-design token-map --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexu-io/open-design.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/_official/atoms/token-map .agents/skills/token-map && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "token-map" agent skill from https://github.com/nexu-io/open-design/tree/main/plugins/_official/atoms/token-map into .agents/skills/token-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "token-map", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add nexu-io/open-design --skill token-map -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install nexu-io/open-design token-map --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexu-io/open-design.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/_official/atoms/token-map .cursor/skills/token-map && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "token-map" agent skill from https://github.com/nexu-io/open-design/tree/main/plugins/_official/atoms/token-map into .cursor/skills/token-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "token-map", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/nexu-io/open-design.git --path plugins/_official/atoms/token-map

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add nexu-io/open-design --skill token-map -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install nexu-io/open-design token-map --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexu-io/open-design.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/_official/atoms/token-map .gemini/skills/token-map && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "token-map" agent skill from https://github.com/nexu-io/open-design/tree/main/plugins/_official/atoms/token-map into .gemini/skills/token-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "token-map", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install nexu-io/open-design token-map

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add nexu-io/open-design --skill token-map -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/nexu-io/open-design.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/_official/atoms/token-map .github/skills/token-map && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "token-map" agent skill from https://github.com/nexu-io/open-design/tree/main/plugins/_official/atoms/token-map into .github/skills/token-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "token-map", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add nexu-io/open-design --skill token-map -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install nexu-io/open-design token-map --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexu-io/open-design.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/_official/atoms/token-map .opencode/skills/token-map && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "token-map" agent skill from https://github.com/nexu-io/open-design/tree/main/plugins/_official/atoms/token-map into .opencode/skills/token-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "token-map", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: token-map
GitHub stars: 100k
Token cost: ~1.4k tokens
SKILL.md length: 582 words
Files: 3
Skills in repo: 245
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume.

Tasks that involve Design systems
SKILL.md covers Inputs, Output, Semantic token inference and Convergence, plus 2 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Token Map is an agent skill from nexu-io/open-design. Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `examples/semantic-inference-before-after.json` and `open-design.json`).

It sits in Frontend & Design, covering Design systems. It works with Figma. The repository describes itself as: 🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes… The licence is Apache-2.0.

When your agent uses it

Tasks that involve Design systems

Example prompts

“/token-map”

What it can do on your machine

Read from SKILL.md and the folder at commit 3449fa6. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are jsonc).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Token Map loads about 1.4k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 582 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~39
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nexu-io/open-design at commit 3449fa6, republished under its Apache-2.0 licence (© nexu-io). 582 words, ~1,358 tokens.

Download SKILL.mdSave it as .claude/skills/token-map/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: token-map
description: Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume.
od.scenario: figma-migration
od.mode: token-map

Token map

Spec §10 / §21.3.1: every figma-migration / code-migration run crosses the same boundary — "the source has its own tokens; the target uses the active OD design system; we need a deterministic mapping". This atom produces that mapping.

Inputs

figma/tokens.json from figma-extract (figma-migration), OR
code/tokens.json from design-extract (code-migration).
The active design system DESIGN.md (already injected into the prompt; the atom reads from the staged design-system context).

Output

text

project-cwd/
└── token-map/
    ├── colors.json     # { source: '#hex' | 'tokenName', target: '--ds-token' }[]
    ├── typography.json # font + size + weight pairings
    ├── spacing.json    # spacing scale crosswalk
    ├── unmatched.json  # { source: ..., reason: 'no-target-equivalent' }[]
    └── meta.json       # { sourceKind: 'figma' | 'code', generatedAt, atomDigest }

unmatched.json is the audit list a human reviews; the agent must not invent target tokens silently.

Semantic token inference

Figma often exports anonymous source names such as color-3, paint/17, or raw #5B8DEF. Do not ask the user to rename those before mapping. First infer the semantic role from usage evidence:

Node path, component name, instance overrides, variant/state labels, frame name, layer name, and nearby text such as Primary, Selected, Link, Error, Focus, Nav, Button, or CTA.
CSS-like position in the rendered tree: background fill, foreground text/icon, border, divider, overlay, shadow tint, focus ring, status badge, chart series, or brand/accent treatment.
Contrast relationships: a color paired repeatedly with the main canvas is likely foreground; one paired with foreground inside CTA components is likely primary/accent background; a thin outline around interactive elements is likely border or focus-ring.
Reuse topology: a value that appears across primary buttons, selected tabs, and active nav items is stronger evidence for --ds-color-primary than a value that appears once in an illustration.

Use that role evidence to choose among existing active design-system tokens and to decide whether an anonymous token should be renamed or left unmatched before the executable mapping pass. Keep the on-disk token-map contract unchanged: the atom still writes the existing bucket files, unmatched.json, and meta.json only.

For example, this is a useful reasoning note for deciding whether color-3 should map to the active primary token:

jsonc

{
  "source": "color-3",
  "value": "#5B8DEF",
  "role": "primary",
  "targetCandidates": ["--ds-color-primary", "--ds-color-link"],
  "evidence": [
    "Button/Primary fill",
    "Selected tab indicator",
    "Link text in Settings frame"
  ]
}

Then map to an active design-system token only when the evidence is role-based, not value-only. If the top candidates are too close to call, or if the evidence points to conflicting roles (primary vs link vs focus-ring), leave the source token unmatched using the existing no-target-equivalent reason and include the competing candidates in the hint. This keeps automation useful for common anonymous-token cases while preserving human review for ambiguous brand decisions.

Show full SKILL.md (215 more words)Show less

Before / after expectation

Without semantic inference, an anonymous Figma token can only produce an uncertain value-level mapping:

jsonc

{
  "source": "color-3",
  "value": "#5B8DEF",
  "target": null,
  "reason": "no-target-equivalent"
}

With semantic inference, the same token should carry role evidence before it is accepted:

jsonc

{
  "source": "color-3",
  "value": "#5B8DEF",
  "target": "--ds-color-primary",
  "via": "name"
}

This deterministic v1 atom does not claim a measured accuracy lift by itself. Treat the expected improvement as coverage of previously manual anonymous-token cases when the Figma tree contains enough role evidence. Real accuracy numbers require a fixture suite with known source tokens, expected semantic roles, and a before/after agent run. See examples/semantic-inference-before-after.json for a deterministic same-token-batch simulation that compares the old value-level output with the semantic inference output.

Convergence

The atom completes when every input token is either mapped or explicitly recorded under unmatched.json with a non-empty reason. The until evaluator reads tokens.unmatched.length === 0 on strict mode; default is "soft converge" (proceed with unmatched.json populated).

Anti-patterns the prompt fragment forbids

Injecting a new token into DESIGN.md without explicit user approval (use a confirmation GenUI surface for that).
Mapping hex colours by visual proximity alone; perceptual ΔE thresholds belong in the visual-diff evaluator (Phase 7).
Collapsing distinct source tokens onto the same target token silently; record collisions in unmatched.json with reason target-collision.

Status

Implemented by the daemon runner in apps/daemon/src/plugins/atoms/token-map.ts. It parses design-system tokens, performs deterministic mapping, and writes the mapped and unmatched outputs.

Files

SKILL.md and 2 other files in plugins/_official/atoms/token-map of nexu-io/open-design.

SKILL.md
examples/semantic-inference-before-after.json
open-design.json

Open the folder on GitHubat commit 3449fa6

Compare with similar skills

Token Map next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Token Map compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Token Map this skillnexu-io/open-design	100k	—	~1.4k	Automated safety check: Pass	Apache-2.0	today
Figma Design System Builderwarpdotdev/warp	65k	2 repos	~4.4k	Automated safety check: Pass	AGPL-3.0	today
Figma use_figma Plugin API Ruleswarpdotdev/warp	65k	4 repos	~4.4k	Automated safety check: Pass	AGPL-3.0	today
Figma Design System Rules Generatorwarpdotdev/warp	65k	3 repos	~4.6k	Automated safety check: Pass	AGPL-3.0	today
Figma Code Connect Componentswarpdotdev/warp	65k	2 repos	~4.2k	Automated safety check: Pass	AGPL-3.0	today
Cc DesignZeroZ-lab/cc-design	827	—	~2.2k	Automated safety check: Notes	None	3 mo ago

Similar skills

Figma Design System Builder
warpdotdev/warp
Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.
65k GitHub starsUsed in 2 repos~4.4k tokens
Frontend & DesignAuto-check passed
Figma use_figma Plugin API Rules
warpdotdev/warp
Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.
65k GitHub starsUsed in 4 repos~4.4k tokens
Frontend & DesignAuto-check passed
Figma Design System Rules Generator
warpdotdev/warp
Creates project-specific design system rules from your codebase so coding agents implement Figma designs with your components, naming and tokens.
65k GitHub starsUsed in 3 repos~4.6k tokens
Frontend & DesignAuto-check passed
Figma Code Connect Components
warpdotdev/warp
Maps published Figma components to their code implementations with Code Connect, using the Figma MCP suggestion and mapping tools.
65k GitHub starsUsed in 2 repos~4.2k tokens
Frontend & DesignAuto-check passed
Cc Design
ZeroZ-lab/cc-design
High-fidelity HTML design and prototype creation. An agent skill from ZeroZ-lab/cc-design.
827 GitHub stars~2.2k tokensUpdated 3 mo ago
Frontend & DesignAuto-check: notes
Visual Style
calesthio/OpenMontage
Create, extract, and apply portable visual design systems via visual-style.md files.
65k GitHub stars~1.5k tokensUpdated 4 days ago
Frontend & DesignAuto-check passed

More from nexu-io/open-design

All 245 skills in this repo

Humanize PPT
nexu-io/open-design
Turns raw notes into a talk-ready slide outline with per-page image, diagram or video decisions, then checks the rendered deck against that outline.
100k GitHub stars~4k tokensUpdated today
Auto-check passed
Last 30 Days Trend Research
nexu-io/open-design
Produces a cited Markdown briefing on recent community sentiment and social reaction to a topic, labeling every source it could not actually check.
100k GitHub stars~1.3k tokensUpdated today
Auto-check passed
OpenDesign Contribution Flow
nexu-io/open-design
Helps newcomers contribute to OpenDesign: ship a skill or design system, translate docs, fix docs or report a bug, ending in a pull request or issue.
100k GitHub stars~3.5k tokensUpdated today
Auto-check: notes
Chat Motion Overlay Generator
nexu-io/open-design
Turns a chat transcript or screenshot into a configurable animated chat clip, rendered as a Remotion bundle with optional transparency.
100k GitHub stars~1.1k tokensUpdated today
Auto-check passed
Flowai Live Dashboard Template
nexu-io/open-design
Team-management dashboard skill in the FlowAI aesthetic — three tabs (Team Members, Team Details, Activity Log), KPI stat row, member table, role distribution bar chart, online presence and activity…
100k GitHub stars~865 tokensUpdated today
Auto-check passed
Hatch Pet
nexu-io/open-design
Create, repair, validate, preview, and package Codex-compatible animated pet spritesheets from character art, screenshots, generated images, or visual references.
100k GitHub stars~6k tokensUpdated today
Auto-check passed

Works with

Figma

Questions about Token Map

What does Token Map do?

Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume. Token Map is an agent skill from nexu-io/open-design. Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume.

When should I use Token Map?

Token Map fits situations like: tasks that involve Design systems.

How do I install Token Map in Claude Code?

Run `npx skills add nexu-io/open-design --skill token-map -a claude-code`. Or copy the skill folder (plugins/_official/atoms/token-map in nexu-io/open-design) into .claude/skills/token-map in your project. Claude Code loads it when a task matches its description.

How do I install Token Map in Codex?

Run `npx skills add nexu-io/open-design --skill token-map -a codex`. Or copy the skill folder (plugins/_official/atoms/token-map in nexu-io/open-design) into .agents/skills/token-map in your project. Codex loads it when a task matches its description.

Can I use Token Map in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nexu-io/open-design --skill token-map -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/token-map, .gemini/skills/token-map, .github/skills/token-map and .opencode/skills/token-map in your project.

What does Token Map need to run?

SKILL.md names no scripts, command-line tools or credentials: Token Map is instructions for the agent only.

Does Token Map access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Token Map safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Token Map use?

Token Map is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Token Map use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Token Map?

Skills that share tags, products or a category with Token Map: Figma Design System Builder (warpdotdev/warp, 65k stars), Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars), Figma Design System Rules Generator (warpdotdev/warp, 65k stars) and Figma Code Connect Components (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Token Map?

nexu-io (a GitHub organization) maintains it in nexu-io/open-design, which has 99,905 GitHub stars. The repository holds 245 skills in this directory. The repository was last updated on October 8, 2026.

Source: nexu-io/open-design on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Token Map

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Token map

Inputs

Output

Semantic token inference

Before / after expectation

Convergence

Anti-patterns the prompt fragment forbids

Status

Files

Compare with similar skills

Similar skills

More from nexu-io/open-design

Related

Questions about Token Map