design-token-steward
Use when a color, spacing, radius, type, or motion value would be introduced or changed in UI — route it through the single tokens source of truth so it cascades, instead of hard-coding a one-off valu
SKILL.mdproject-trajectory/skills/design-token-steward/SKILL.md
GitHubWhen to use. On any visual value change. Why: one-off hex/px values are how a design system rots; tokens keep "primary" meaning one thing everywhere and make dark/light + rebrands a one-file edit.
Procedure.
- Check whether a token already expresses the value; reuse it.
- If new, add it to the tokens file with a name and provenance note (why it exists), then reference it.
- Confirm light and dark render; confirm nothing else regressed that consumed the old value.
- Done when: no raw color/space literal in the component diff, and the token resolves in both themes.
Knowledge: KNOWLEDGE-LIBRARY.md §A1 (W3C Design Tokens format, Radix Colors).