About

Imported from shipshitdev/skills (skills/swarm/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill swarm. Copyright stays with the author (MIT).

Swarm

Name: swarm
Author: shipshitdev

Fan out N parallel workers. They may cover separate slices, race the same brief, or mix both. The parent waits, aggregates, and returns one report.

Companion to arena, which picks a base and grafts. Companion to multi-agent-patterns, which designs architectures. This skill runs one operational fan-out.

Authorized Scope

Apply this engine only within the user's requested task and existing explicit authorization. Loading or delegating to it grants no additional authority. Preserve report-only restrictions and the caller's target, host, provider, and cost limits. Existing approval satisfies a gate only for the same actions and scope; obtain approval before expanding them. Forward these limits to delegates.

Contract

Inputs:

A done predicate and the report the swarm must return
Shape: partition, race, or mix
Optional N

Outputs:

One consolidated report with a result table, issue one-liners, and gaps or dropouts

Creates/Modifies:

Per-worker output under worktrees or .tmp/swarm-<slug>/worker-<n>/ when workers write

External Side Effects:

None beyond what each worker's brief authorizes

Confirmation Required:

None for the swarm itself

Delegates To:

worktree when workers need isolated checkouts

Phases

Open a todo list: Frame, Fan out, Aggregate, Report.

A. Frame

State the done predicate. Choose the shape. For a race, declare first pass, rank all, or best-of before spawning. Set N. Default workers to the fast cheap tier. For a model-family race, name each arm's capability tier up front.

B. Fan out

Spawn all N workers in one message. Every brief stands alone: goal, scope, slice or race arm, how to verify, what to report. Reports use PASS, ISSUES, or BLOCKED with evidence.

C. Aggregate

Read the terminal results. For coverage, every required slice needs a result. For a race, apply the selection rule declared up front. Do not paste raw worker dumps.

D. Report

Return one in-chat report: table, issue one-liners, gaps or dropouts, and the race rule when used.

Swarm procedure

Read swarm procedure when running this workflow. Apply the authorized scope and mode of this entry point to every step. Resolve other skills through this distribution’s active catalog; resolve resources relative to the installed skill directory.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-swarm/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-swarm.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-swarm",
  "kind": "skill",
  "name": "swarm",
  "description": "Fan out N parallel workers, drain them, and return one report. Use for swarm this, or parallel coverage, races, gauntlets, and exploration partitions.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "fan-out",
      "coverage",
      "race",
      "report",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Fan out N parallel workers, drain them, and return one report. Use for swarm this, or parallel coverage, races, gauntlets, and exploration partitions."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/swarm/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/swarm/SKILL.md",
      "key": "shipshitdev/skills/skills/swarm/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Swarm\n\nFan out N parallel workers. They may cover separate slices, race the\nsame brief, or mix both. The parent waits, aggregates, and returns one\nreport.\n\nCompanion to `arena`, which picks a base and grafts. Companion to\n`multi-agent-patterns`, which designs architectures. This skill runs\none operational fan-out.\n\n## Authorized Scope\n\nApply this engine only within the user's requested task and existing explicit\nauthorization. Loading or delegating to it grants no additional authority.\nPreserve report-only restrictions and the caller's target, host, provider, and\ncost limits. Existing approv",
  "cost": {
    "context_tokens": 593
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-swarm/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.