AGENT SKILL

design-tokens-pipeline

Use for the W3C DTCG design-token round-trip the TCR design-review loop relies on at G5/G6 - extract tokens out of code (CSS custom properties + Tailwind theme dumps) into a DTCG JSON tree, validate against the DTCG v1.0 rules that break the Tokens-Studio to Style-Dictionary round-trip, and diff two token trees to emit the forward change set AND the inverse revert patch.

适用职业设计师
使用场景视觉设计
License 许可
MIT
最近更新
2026-11-02
Stars
★ 0
Forks
0

01 前言 Front Matter

name
design-tokens-pipeline
metadata
{ "origin": "user" }
description
Use for the W3C DTCG design-token round-trip the TCR design-review loop relies on at G5/G6 - extract tokens out of code (CSS custom properties + Tailwind theme dumps) into a DTCG JSON tree, validate against the DTCG v1.0 rules that break the Tokens-Studio to Style-Dictionary round-trip, and diff two token trees to emit the forward change set AND the inverse revert patch.

02 资源文件 10

03 SKILL.md 正文

<!-- origin: user (design-SOTA research, 2026-06-30); implements DESIGN-WORKFLOW.md §1 (DTCG tokens + Code-Connected components are the ONLY things that round-trip cleanly) + §G6 (every apply-back is a reversible commit), DESIGN-SKILLS-AND-EVAL.md §1.2 (the token spine for G5/G6), FIGMA-SETUP.md §3 (establish the Variables token set BEFORE capture). DTCG = W3C Design Tokens Community Group format spec v1.0 (Oct 28 2025). -->

design-tokens-pipeline Skill

The token spine of the TCR design-review loop (G5 ITERATE / G6 RECONCILE) — the W3C-DTCG round-trip surface. Tokens are the only thing that round-trips losslessly between code and Figma (DESIGN-WORKFLOW.md §1), so this skill is where the durable, revertible design state lives.

Skill location: ~/.claude/skills/design-tokens-pipeline/

Three pure Node CLIs (built-ins only for extract/validate/diff; Style Dictionary + sd-transforms only for the optional transform). Each emits a terminal-state marker.


When to use

  • G0/G5: lift CSS custom properties + a Tailwind theme into a DTCG token tree so Tokens Studio / Style Dictionary can round-trip them ("establish the Variables token set BEFORE capture" — FIGMA-SETUP.md §3).
  • G1 token gate: prove every value is bound (no raw hex that duplicates a token alias).
  • G6 revert edge: diff before/after token trees and emit the inverse patch — the lossless revert artifact the loop's revert-gate relies on.

When NOT to use:

  • Visual capture of the running UI → transpose-to-figma (G2).
  • The critique rubric math → critique-panel / ui-audit Track-B.

The three CLIs

1. extract_tokens.mjs — code → DTCG

Pull design tokens out of code into a DTCG JSON tree (the code is the source of truth for a code-first repo).

$DT = "$HOME/.claude/skills/design-tokens-pipeline"
node $DT/extract_tokens.mjs --css src/theme.css,src/tokens.css --tailwind theme.json --prefix tw --out tokens.json
#   reads `--name: value;` custom properties (any selector; :root recommended) + a Tailwind
#   theme dump; infers DTCG $type; converts `var(--x)` refs to `{group.token}` aliases.
#   -> SUCCESS:design-tokens-extract <n> / FAILED:...

2. validate_tokens.mjs — gate the DTCG file

Check the DTCG v1.0 rules that actually break the Tokens-Studio ⇄ Style-Dictionary round-trip:

rule id meaning
missing-type leaf token has no resolvable $type (own or inherited)
bad-alias a {group.token} alias points at a non-existent token
alias-cycle aliases form a cycle (a → b → a) — Style Dictionary would loop
raw-hex-in-code a $type:color raw hex AND a sibling alias of the same value exists (the §G1 "no raw hex" token gate)
reserved-misuse a $-prefixed key outside the DTCG reserved set
node $DT/validate_tokens.mjs --file tokens.json --strict
#   --strict treats raw-hex-in-code warnings as failures too.
#   -> SUCCESS:design-tokens-validate <n ok> / FAILED:... <n errors>

