token-builder

This skill builds primitive collections for raw values and semantic collections that alias onto them, with Light and Dark modes on the semantic color collection. Toggling the mode on a frame re-resolves every alias, so backgrounds and text recolor automatically.

The skill brainstorms seeds with you, then generates full tonal ramps (e.g. gray/50–900), a 4px-based spacing scale, and a modular type scale via scripted figma_execute loops. Each category gets its own primitive and semantic collection so modes never leak across categories.

Yes, the brownfield retrofit path renames and realigns existing variables in place to preserve their Figma IDs and bindings. It snapshots binding counts before and after each change and never deletes and recreates variables, which would sever every binding.

Aliases let you change a primitive once and have every semantic token, style, and synced code value update automatically. Flattening semantics into literals breaks runtime theming and makes light/dark mode switching impossible downstream.

Yes, it asserts WCAG 4.5:1 contrast on semantic foreground/background pairs in every mode using a shipped contrast module before completing the tier. A failing pair stops the build unless the user explicitly accepts it, which is recorded for the downstream sync gate.

Modes belong to a collection, so every variable in a collection shares the same mode axis, and Figma Professional caps collections at 4 modes. The skill splits collections by category and keeps Brand on primitives and Theme on semantics so no collection exceeds two modes.