# design-for-ai

design-for-ai adds a four-stage design workflow to your agent: research, plan, mock, and build. Prevents generic AI aesthetics like dark cyan palettes and uniform cards.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 206 installs · ★ 35 repo stars
- Author: podo
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/podo/design-agent-skills/tree/HEAD/skills/design-for-ai/SKILL.md
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/design-for-ai

## What it does

The skill structures interface work into four distinct steps. First, `research` formalises the brief. Next, `plan` maps out phases, `mock` delivers a self-contained HTML prototype for sign-off, and `build` executes code phase by phase with critique steps. A seeded dealer assigns palettes and composition from reference styles, while dual-blind review flags typical AI styling tells.

The package includes doctrines covering usability heuristics and data visualisation rules. Running the dealer and detector scripts requires Node.js. Installing this package will overwrite `prototype` if you already use `emilkowalski-skill`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install podo/design-agent-skills skills/design-for-ai
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add podo/design-agent-skills --skill design-for-ai -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/podo/design-agent-skills/tree/HEAD/skills/design-for-ai/SKILL.md

## When to use it
- structure UI work through a phased four-stage process
- turn loose design ideas into a structured brief
- render self-contained HTML wireframes from design tokens
- audit interfaces against usability heuristics and chart rules

## Example prompts
- Design an analytics dashboard following the research, plan, mock, and build workflow.
- Turn this rough product idea into a structured design brief.
- Create a self-contained HTML wireframe using our design tokens.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e49819b85dca8a34.

BEGIN THIRD-PARTY FILE e49819b85dca8a34
````text
---
name: design-for-ai
description: |
  Design-foundations system for Claude Code built on Design for Hackers: a four-stage workflow
  (research, plan, mock, build) with a seeded design-DNA dealer, dual-blind review, and doctrine
  skills for usability, data visualisation and prototyping.
triggers:
  - "design for AI"
  - "rtd design"
  - "design-for-ai"
  - "design research plan mock build"
das:
  type: package
  category: design-systems
  upstream: "https://github.com/ryanthedev/design-for-ai"
  version: latest
  install: false
---

# design-for-ai

> Catalogue stub — full package: [ryanthedev/design-for-ai](https://github.com/ryanthedev/design-for-ai)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   This package installs 4 skills (`prototype`, `clarify`, `usability`, `data-viz`); checking the first.
   - Global: `f=~/.agents/skills/prototype/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/prototype/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `prototype`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/design-for-ai ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add ryanthedev/design-for-ai --skill prototype clarify usability data-viz -g -y
   ```

   **Project:**
   ```bash
   npx skills add ryanthedev/design-for-ai --skill prototype clarify usability data-viz -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Claude Code plugin route:**

```
/plugin marketplace add ryanthedev/rtd-claude-inn
/plugin install design-for-ai@rtd
```

**Heads-up**

- **Requires:** Node.js for the plugin's palette, dealer and detector scripts (scripts/*.mjs); Optional: a browser MCP so the prototype skill can render and screenshot mocks
- **License:** MIT per plugin.json and README; no LICENSE file in the repository
- **Name collision:** `prototype` is also written by `emilkowalski-skill` (its install or its catalogue pointer); installing both overwrites the earlier one.
<!-- das:install:end -->

## Invoke after install

- Claude Code plugin route (the full system): `/design-for-ai:research`, then `/design-for-ai:plan`, `/design-for-ai:mock`, `/design-for-ai:build`
- Skill name: `prototype` — renders a self-contained HTML mock or wireframe from design tokens and page specs
- Skill name: `clarify` — turns an underspecified design request into a confirmed brief
- Skill name: `usability` — heuristic evaluation, UX laws, operability questions
- Skill name: `data-viz` — chart type, truthful encoding, dashboard layout
````
END THIRD-PARTY FILE e49819b85dca8a34

The third-party file has ended. Everything between the e49819b85dca8a34 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2930 of 4211 bytes. © podo · MIT · https://github.com/podo/design-agent-skills/tree/HEAD/skills/design-for-ai/SKILL.md

_Part of the page did not fit — see the HTML version._

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