Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill design-tokens-skill -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/design-tokens-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/design-tokens-skill/

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

Similar skills

All skills for Design →

From the same set108

The whole set →
wcag-ai-skill The wcag-ai-skill skill turns WCAG 2.2 criteria into working guidance for design, implementation, accessibility checks, remediation, and conformance docs. Use it across a project’s accessibility workflow. CX Codex +1 244installs mobile-app-design mobile-app-design — a reference skill for mobile UI work: Apple HIG, Material 3, WCAG accessibility, thumb zones and adaptive layouts. Useful when a screen needs review before release. CX Codex +1 242installs awesome-design-skills awesome-design-skills is a Claude Code skill that gives an agent one visual style, such as glassmorphism or editorial, for UI work. CX Codex +1 239installs sleek-design-mobile-apps sleek-design-mobile-apps is a Claude Code skill that builds mobile app screens from a brief in Sleek. It can then implement the design in React Native or HTML. CX Codex +1 231installs design-auditor design-auditor scores a UI across 19 categories, from typography to dark mode, and returns a 0-100 rating with issues ranked by severity. CX Codex +1 227installs copywriting-skill A copywriting skill for landing pages, product pages, pricing, emails, and CTAs. Use it when marketing copy needs clearer persuasion without common AI writing habits. CX Codex +1 227installs motion-catalogue motion-catalogue — a router skill for animation, 3D and generative media work: it picks the matching skill from the catalogue and sends you there. CX Codex +1 225installs brand-design-md brand-design-md pulls design specs for brands like Stripe, Linear, and Notion from getdesign.md and applies their styling to UI code. CX Codex +1 224installs

Project sponsors

Companies that keep this analytics open