Skip to main content
skill CX Codex

ds-swarm — Claude Code skill: what it does, how to install

Claude Code skill splits broad tasks across parallel workers and merges their verified outputs into a single report. Triggers on /ds-swarm during audits or multi-branch races.

MIT 537 installs ★ 320 updated 2026-10-28

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add aicodeking/deepseek-stack --skill ds-swarm -a claude-code
Open on GitHub

What ds-swarm does

The skill slices a task into distinct partitions or sets up a race where several workers tackle the same problem. Every worker receives a standalone brief specifying targets, exact commit hashes, verification methods, and an isolated output folder. Writable state is never shared between workers.

When an agent harness lacks subagent execution, briefs run sequentially inside fresh contexts. Each worker reports PASS, ISSUES, or BLOCKED backed by command execution logs. Any result missing concrete evidence or referencing wrong commits triggers exactly one respawn; a second failure gets recorded as a gap.

What it helps with

  • split codebase audits across parallel workers
  • run competitive races between alternative implementations
  • aggregate test logs into an evidence-based report
  • deduplicate multi-worker bug findings by root cause

Example prompts for the agent

  • /ds-swarm audit each module in src/ across separate workers
  • Race two refactoring approaches and pick the winner based on benchmarks
  • Split this migration across workers and collect proof for every completed slice

How to install ds-swarm

1Skills CLI (Vercel)

npx skills add aicodeking/deepseek-stack --skill ds-swarm -a claude-code

2Manually: put the files in place

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

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

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

Questions about ds-swarm

How to install ds-swarm in Claude Code?

Run npx skills add aicodeking/deepseek-stack --skill ds-swarm -a claude-code in your terminal.

What does ds-swarm do?

It coordinates parallel workers on task slices or races, enforces command log evidence for every result, and combines outcomes into a deduplicated report.

How does ds-swarm handle worker failures?

A worker that omits terminal evidence or checks the wrong commit gets respawned once. A second failure marks the slice as an unpassed gap.

Source text

SKILL.md · MIT
---
name: ds-swarm
description: "Fan out N parallel workers on slices of a job or on a race, collect every result, and return one evidence-backed report. Use for wide coverage, audits, races between approaches or exploration, or for /ds-swarm, 'swarm this', 'split this across workers'."
---

# ds-swarm

Split work that is wide but shallow across parallel workers, then merge their proven results into one report.

## Steps

1. State the done condition and the report the swarm must return.
2. Pick the shape. Partition the job into non-overlapping slices, or race N workers on the same brief, or both. For a race, decide up front how you will choose: first pass, rank all, or best one.
3. Write one brief per worker that stands alone: goal, exact slice, how to verify, what to report. When workers test specific commits, name the exact commit hashes and the measurement method.
4. Give every worker that writes files its own output location.
5. Spawn all workers at once. If the harness cannot run subagents, run the briefs one by one in fresh contexts.
6. Each worker reports PASS, ISSUES or BLOCKED with evidence: commands run and their output. ISSUES lists every provable issue, not just the first.
7. Collect results. Reject any result with no evidence or the wrong commit and respawn that worker once. A second miss is a recorded gap, not a pass.
8. Merge into one report: the verdict, each slice or arm with its evidence, gaps, and duplicates merged by root cause.

## Stop when

- Every slice has a result or a recorded gap and the report is written.
- Or a race has a winner under the rule from step 2.
- Never respawn a worker more than once.

## Rules

- Workers do not share writable state.
- A missing slice is never counted as passing.
- Report what workers proved, not what they claimed.

© aicodeking · MIT · aicodeking/deepseek-stack

Similar skills

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

From the same set29

The whole set →
ds-tdd The ds-tdd Claude Code skill guides bug fixes through a failing test, then a minimal code change. It activates for TDD or regression-test requests and bugs with a simple local test target. CX Codex +1 542installs ds-catchup ds-catchup — a skill for Claude Code summarizes changes since the last message and lists decisions awaiting the user's input. It runs when someone returns after a long pause or asks what happened. CX Codex +1 540installs ds-jury The ds-jury Claude Code skill gathers independent reviews of a code change from several models. The agent works through accepted findings and runs another review round until the reviewers agree. CX Codex +1 539installs ds-best-of-n The ds-best-of-n Claude Code skill creates several independent versions of a task and combines the strongest result with selected parts from the others. It runs for substantial work where a single attempt may take the wrong direction. CX Codex +1 539installs ds-watch-pr ds-watch-pr is a Claude Code skill that follows a pull request through CI and review, fixes real findings, and stops when it is ready, merged, or blocked. CX Codex +1 536installs ds-adopt ds-adopt — a Claude Code skill takes over an existing PR, branch, or agent thread and completes its original goal. It activates when asked to adopt or finish someone else’s work. CX Codex +1 534installs ds-ready ds-ready is a Claude Code skill that automates the delivery workflow through opening a pull request, then stops before merging. CX Codex +1 534installs ds-revive The ds-revive Claude Code skill checks whether an old PR still fits the current code. When asked to refresh or revive one, it recommends a rebase, a rewrite, or closure. CX Codex +1 534installs

Project sponsors

Companies that keep this analytics open