project-design — Claude Code skill: what it does, how to install
project-design drives visual design choices for generated HTML pages — palette, typography, layout, motion — so output stops looking like generic AI UI.
no license 261 installs ★ 33 updated 2026-10-22
npx skills add Starchild-ai-agent/official-skills --skill project-design -a claude-codeWhat project-design does
The skill acts as a visual quality gate paired with project-builder: the latter handles the engineering side of assembling a page, while project-design governs design decisions. Before any code gets written, it requires a one-line "Design Read" covering page type, audience, atmosphere and aesthetic family, which anchors every color and typography choice that follows.
To break the pattern of repeating the same dark-blue layout, the skill derives four random "design dials" from the current UTC time, covering surface, accent hue, typography and aesthetic family. Any explicit preference from the user, like a request for dark mode or a specific font, overrides the dial result for that dimension. Dark or tinted surfaces additionally require a "Scene Sentence" describing a concrete physical setting and lighting, so the dark palette ties to something specific instead of defaulting to blue-black.
Four reference files back the methodology: aesthetics.md for palette and type decisions, components.md for nav bars, cards and forms, animations.md for scroll and hover motion, and charts.md for Chart.js or ECharts setups.
What it helps with
- pick a color palette and typography matched to the page type
- avoid the generic dark-blue AI-generated look
- lock in audience and atmosphere before writing markup
- build a dark palette tied to a specific physical scene
- assemble UI components like nav bars, cards, forms and charts
Example prompts for the agent
- Build a dev tool landing page in dark mode following project-design rules
- Put together a dashboard with Chart.js charts using the project-design skill
- Design a portfolio in an Apple-inspired style, applying project-design for palette and type
How to install project-design
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-design -a claude-code2Manually: put the files in place
~/.claude/skills/project-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/project-design/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-design -a codex2Manually: put the files in place
.agents/skills/project-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-design -a cursor2Manually: put the files in place
.cursor/skills/project-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Starchild-ai-agent/official-skills project-design2Manually: put the files in place
.github/skills/project-design/SKILL.md1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path project-designManually: put the files in place
.devin/skills/project-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-design -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about project-design
How to install project-design in Claude Code?
Run npx skills add Starchild-ai-agent/official-skills --skill project-design -a claude-code; the skill lands at ~/.claude/skills/project-design/SKILL.md.
What does project-design do?
It sets a methodology for visual decisions on generated HTML pages — color palette, typography, layout, motion and components — aimed at avoiding generic AI-looking output.
How does project-design differ from project-builder?
project-builder handles the engineering workflow for assembling a page, while project-design governs visual choices like color, typography, layout and animation. They're meant to be used together.