# project-design

project-design drives visual design choices for generated HTML pages — palette, typography, layout, motion — so output stops looking like generic AI UI.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 261 installs · ★ 33 repo stars
- Author: Starchild-ai-agent
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/project-design/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/project-design

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill project-design -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/project-design/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/project-design/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill project-design -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/project-design/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill project-design -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/project-design/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills project-design
```

2. **Manually: put the files in place**
- File: `.github/skills/project-design/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill project-design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path project-design
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/project-design/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill project-design -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/project-design/SKILL.md

## When to use it
- 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
- 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

## Similar
- [web-design-engineer](https://affpapa.org/en/nevibecode/skills/web-design-engineer.md) — skill · 10200 installs
- [interaction-design](https://affpapa.org/en/nevibecode/skills/interaction-design.md) — skill · 16146 installs
- [localization-design](https://affpapa.org/en/nevibecode/skills/localization-design.md) — skill · 2100 installs
- [unslop](https://affpapa.org/en/nevibecode/skills/damir-sokolovsky-unslop.md) — skill · ★ 19810 repo stars
- [banner-design](https://affpapa.org/en/nevibecode/skills/banner-design.md) — skill · 50900 installs
- [design-motion-principles](https://affpapa.org/en/nevibecode/skills/design-motion-principles.md) — skill · 14500 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
