design-tokens-skill — Claude Code skill: tokens and setup
The design-tokens-skill skill covers W3C DTCG token architecture, color spaces, aliases, theme resolution, and token tooling. Use it when building or migrating a token pipeline.
MIT 227 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill design-tokens-skill -a claude-codeWhat design-tokens-skill does
design-tokens-skill works with the W3C DTCG model for token files, value types, composite tokens, and links between tokens. It covers sRGB, Display P3, and OKLCH color handling, plus theme resolution for systems with multiple themes.
The skill also covers jq, JSONata, Terrazzo, and exports from Figma. It can guide token architecture, migration to DTCG, and the setup of a pipeline that transforms or resolves token data. For OKLCH color generation without token structure, use color-expert instead.
In Claude Code, the installed skill file is ~/.claude/skills/design-tokens-skill/SKILL.md. The license is MIT.
What it helps with
- design a token structure that follows W3C DTCG
- migrate existing tokens into DTCG format
- trace references and aliases between tokens
- resolve themes across token sets
- process sRGB, Display P3, and OKLCH values
Example prompts for the agent
- Design a W3C DTCG token structure for this project and explain the value types.
- Inspect the token references and aliases, then find issues in theme resolution.
- Plan a token pipeline using
jq, JSONata, and Terrazzo with a Figma export as input.
How to install design-tokens-skill
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-tokens-skill -a claude-code2Manually: put the files in place
~/.claude/skills/design-tokens-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/design-tokens-skill/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-tokens-skill -a codex2Manually: put the files in place
.agents/skills/design-tokens-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-tokens-skill -a cursor2Manually: put the files in place
.cursor/skills/design-tokens-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/design-tokens-skill2Manually: put the files in place
.github/skills/design-tokens-skill/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-tokens-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/design-tokens-skillManually: put the files in place
.devin/skills/design-tokens-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-tokens-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about design-tokens-skill
How do I install design-tokens-skill in Claude Code?
Run npx skills add podo/design-agent-skills --skill design-tokens-skill -a claude-code, then check ~/.claude/skills/design-tokens-skill/SKILL.md.
What does design-tokens-skill do?
It covers W3C DTCG token structure, value types, color spaces, references, composite tokens, and theme resolution. It also works with jq, JSONata, Terrazzo, and Figma exports.
Which platforms support design-tokens-skill?
The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
Source text
SKILL.md · MIT
--- name: design-tokens-skill description: | Expert in the W3C DTCG token specification — token structure, color spaces (sRGB, Display P3, OKLCH), references/aliasing, theme resolvers, and tools (jq, JSONata, Terrazzo, Figma exports). The authoritative skill for design token architecture. triggers: - "design tokens" - "DTCG tokens" - "W3C tokens" - "Terrazzo" - "design-tokens-skill" - "token aliasing" - "token references" das: type: skill category: visual-components upstream: "https://github.com/ilikescience/design-tokens-skill" upstream_path: "SKILL.md" version: latest install: true --- # design-tokens-skill > Catalogue stub — full skill: [ilikescience/design-tokens-skill](https://github.com/ilikescience/design-tokens-skill) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** Upstream names this skill `design-tokens`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/design-tokens/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/design-tokens/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `design-tokens`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/design-tokens-skill ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add ilikescience/design-tokens-skill --skill design-tokens -g -y ``` **Project:** ```bash npx skills add ilikescience/design-tokens-skill --skill design-tokens -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **License:** MIT <!-- das:install:end --> ## Invoke after install - Skill name: `design-tokens` - Triggers: "design tokens", "DTCG tokens", "W3C tokens", "Terrazzo", "token aliasing" ## What it does Deep expertise in the W3C Design Token Community Group (DTCG) specification. Covers token file structure, value types, color space handling (sRGB, Display P3, OKLCH), references and aliasing between tokens, composite tokens, theme resolvers, and the full toolchain: jq, JSONata, Terrazzo, and exporting from Figma. Use when architecting a token system, migrating tokens to DTCG format, or configuring multi-theme token pipelines. ## When NOT to use - OKLCH color generation without token structure — use `color-expert` - Figma-specific token variables UI — use `figma-variables-tokens-generator` - Figma official operations — use `figma-official-skills`
© podo · MIT · podo/design-agent-skills