3. token_diff.mjs — the revert surface

Diff two DTCG trees and emit BOTH the forward change set AND the inverse patch. The inverse patch IS the lossless revert artifact the TCR loop relies on (DESIGN-WORKFLOW.md §G6: "every apply-back is a reversible commit; revert anything that regresses a tracked axis"):

node $DT/token_diff.mjs --before old.json --after new.json --out diff.json --revert revert.json
#   --revert writes a DTCG tree that, applied over `after`, restores `before` exactly.
#   -> SUCCESS:design-tokens-diff <added>+<removed>+<changed> / FAILED:...

Transform (optional) — style-dictionary.config.mjs

Transform the DTCG tree to platform outputs (CSS vars, JS, etc.) via **Style Dictionary 4

  • @tokens-studio/sd-transforms** (npm i the devDependencies first).

DTCG essentials (the format this skill speaks)

  • A token is an object with a $value (and usually a $type); a group is a plain object of tokens/groups and may carry a $type that descendants inherit.
  • Aliases reference another token with {group.token} syntax.
  • Reserved keys start with $: $value, $type, $description, $extensions, $deprecated. Anything else $-prefixed is reserved-misuse.

Where this sits — the loop neighbors

G0/G5 ─ extract_tokens (code -> DTCG) ──▶ validate_tokens (gate) ──▶ Style Dictionary transform
G6   ─ token_diff (forward + inverse patch)  ◀ the lossless revert surface

REQUIRED NEIGHBORS: design-studio (invokes this token spine at G5/G6) · figma (use_figma) + Tokens Studio (the Figma side of the round-trip) · design-system (consumes the validated token set) · figma-implement-design (G6 code-side apply-back).


TDD

cd ~/.claude/skills/design-tokens-pipeline
npm test   # node --test tests/tokens.test.mjs

Covers: CSS custom-property + Tailwind extraction and $type inference · var() → {alias} conversion · all five validation rules (missing-type, bad-alias, alias-cycle, raw-hex-in-code, reserved-misuse) · and the forward diff + inverse-patch round-trip (applying revert.json over after restores before exactly).

04 同仓库更多 Skills

Prekzursil
Prekzursil/agent-skills-toolchain

clarify-requirements

Resolve genuine pre-execution ambiguity by scanning repo context, generating 1-6 grounded options, and asking 1-3 focused questions via AskUserQuestion. NOT for mid-task use (injection risk); NOT when the goal is already unambiguous; use to disambiguate vague prompts before any file edits.

★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

openmm-md

Run FREE, open-source, Windows-native GPU molecular dynamics via the openmm-md MCP (OpenMM + CUDA on the local NVIDIA GPU). Use for protein / protein-ligand MD when you want a free stack or are on Windows without a Schrodinger license. Covers the full workflow (prepare, solvate, minimize, equilibrate, production, analyze, mmgbsa) AND an honest decision guide vs Schrodinger Desmond, including how to run Desmond legitimately on Linux or a cloud GPU with a real license. This is a deliberately LESSER free alternative and does NOT replace the schrodinger MCP tools. Do NOT use it to pick a free tool when a validated FEP+, WaterMap, IFD-MD, or Prime MM-GBSA result is actually required.

Skill与智能体开发
★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

visual-review

Take screenshots of web pages and UI using Playwright for visual review and iteration

演示文稿测试与质量
★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

status

Diagnostic status report — shows metaswarm installation state, project setup, and potential issues

★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

start

Use when starting work on any task, when the user mentions metaswarm, or when the user wants to begin tracked development work

Skill与智能体开发
★ 0
Prekzursil
Prekzursil/agent-skills-toolchain

setup

Interactive project setup — detects your project, configures metaswarm, writes project-local files

★ 0