What is the design system architect skill?
Design-system-architect is a skill in OneWave-AI's skills repository on GitHub. From a brand brief or an existing site it builds color, type, spacing, radius, elevation and motion tokens plus component specs, then writes a Tailwind config extension, a tokens.css file and a design-system.md usage doc.
It is the claude-design-system-architect folder in OneWave-AI's skills repository. Its description says it generates a premium design system from a brand brief or an existing site, aiming for an editorial, human-crafted look rather than a template one.
What it produces
- Color: a 50 to 900 ramp per hue, semantic tokens such as surface, text, muted, accent and border, and a dark mode set.
- Type: a font pairing with a reason, a modular scale, and line heights, tracking and weights.
- Space and layout: a spacing scale, container widths, grid and breakpoints.
- Radius, border and elevation: a small consistent set.
- Motion: duration and easing tokens, named patterns and a reduced motion stance.
What it exports
The output is real files: a Tailwind config extension or a theme block for Tailwind v4, a tokens.css file with light and dark custom properties, and a design-system.md with palette contrast values, specs and do and don't examples.
Who the skill is for
Best for
- Starting a product or site and needing a token layer before building pages.
- Unifying an inconsistent interface by codifying the brand into reusable tokens.
- Developers who want contrast checked against WCAG AA for body text.
Not for
- Brands that need purple, since the default rules avoid it unless the brand overrides.
- Teams wanting a governance process. It builds tokens and component specs, not ownership rules.
- Projects that do not use Tailwind or CSS variables.
For the architecture of an existing system see design-system-architecture and for governance see design-system-governance. Use design-system-audit to score what you end up with.
How to install Design System Architect Skill for Token Exports
git clone https://github.com/OneWave-AI/claude-skills.gitThe SKILL.md names two companion skills for building pages and auditing UI. They are separate installs in the same repository.Clone the repository
Run
git clone https://github.com/OneWave-AI/claude-skills.git. The skill is the claude-design-system-architect folder.Copy the skill folder
Copy claude-design-system-architect into your AI coding agent's skills folder.
Provide a brief
Give the agent a brand brief, a few reference sites, or an existing site address to read.
Review the exports
Check the generated Tailwind config, tokens.css and design-system.md before wiring them into your project.
Check that it loaded
Give it a short brand brief. It should return a token set with semantic color names, a dark mode, a motion section and the three export files.
Key features
- Brand inputsCollects personality adjectives, audience and context, existing brand equity and anti-references.
- House defaultsAvoids purple and emoji in UI, leans toward warm tones and offers a dark surface option unless the brand overrides.
- Color rampsBuilds 50 to 900 ramps and semantic tokens with verified WCAG AA contrast for body text.
- Type scaleChooses a font pairing with rationale, a modular scale, and per-size line height and tracking.
- Space and layoutDefines spacing scale, container widths, grid and breakpoints.
- Elevation and radiusKeeps a small consistent set, with shadows that match the weight of the brand.
- Motion languageAdds duration and easing tokens and named patterns for entrance, emphasis and transition.
- Component specsSpecifies button, input, card, nav, section, badge and modal variants and states using only tokens.
- Three exportsWrites a Tailwind config extension, a tokens.css file and a design-system.md usage doc.
Frequently asked questions
What is the design system architect skill?
It is a skill in OneWave-AI/claude-skills that builds a complete design system from a brand brief or existing site. It defines color, type, space, elevation and motion tokens, specs core components and exports configuration and documentation files.
How do I install it?
Clone OneWave-AI/claude-skills and copy the claude-design-system-architect folder into your agent's skills folder. The repository folder keeps a prefix in its name, though this page calls the skill design-system-architect, and the folder holds a single SKILL.md.
Which files does it export?
A Tailwind config extension, or the theme block for Tailwind v4, a tokens.css file with CSS custom properties for light and dark, and a design-system.md that documents the palette with contrast, type scale, spacing, motion and component specs.
Why does it avoid purple?
The SKILL.md lists no purple, no emoji in UI and a lean toward warm earth tones as defaults unless the brand explicitly overrides them. The aim is to avoid the look of a generic AI generated landing page.
Can it start from an existing site?
Yes. Inputs can be a brief, an existing site read with a web fetch tool or screenshots, or a few reference sites. It also asks for locked colors, fonts in use and anti-references.
Does it check accessibility?
Color tokens include verified contrast, with WCAG AA as the minimum for body text, and the guardrails require dark mode and reduced motion. For deeper checks run a contrast check with better-colors guidance on the exported values.
How is it different from a tokens only skill?
This one also covers brand inputs, component specs and motion, then exports a usage doc. For a focused token format see design-tokens, which is a separate skill with its own approach.


