SkillUI — Design-System Extraction
Extract a complete design system (color tokens, typography, spacing, fonts, layout, components) from any live website, public Git repo, or local codebase, then use the generated tokens to build interfaces that match it. Pure static analysis: no AI calls, no API keys.
Run npx -y skillui --help for the full option list.
When to use
Use this when the user wants new UI to look like an existing product or when they hand you a reference URL/repo. The typical flow is: extract with SkillUI → hand the generated tokens to the builder (agent-app-creator for Agent Apps, or frontend-design for standalone frontend). SkillUI produces the design language; the builder writes the code.
Prerequisites
- Node.js 18+ (already required by this project's toolchain).
- No install step needed — invoke via
npx -y skillui .... For repeated use you may npm install -g skillui.
- Ultra mode only (screenshots, animation/interaction/component analysis) needs Playwright + Chromium:
npm install playwright
npx playwright install chromium
If Playwright is missing, stick to default mode — it still returns colors, fonts, spacing, and typography.
Commands
npx -y skillui --url <url> # Analyze a live website (default: HTML/CSS static analysis)
npx -y skillui --dir <path> # Scan a local project (CSS/SCSS/TS/JS, Tailwind config, CSS vars)
npx -y skillui --repo <url> # Clone a public Git repo, then analyze it as a directory
Common flags:
| Flag |
Purpose |
--mode ultra |
Playwright-powered: scroll screenshots, interaction states, CSS animations, layout + component fingerprinting |
--screens <n> |
Pages to capture in ultra mode (max 20) |
--out <path> |
Output directory |
--name <string> |
Override the extracted project name |
--format design-md|skill|both |
Control output format (default both) |
--no-skill |
Emit only DESIGN.md, skip the packaged .skill |
Always quote URLs — the shell treats ? and & as special characters.
Examples
npx -y skillui --url "https://linear.app" --mode ultra --screens 10
npx -y skillui --url "https://stripe.com" --format design-md
npx -y skillui --dir ./my-nextjs-app --name "MyApp"
npx -y skillui --repo "https://github.com/vercel/next.js" --name "Next.js"
Output
Extraction writes an organized folder (default <name>-design/):
SKILL.md and CLAUDE.md — generated docs describing the design system for a subsequent build step.
DESIGN.md — the full design-token reference (read this first).
tokens/ — JSON for colors, spacing, typography.
fonts/ — bundled Google Fonts as WOFF2.
references/ — ANIMATIONS.md, LAYOUT.md, COMPONENTS.md, INTERACTIONS.md, VISUAL_GUIDE.md (ultra mode).
screens/ — scroll-journey screenshots and section clips (ultra mode).
.skill — a zipped bundle of the whole extraction.
Workflow
- Confirm the reference source (URL, repo, or local path). If the user only named a product, use its site URL.
- Run the extraction. Prefer default mode for speed; use
--mode ultra when the user cares about motion, interaction states, or pixel-accurate layout and Playwright is available.
- Read
DESIGN.md and tokens/ to understand the palette, type scale, and spacing.
- Build the requested UI with the appropriate builder skill (
agent-app-creator / frontend-design), applying the extracted tokens (CSS variables, font families, spacing scale). Reference references/ and screens/ for component and layout fidelity.
- Keep the generated
<name>-design/ folder out of the app's committed source unless the user wants it kept — treat it as an extraction artifact.
1---2name: skillui3description: |4 Reverse-engineer any website's, repo's, or local project's design system into a Claude-ready skill via the SkillUI CLI. Use this skill whenever the user wants to "match the look of <site>", "clone the design of", "extract the design system / brand / theme from", "make it look like Linear/Notion/Stripe", "pull the colors, fonts, and spacing from a website", or "build a UI in the style of" an existing product. It runs pure static analysis (no AI, no API keys) and outputs a folder of design tokens (colors, typography, spacing), bundled fonts, and a generated SKILL.md/DESIGN.md that a subsequent build step reads to reproduce the design. Pair it with agent-app-creator or frontend-design to then build the interface. Do NOT trigger for generic "make it pretty" requests with no reference source, backend work, or non-UI tasks.5allowed-tools:6 - Bash(npx skillui *)7 - Bash(npx -y skillui *)8 - Bash(skillui *)9 - Bash(npx playwright *)10metadata:11 source: https://skillmd.com/skills/craftos-dev/skillui12---1314# SkillUI — Design-System Extraction1516Extract a complete design system (color tokens, typography, spacing, fonts, layout, components) from any live website, public Git repo, or local codebase, then use the generated tokens to build interfaces that match it. Pure static analysis: no AI calls, no API keys.1718Run `npx -y skillui --help` for the full option list.1920## When to use2122Use this when the user wants new UI to look like an existing product or when they hand you a reference URL/repo. The typical flow is: **extract with SkillUI → hand the generated tokens to the builder** (`agent-app-creator` for Agent Apps, or `frontend-design` for standalone frontend). SkillUI produces the design language; the builder writes the code.2324## Prerequisites2526- Node.js 18+ (already required by this project's toolchain).27- No install step needed — invoke via `npx -y skillui ...`. For repeated use you may `npm install -g skillui`.28- **Ultra mode only** (screenshots, animation/interaction/component analysis) needs Playwright + Chromium:2930```bash31npm install playwright32npx playwright install chromium33```3435If Playwright is missing, stick to default mode — it still returns colors, fonts, spacing, and typography.3637## Commands3839```bash40npx -y skillui --url <url> # Analyze a live website (default: HTML/CSS static analysis)41npx -y skillui --dir <path> # Scan a local project (CSS/SCSS/TS/JS, Tailwind config, CSS vars)42npx -y skillui --repo <url> # Clone a public Git repo, then analyze it as a directory43```4445Common flags:4647| Flag | Purpose |48| --- | --- |49| `--mode ultra` | Playwright-powered: scroll screenshots, interaction states, CSS animations, layout + component fingerprinting |50| `--screens <n>` | Pages to capture in ultra mode (max 20) |51| `--out <path>` | Output directory |52| `--name <string>` | Override the extracted project name |53| `--format design-md\|skill\|both` | Control output format (default `both`) |54| `--no-skill` | Emit only `DESIGN.md`, skip the packaged `.skill` |5556Always quote URLs — the shell treats `?` and `&` as special characters.5758### Examples5960```bash61npx -y skillui --url "https://linear.app" --mode ultra --screens 1062npx -y skillui --url "https://stripe.com" --format design-md63npx -y skillui --dir ./my-nextjs-app --name "MyApp"64npx -y skillui --repo "https://github.com/vercel/next.js" --name "Next.js"65```6667## Output6869Extraction writes an organized folder (default `<name>-design/`):7071- **`SKILL.md`** and **`CLAUDE.md`** — generated docs describing the design system for a subsequent build step.72- **`DESIGN.md`** — the full design-token reference (read this first).73- **`tokens/`** — JSON for `colors`, `spacing`, `typography`.74- **`fonts/`** — bundled Google Fonts as WOFF2.75- **`references/`** — `ANIMATIONS.md`, `LAYOUT.md`, `COMPONENTS.md`, `INTERACTIONS.md`, `VISUAL_GUIDE.md` (ultra mode).76- **`screens/`** — scroll-journey screenshots and section clips (ultra mode).77- **`.skill`** — a zipped bundle of the whole extraction.7879## Workflow80811. Confirm the reference source (URL, repo, or local path). If the user only named a product, use its site URL.822. Run the extraction. Prefer default mode for speed; use `--mode ultra` when the user cares about motion, interaction states, or pixel-accurate layout and Playwright is available.833. Read `DESIGN.md` and `tokens/` to understand the palette, type scale, and spacing.844. Build the requested UI with the appropriate builder skill (`agent-app-creator` / `frontend-design`), applying the extracted tokens (CSS variables, font families, spacing scale). Reference `references/` and `screens/` for component and layout fidelity.855. Keep the generated `<name>-design/` folder out of the app's committed source unless the user wants it kept — treat it as an extraction artifact.