# super-swarm-spark

Turns a markdown plan into a queue of subagent tasks and keeps a rolling pool busy until the code is integrated and tested.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 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/super-swarm-spark/SKILL.md
- Updated: 2026-07-14
- HTML: https://affpapa.org/en/nevibecode/skills/super-swarm-spark

## What it does

The skill acts as an orchestrator for subagents. It reads a plan file, pulls out task sections such as `### T1:` or `### Task 1.1:`, and schedules them onto subagents with the `sparky` role. The pool is rolling: up to 12 workers at a time, and each freed slot gets the next pending task right away. No batch-by-batch waiting.

Before anything launches, the skill assembles a context pack for the task. That means exact files and folders to touch, the precise names of files to create, neighbouring tasks hitting the same paths, and naming rules from the plan. It exists because parallel agents drift on filenames. A subagent that wants a path outside its pack has to stop and report before creating anything.

Every finished subagent gets checked, the plan file is updated, and once the queue drains the orchestrator runs an integration pass: reconcile conflicts, close test gaps, run the tests, fix what fails. Keep in mind all agents share one repository, so each is told to commit only its own files and never push. You need a plan file ready first; nothing starts without it.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- split a large development plan into parallel tasks
- run several subagents against one codebase at once
- stop parallel agents from inventing conflicting filenames
- merge task results into code that builds and passes tests
- run only picked tasks from a plan, like T1 T2 T4

## Example prompts
- Implement the plan `plan.md` using super-swarm-spark
- Run `/super-swarm-spark ./plans/auth-plan.md T1 T2 T4`
- Do only tasks T3 and T7 from this plan

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 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