aiforui logo
[←] All skills

Design System Docs

Tokens and components define what exists. Docs define when to use what. This skill writes them from your real code, so you stop re-explaining the system in every prompt.

What this skill does

Reads the tokens, components, and variants that exist in your codebase and writes a DESIGN.md that says when to use each one.

  • Reads your real tokens, components, and variant unions first, so the docs match the code
  • Documents each component as when to use it, when to use the alternative, which variant goes where, and a right and wrong example
  • Turns any choice with three or more options into a flowchart the agent walks the same way every time
  • Tests the docs by asking for a real screen, then fixes whatever the agent got wrong

Installation

Run the installer in your terminal to add this skill to your project:

$npx @aiforui/install emil-design-system-docs --token=…

Omit the skill name to pick from all skills at once, and rename skills during install if you prefer different slash commands.

Usage

Once installed, use it when your agent keeps hardcoding colors, inventing variants, or picking the wrong component. For example: