opencode Swarm Skill

A Superpowers-compatible opencode skill for coordinating agent teams through a shared task board, direct teammate communication, review gates, cleanup, and verified completion.

Install with npx

npx @malichamdan/opencode-swarm-skill install

By default, this installs the skill to:

~/.agents/skills/swarm

Commands

npx @malichamdan/opencode-swarm-skill install
npx @malichamdan/opencode-swarm-skill update
npx @malichamdan/opencode-swarm-skill uninstall

• install creates the target skill directory and copies the bundled SKILL.md and pressure-tests.md files. It refuses to overwrite existing files unless --force is used.
• update replaces the installed files with the bundled package version.
• uninstall removes the swarm skill target directory without removing parent skill directories.

Options

npx @malichamdan/opencode-swarm-skill install --target ~/.agents/skills/swarm
npx @malichamdan/opencode-swarm-skill install --dry-run
npx @malichamdan/opencode-swarm-skill install --force
npx @malichamdan/opencode-swarm-skill --help
npx @malichamdan/opencode-swarm-skill --version

• --target <path> uses a custom skill directory.
• --dry-run prints planned actions without writing or deleting files.
• --force allows install to overwrite an existing target.
• --help prints CLI usage.
• --version prints the package version.

Manual install fallback

From a checkout of this repository:

mkdir -p ~/.agents/skills/swarm
cp skills/swarm/SKILL.md skills/swarm/pressure-tests.md ~/.agents/skills/swarm/

What it does

swarm helps split complex work into independent worker tasks while preserving required gates:

• Create a shared team board for complex work
• Let teammates claim open, independent tasks
• Allow direct teammate communication for blockers, dependencies, handoffs, and interface alignment
• Require important peer decisions to be logged back to the board
• Load applicable process skills first
• Decompose work into scoped independent tasks
• Require TDD RED/GREEN evidence for implementation workers
• Require file and line evidence for research workers
• Review worker output before integration
• Close completed workers after accepted evidence
• Cancel or shut down blocked, hanging, duplicated, or obsolete workers
• Clean up temp files, worktrees, branches, processes, logs, and artifacts
• Stop on conflicts, missing evidence, or skipped gates
• Run cleanup verification and final verification before claiming completion

When to use

Use this skill when complex opencode feature work, research, or code reading can be split across independent subagents and needs coordinated execution, review checkpoints, or Superpowers-compatible parallelism.

Do not use it for simple, sequential, or single-edit tasks.

Local verification

npm test
npm pack --dry-run

Publish

npm test
npm pack --dry-run
npm publish --access public