Agent skill

Design System Creator

by curiositech in curiositech/some_claude_skills

Builds comprehensive design systems and design bibles with production-ready CSS.

MITAuto-check passedFrontend & Design

Install Design System Creator

skills CLI
$ npx skills add curiositech/some_claude_skills --skill design-system-creator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install curiositech/some_claude_skills design-system-creator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/curiositech/some_claude_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/design-system-creator .claude/skills/design-system-creator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
design-system-creator
GitHub stars
243
Token cost
~2k tokens
SKILL.md length
660 words
Files
6 (incl. references)
Skills in repo
95
Repo updated
First seen
Licence
MIT

At a glance

Builds comprehensive design systems and design bibles with production-ready CSS.

  • Works in 10 steps: Foundation → Components → Patterns → …
  • Design system creation
  • SKILL.md covers When to Use This Skill, Three-Tier Token Architecture, OKLCH: The Modern Color Standard and Design Bible Structure, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Design System Creator is an agent skill from curiositech/some_claude_skills. Builds comprehensive design systems and design bibles with production-ready CSS. Expert in design tokens, component libraries, CSS architecture. Use for design system creation, token architecture, component documentation, style guide generation. Activate on "design system", "design tokens", "CSS architecture", "component library", "style guide", "design bible". NOT for typography deep-dives (use typography-expert), color theory mathematics (use color-theory-palette-harmony-expert), brand identity strategy (use…

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `.claude-plugin/plugin.json`, `CHANGELOG.md` and `references/component-documentation.md`).

It sits in Frontend & Design, covering Design systems. The repository describes itself as: Claude skills that make my life easier. The licence is MIT.

When your agent uses it

  • Design system creation
  • Token architecture
  • Component documentation
  • Style guide generation

Example prompts

  • “design system”
  • “design tokens”
  • “CSS architecture”
  • “/design-system-creator”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, mcp__magic__21st_magic_component_builder, mcp__magic__21st_magic_component_refiner, mcp__stability-ai__stability-ai-generate-image, mcp__firecrawl__firecrawl_search

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Foundation
  2. Components
  3. Patterns
  4. Guidelines
  5. Token Explosion
  6. Missing Semantic Layer
  7. Documentation Drift
  8. Utility Class Overload
  9. Breaking the Scale
  10. No Version Control

What it can do on your machine

Read from SKILL.md and the folder at commit 6713fc7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • mcp__magic__21st_magic_component_builder
    • mcp__magic__21st_magic_component_refiner
    • mcp__stability-ai__stability-ai-generate-image
    • mcp__firecrawl__firecrawl_search

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are css).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • oklch.com
    • evilmartians.com
    • harmonizer.evilmartians.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Design System Creator loads about 2k tokens when it runs, and up to ~7.5k if it reads all its reference files. Until then it costs about 158 tokens; SKILL.md has 660 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~158
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from curiositech/some_claude_skills at commit 6713fc7, republished under its MIT licence (© curiositech). 660 words, ~2,029 tokens.

Download SKILL.mdSave it as .claude/skills/design-system-creator/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
design-system-creator
description
Builds comprehensive design systems and design bibles with production-ready CSS. Expert in design tokens, component libraries, CSS architecture. Use for design system creation, token architecture, component documentation, style guide generation. Activate on "design system", "design tokens", "CSS architecture", "component library", "style guide", "design bible". NOT for typography deep-dives (use typography-expert), color theory mathematics (use color-theory-palette-harmony-expert), brand identity strategy (use web-design-expert), or actual UI implementation (use web-design-expert or native-app-designer).
allowed-tools
Read, Write, Edit, Glob, mcp__magic__21st_magic_component_builder, mcp__magic__21st_magic_component_refiner, mcp__stability-ai__stability-ai-generate-image, mcp__firecrawl__firecrawl_search
metadata.category
Design & Creative
metadata.tags
design-system, tokens, components, css, style-guide

Design System Creator

Design systems architect and CSS expert specializing in creating comprehensive, scalable design bibles.

When to Use This Skill

✅ Use for:

  • Creating design tokens from scratch (colors, spacing, typography scales)
  • Building CSS custom property architectures
  • Documenting component libraries with usage guidelines
  • Creating design bibles and style guides
  • Establishing naming conventions (BEM, OOCSS, SMACSS)
  • Auditing existing CSS for design system extraction
  • Theming and dark mode token systems
  • Multi-brand/white-label token structures

❌ Do NOT use for:

  • Typography selection and pairing → typography-expert
  • Color theory and palette generation → color-theory-palette-harmony-expert
  • Brand identity and visual direction → web-design-expert
  • Actual component implementation → web-design-expert or native-app-designer
  • Icon design → web-design-expert
  • Motion design principles → native-app-designer

Three-Tier Token Architecture

The foundation of scalable design systems:

css
:root {
  /* 1. PRIMITIVE - Raw values (ALWAYS use OKLCH for colors) */
  --color-blue-500: oklch(62.8% 0.195 252.5);
  --space-4: 1rem;

  /* 2. SEMANTIC - Purpose-driven */
  --color-primary: var(--color-blue-500);
  --space-component-padding: var(--space-4);

  /* 3. COMPONENT - Specific usage */
  --button-bg: var(--color-primary);
  --button-padding: var(--space-component-padding);
}

→ See references/token-architecture.md for dark mode, multi-brand, and complete examples.

OKLCH: The Modern Color Standard

⚠️ CRITICAL: Always use OKLCH for color tokens, not hex or HSL.

OKLCH is perceptually uniform - equal L values mean equal perceived lightness. This is essential for:

  • Generating harmonious color scales
  • Ensuring accessibility (L=50% is true middle gray)
  • Theming (adjust L for dark mode, C for brand intensity)
css
:root {
  /* OKLCH format: oklch(Lightness% Chroma Hue) */

  /* Primary scale - same hue, varying lightness */
  --color-primary-100: oklch(95% 0.05 252);
  --color-primary-500: oklch(62% 0.19 252);
  --color-primary-900: oklch(30% 0.15 252);

  /* Dark mode: reduce L uniformly */
  --color-bg-light: oklch(98% 0.01 252);
  --color-bg-dark: oklch(15% 0.02 252);
}

Essential OKLCH Resources:

ResourcePurpose
oklch.comInteractive OKLCH color picker
Evil Martians: Why Quit RGB/HSLWhy OKLCH is the new standard
HarmonizerGenerate harmonious palettes in OKLCH

OKLCH Benefits for Design Systems:

  • Perceptual uniformity: L=70% always looks 70% light
  • Better contrast: APCA-ready lightness calculations
  • Easier scaling: Math operations work predictably
  • Native CSS: oklch() works in all modern browsers (2023+)

Design Bible Structure

1. Foundation
  • Brand Identity, Design Principles
  • Color System, Typography Scale
  • Spacing Scale, Grid System
2. Components

For each component document:

  • Purpose, Anatomy, Variants
  • States (default, hover, active, disabled, focus)
  • Responsive behavior
  • Accessibility (ARIA, keyboard, screen readers)
  • Code examples
3. Patterns
  • Page Layouts, Navigation
  • Forms, Data Display
  • Feedback (alerts, toasts, modals)
4. Guidelines
  • Writing (voice, tone)
  • Imagery, Motion, Accessibility

→ See references/component-documentation.md for templates.

CSS Organization (ITCSS)

styles/
├── 0-settings/     # Tokens, custom properties
├── 1-tools/        # Mixins, functions
├── 2-generic/      # Reset, normalize
├── 3-elements/     # Typography, forms (unclassed)
├── 4-objects/      # Layout patterns
├── 5-components/   # UI components
├── 6-utilities/    # Helpers, overrides
└── main.css        # Import all

→ See references/css-organization.md for BEM naming and full structure.

Anti-Patterns to Avoid

1. Token Explosion

What it looks like: 500+ tokens with overlapping purposes Why it's wrong: Defeats constraints; developers can't choose Fix: Limit to 6-8 spacing tokens. If you need more, fix the scale.

2. Missing Semantic Layer

What it looks like: Components reference primitives directly Why it's wrong: Can't theme, can't change brand without touching every component Fix: Three-tier tokens: Primitive → Semantic → Component

3. Documentation Drift

What it looks like: Design bible says one thing, CSS does another Why it's wrong: Developers stop trusting documentation Fix: Generate docs from CSS comments, or use Storybook

Show full SKILL.md (253 more words)Show less
4. Utility Class Overload

What it looks like: class="p-4 m-2 bg-blue-500 text-white..." Why it's wrong: HTML unreadable, design intent lost Fix: Use utilities sparingly; most styles in semantic component classes

5. Breaking the Scale

What it looks like: padding: 13px; (why 13?) Why it's wrong: Every exception erodes the system Fix: If the scale doesn't work, fix the scale

6. No Version Control

What it looks like: "Which button is correct?" Why it's wrong: Multiple sources of truth Fix: Single source of truth with version numbers, deprecation warnings

Working Process

  1. Audit: Review existing patterns and inconsistencies
  2. Define: Establish tokens and foundational system
  3. Build: Create component library with documentation
  4. Document: Write comprehensive design bible
  5. Test: Validate accessibility and responsiveness
  6. Deliver: Package with examples and starter templates

MCP Integrations

MCPPurpose
21st.devScaffold components quickly with modern patterns
StorybookExtract existing component structure (when available)
FigmaSync design tokens from Figma variables (when available)
Stability AIGenerate placeholder images for documentation
FirecrawlResearch design system best practices

Output Deliverables

  • Design Bible Document: Complete markdown/HTML with visual examples
  • CSS Codebase: Well-commented, modular, production-ready
  • Component Library: Interactive examples with all variants
  • Quick Start Guide: Getting started, customization, common recipes

References

→ references/token-architecture.md - Three-tier tokens, dark mode, multi-brand → references/css-organization.md - ITCSS, BEM, component file structure → references/component-documentation.md - Doc templates, quick reference cards

Integrates With

  • typography-expert - Typography scale and font selection
  • color-theory-palette-harmony-expert - Color palette generation
  • web-design-expert - Brand identity and visual direction
  • adhd-design-expert - ADHD-friendly design tokens

Remember: A design system is a living product that serves products.

© curiositech, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in .claude/skills/design-system-creator of curiositech/some_claude_skills.

  • SKILL.md
  • .claude-plugin/plugin.json
  • CHANGELOG.md
  • references/component-documentation.md
  • references/css-organization.md
  • references/token-architecture.md

Open the folder on GitHubat commit 6713fc7

Compare with similar skills

Design System Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Design System Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design System Creator this skillcuriositech/some_claude_skills243—~2kAutomated safety check: PassMIT
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0
UI StylingOhh-889/skyroc79513 repos~2.5kAutomated safety check: PassMIT
Shadcnsupabase/evals14342 repos~4.5kAutomated safety check: PassApache-2.0

Similar skills

  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • UI Styling

    Ohh-889/skyroc

    Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs.

    795 GitHub starsUsed in 13 repos~2.5k tokens
    Frontend & DesignAuto-check passed
  • Shadcn

    supabase/evals

    Official

    Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI.

    143 GitHub starsUsed in 42 repos~4.5k tokens
    Frontend & DesignAuto-check passed
  • Design System

    Ohh-889/skyroc

    Token architecture, component specifications, and slide generation.

    795 GitHub starsUsed in 11 repos~1.7k tokens
    Frontend & DesignAuto-check passed

More from curiositech/some_claude_skills

All 95 skills in this repo
  • Crisis Detection Intervention AI

    curiositech/some_claude_skills

    Detect crisis signals in user content using NLP, mental health sentiment analysis, and safe intervention protocols.

    243 GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed
  • Form Validation Architect

    curiositech/some_claude_skills

    End-to-end form handling with react-hook-form, Zod schemas, validation patterns, error messaging, field arrays, and multi-step wizards.

    243 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • GitHub Actions Pipeline Builder

    curiositech/some_claude_skills

    Build production CI/CD pipelines with GitHub Actions. An agent skill from curiositech/some_claude_skills.

    243 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check: notes
  • Background Job Orchestrator

    curiositech/some_claude_skills

    Expert in background job processing with Bull/BullMQ (Redis), Celery, and cloud queues.

    243 GitHub stars~3.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Competitive Cartographer

    curiositech/some_claude_skills

    Strategic analyst that maps competitive landscapes, identifies white space opportunities, and provides positioning recommendations.

    243 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Computer Vision Pipeline

    curiositech/some_claude_skills

    Build production computer vision pipelines for object detection, tracking, and video analysis.

    243 GitHub stars~4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Design System Creator

What does Design System Creator do?

Builds comprehensive design systems and design bibles with production-ready CSS. Design System Creator is an agent skill from curiositech/some_claude_skills. Builds comprehensive design systems and design bibles with production-ready CSS.

When should I use Design System Creator?

Design System Creator fits situations like: design system creation; token architecture; component documentation; style guide generation.

How do I install Design System Creator in Claude Code?

Run `npx skills add curiositech/some_claude_skills --skill design-system-creator -a claude-code`. Or copy the skill folder (.claude/skills/design-system-creator in curiositech/some_claude_skills) into .claude/skills/design-system-creator in your project. Claude Code loads it when a task matches its description.

How do I install Design System Creator in Codex?

Run `npx skills add curiositech/some_claude_skills --skill design-system-creator -a codex`. Or copy the skill folder (.claude/skills/design-system-creator in curiositech/some_claude_skills) into .agents/skills/design-system-creator in your project. Codex loads it when a task matches its description.

Can I use Design System Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add curiositech/some_claude_skills --skill design-system-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-system-creator, .gemini/skills/design-system-creator, .github/skills/design-system-creator and .opencode/skills/design-system-creator in your project.

What does Design System Creator need to run?

SKILL.md names no scripts, command-line tools or credentials: Design System Creator is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, mcp__magic__21st_magic_component_builder, mcp__magic__21st_magic_component_refiner, mcp__stability-ai__stability-ai-generate-image, mcp__firecrawl__firecrawl_search.

Does Design System Creator access the network?

SKILL.md names 3 domains. As links in the text: oklch.com, evilmartians.com and harmonizer.evilmartians.com. This is read from the text; nothing was executed.

Is Design System Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Design System Creator use?

Design System Creator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Design System Creator use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.4k tokens, read only when the agent opens those files.

What are the alternatives to Design System Creator?

Skills that share tags, products or a category with Design System Creator: Impeccable (bestofjs/bestofjs, 3.1k stars), Figma Design System Builder (warpdotdev/warp, 65k stars), Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars) and UI Styling (Ohh-889/skyroc, 795 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design System Creator?

curiositech (a GitHub organization) maintains it in curiositech/some_claude_skills, which has 243 GitHub stars. The repository holds 95 skills in this directory. The repository was last updated on September 6, 2026.

Source: curiositech/some_claude_skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.