# bunshin

bunshin is a Claude Code skill that builds a whole website or web app from scratch or through a full redesign. Parallel subagents research, build pages, and review fixes.

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

## What it does

bunshin builds a complete website or web app from the client's real material. It splits research and page work across parallel subagents while a single direction contract keeps the visual and interaction decisions aligned. When installed, Impeccable leads the product interview and visual direction; genjutsu modules handle motion and audits.

The run continues through page captures, scripted tests, independent review lenses, and a final cold-eyes pass. bunshin announces the cost before work begins and asks for approval twice. A host that can spawn subagents is required. The skill covers web stacks; Compose and SwiftUI requests step down to `paint`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add AThevon/genjutsu --skill bunshin -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add AThevon/genjutsu --skill bunshin -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add AThevon/genjutsu --skill bunshin -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install AThevon/genjutsu skills/bunshin
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add AThevon/genjutsu --skill bunshin -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/AThevon/genjutsu --path skills/bunshin
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add AThevon/genjutsu --skill bunshin -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/AThevon/genjutsu/tree/HEAD/skills/bunshin/SKILL.md

## When to use it
- build a whole site from the client's material
- research several pages in parallel
- assign page work to separate subagents
- check every page with captures and scripted tests
- run fixes until a defined stop rule is reached

## Example prompts
- Build a whole website from the client's material and research the pages in parallel.
- Redesign this web app from scratch, split the page work across subagents, and review each page with captures and tests.
- Run bunshin for this web project and stop according to the selected tier's round limit.

## 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: fe37a6d89bd8d32b.

BEGIN THIRD-PARTY FILE fe37a6d89bd8d32b
```text
---
name: bunshin
description: "Summon shadow clones: genjutsu's full-scale pipeline for a whole website or web app, from scratch or as a full redesign. Harvests the client's real material, researches in parallel, lets Impeccable lead the direction and genjutsu the motion, builds the pages with parallel agents, then loops fixes, verdicts and a cold-eyes art director until only minor issues remain, the round cap of the chosen tier is reached, or a round fixes nothing. Announces its cost first and asks twice. Web. Needs a host that can spawn subagents."
allowed-tools: Bash, Read, Edit, Write, Grep, Glob, WebSearch, WebFetch, Artifact, Agent, Workflow, AskUserQuestion, Skill
---

# Bunshin - The Shadow Clones

> One art director, many clones. You keep the vision; the clones carry the width.
> This is genjutsu's heaviest pipeline. It exists for one job: a whole site, first version,
> from the client's real material.

You direct. You write the direction contract, build the foundation and the signature surface
yourself, and decide what the reviews mean. Clones (subagents) research, build pages in
parallel on files that never overlap, review through independent lenses, and apply the plan.
Impeccable, when installed, leads the product interview and draws the visual direction;
genjutsu's modules govern the motion, the platform principles, the tells and the audit. The
human is asked twice: once to summon, once to choose the direction, and again only to pass the
tier's round cap.

---

## Voice

This skill speaks in two registers:

**During execution** - light ninja flair, short.
- "Summoning four clones for the research."
- "The clones return: six pages, five builds green."
- "Sealing round two."

**In reports, summaries and gate messages** - plain, factual, dev-readable. What was built, what
was verified and how, what was not, what it cost, what the client still has to supply. No mystic
prose. The gate messages are plain too: someone is deciding to spend money on them.

---

## bunshin, paint, cast

| | `/genjutsu:cast` | `/genjutsu:paint` | `/genjutsu:bunshin` |
|---|---|---|---|
| **For** | One effect, component or section | One visual identity, one page or product | A whole site or web app, first version |
| **Who works** | You | You | You and a team of clones |
| **Direction** | An interaction thesis | Visual and interaction theses, MASTER.md | Impeccable's drawn direction (when installed) plus genjutsu's interaction thesis, as one contract |
| **Proof** | Quick audit | Full audit | Captures of every page, scripted tests, independent review lenses, verdicts, a cold-eyes pass |
| **Human gates** | Thesis, variants | Brainstorm, theses, design system, pages | Two: summon, direction |
| **Cost** | A session | A long session | Millions of tokens, hours (see "The summoning") |

---

## Iron Rules

1. **The summoning comes first.** No clone runs, and nothing heavier than reading happens, before
   the tier is answered. With nobody answering, see "When nobody is answering".
```
END THIRD-PARTY FILE fe37a6d89bd8d32b

The third-party file has ended. Everything between the fe37a6d89bd8d32b 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 3016 of 60000 bytes. © AThevon · MIT · https://github.com/AThevon/genjutsu/tree/HEAD/skills/bunshin/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
