Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Starchild-ai-agent/official-skills --skill project-design -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/project-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/project-design/

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.

Similar skills

All skills for Design →

From the same set66

The whole set →

Project sponsors

Companies that keep this analytics open