Skip to main content
skill CX Codex

swarm-planner — Claude Code skill: plans and installation

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add am-will/codex-skills --skill swarm-planner -a claude-code
Open on GitHub

What swarm-planner 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.

What it helps with

  • 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 for the agent

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

How to install swarm-planner

1Skills CLI (Vercel)

npx skills add am-will/codex-skills --skill swarm-planner -a claude-code

2Manually: put the files in place

~/.claude/skills/swarm-planner/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/swarm-planner/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about swarm-planner

How do I install swarm-planner in Claude Code?

Run npx skills add am-will/codex-skills --skill swarm-planner -a claude-code, then run npx skills add am-will/codex-skills --skill swarm-planner -a claude-code again. The skill file is located at ~/.claude/skills/swarm-planner/SKILL.md.

What does swarm-planner do?

It produces implementation plans with explicit task dependencies, file locations, and validation checks. The output is structured for agents that can take independent tasks in parallel.

Why does swarm-planner ask questions before planning?

It stops when the architecture, scope, constraints, or priorities have more than one reasonable interpretation. The questions resolve ambiguity before the plan is created.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set10

Frontend Responsive Design Standards A skill that gives your coding agent rules for mobile-first layouts: breakpoints, relative units, touch targets and content priority. CX Codex +1 1,200installs role-creator Builds and updates Codex subagent definitions as standalone TOML files. Useful when you need isolated role configs with explicit model settings and developer instructions. CX Codex +1 1,200installs gemini-computer-use Runs Gemini 2.5 Computer Use agents with Playwright to drive browser workflows. It captures screenshots, calls UI actions, and prompts for confirmation on risky steps. CX Codex +1 1,200installs llm-council This skill runs several CLI agents as independent planners, strips their identities, and merges the results into one final plan. Useful when a single model's bias is the problem. CX Codex +1 1,200installs Agent Browser A skill that hands your agent a Rust-based headless browser: navigate, click, fill forms and snapshot pages through structured commands. CX Codex +1 1,200installs plan-harder Turns complex requests into structured sprint plans with atomic tasks. Triggers when you tell the agent to plan harder, focusing purely on architecture and risks. CX Codex +1 1,200installs read-github Lets the agent pull documentation and code from any GitHub repository through the gitmcp.io MCP service. Useful when you need to understand a project without cloning it. CX Codex +1 1,200installs planner Splits bug fixes and feature development into structured sprints and atomic tasks. It helps you design software changes before writing any code. CX Codex +1 1,200installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor