# swarm-planner

Builds implementation plans that show task dependencies for parallel agent work. Use it before coding changes in an unfamiliar codebase.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 1039
- Author: am-will
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/am-will/codex-skills/tree/HEAD/skills/swarm-planner/SKILL.md
- Updated: 2026-07-14
- HTML: https://affpapa.org/en/nevibecode/skills/swarm-planner

## What it does

The skill inspects the project structure, dependencies, and existing patterns, then splits the work into standalone tasks. Each task records an identifier, `depends_on` entries, relevant file locations, and validation criteria. Work with no unresolved prerequisites can run in parallel.

For external libraries, frameworks, or APIs, it retrieves current documentation through Context7 before planning; web search is the fallback. It pauses for clarification when the architecture, scope, constraints, or priorities are unclear. Check Context7 access first when the plan involves external dependencies.

The plan is written to `<topic>-plan.md` in the current directory. A subagent then checks for missing links, bad ordering, edge cases, and plan gaps, and actionable feedback is incorporated before completion. The skill plans work rather than writing the implementation.

## Requirements
- Works with: Context7

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill swarm-planner -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill swarm-planner -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill swarm-planner -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install am-will/codex-skills swarm-planner
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill swarm-planner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/am-will/codex-skills --path skills/swarm-planner
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill swarm-planner -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/am-will/codex-skills/tree/HEAD/skills/swarm-planner/SKILL.md

## When to use it
- split a change into standalone tasks
- map prerequisites between implementation steps
- check current documentation for an external API
- write a plan to `<topic>-plan.md`
- review a task plan with a subagent

## Example prompts
- Create an implementation plan for this feature and show dependencies between tasks.
- Inspect the project, ask about unclear constraints, then write the plan to `<topic>-plan.md`.
- Plan this change with parallel task groups and a subagent review.

## Similar
- [context7](https://affpapa.org/en/nevibecode/skills/context7.md) — skill · 11200 installs
- [context7-cli](https://affpapa.org/en/nevibecode/skills/context7-cli.md) — skill · 7800 installs
- [setup-context7-mcp](https://affpapa.org/en/nevibecode/skills/setup-context7-mcp.md) — skill · 1100 installs
- [microsoft-docs](https://affpapa.org/en/nevibecode/skills/github-microsoft-docs.md) — skill · 14881 installs
- [find-docs](https://affpapa.org/en/nevibecode/skills/find-docs.md) — skill · 9400 installs
- [documentation-lookup](https://affpapa.org/en/nevibecode/skills/documentation-lookup.md) — skill · 4700 installs

From the same set: [am-will/codex-skills](https://affpapa.org/en/nevibecode/by/am-will/codex-skills.md) — 13 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