Agent skill

Swarm Coordination

by dralgorhythm in dralgorhythm/claude-agentic-framework

Rules for several agents sharing one repository: an orchestrator tracks work in two tiers, workers write to scratch files, and every handoff leaves a pointer to an artifact.

No licenceAuto-check passedAgent Workflows

Install Swarm Coordination

skills CLI
$ npx skills add dralgorhythm/claude-agentic-framework --skill swarm-coordination -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dralgorhythm/claude-agentic-framework swarm-coordination --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dralgorhythm/claude-agentic-framework.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/operations/swarm-coordination .claude/skills/swarm-coordination && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
swarm-coordination
GitHub stars
125
Token cost
~1.6k tokens
SKILL.md length
745 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
None found

At a glance

Rules for several agents sharing one repository: an orchestrator tracks work in two tiers, workers write to scratch files, and every handoff leaves a pointer to an artifact.

  • Works in 4 steps: Two-Tier Task Tracking: Durable work… → File Locking: Hooks automatically manage… → Session Isolation: Each agent has a… → …
  • Running several agents in parallel on one repository
  • SKILL.md covers Core Principles, Two-Tier Task Tracking, File-Based Output and Workflows, plus 7 more sections
  • Calls git

What it does

The skill sets protocols for running more than one Claude Code agent in the same codebase without collisions. Task tracking has two tiers. GitHub Issues, or a committed `ISSUES.md` when a repo has no tracker, keep the durable record of what was asked and how it ended, while the orchestrator's native task list holds in-flight work, one task per item with explicit acceptance criteria. Workers do not keep task lists of their own.

Workers write results to files under `scratchpad/`, one per task, and only lasting artifacts such as ADRs, plans and PRDs go to `artifacts/`. The orchestrator creates those output targets before dispatching workers, then reads and synthesizes what they wrote. Hooks manage file locks that agents are expected to respect, and `.claude/hooks/.file-tracker.log` shows recent edits. Checklists for starting, working and finishing cover small atomic changes, frequent commits, running tests and closing the task with its result.

When your agent uses it

  • Running several agents in parallel on one repository
  • Handing a task from one agent to another without losing state
  • Deciding where to record durable versus in-progress work items
  • Dispatching workers with focused, self-contained prompts

Example prompts

  • “Split the API migration across three workers and coordinate them through a task list.”
  • “Before another agent starts on this repo, check the file tracker log for recent edits.”
  • “Hand off the half-finished auth refactor with a note the next agent can continue from.”

Requirements

  • File-lock hooks from the same agent framework
  • GitHub Issues or an ISSUES.md file for durable records

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Two-Tier Task Tracking: Durable work items live in GitHub Issues (or a committed ISSUES.md); in-flight work lives in the orchestrator's…
  2. File Locking: Hooks automatically manage file locks - respect them
  3. Session Isolation: Each agent has a unique session ID for tracking
  4. Clean Handoffs: Always leave state — and an artifact reference — that another agent can continue from

What it can do on your machine

Read from SKILL.md and the folder at commit 6436a20. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Swarm Coordination loads about 1.6k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 745 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 745 words (~1,627 tokens).

“Protocols and patterns for consistent, conflict-free multi-agent development. Follow these guidelines when working alongside other Claude Code agents in the same codebase.”

— opening of SKILL.md by dralgorhythm
name
swarm-coordination

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/operations/swarm-coordination of dralgorhythm/claude-agentic-framework.

Open the folder on GitHubat commit 6436a20

Compare with similar skills

Swarm Coordination next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Swarm Coordination compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swarm Coordination this skilldralgorhythm/claude-agentic-framework125—~1.6kAutomated safety check: PassNone
Beadsmatthiasn/lotti1.2k—~589Automated safety check: PassGPL-3.0
Gh Issuesserejaris/personal-corp-os229—~1.8kAutomated safety check: PassMIT
Agent Kanban Task Workersaltbo/agent-kanban486—~855Automated safety check: PassCustom licence
Orca CLIstablyai/orca87k2 repos~593Automated safety check: PassMIT
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Beads

    matthiasn/lotti

    A skill your agent uses for authorized Lotti maintainer work that needs private durable task tracking, issue dependencies, blocker management, multi-session handoff, or shared agent memory.

    1.2k GitHub stars~589 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Gh Issues

    serejaris/personal-corp-os

    A skill your agent uses when creating, searching, updating, or managing GitHub issues via CLI.

    229 GitHub stars~1.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Agent Kanban Task Worker

    saltbo/agent-kanban

    Lets an agent read, claim, update and submit an assigned Agent Kanban task through the Realmroot Toolbox CLI, with progress notes and a review handoff.

    486 GitHub stars~855 tokensUpdated 6 days ago
    Productivity & AutomationAuto-check passed
  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    87k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Paseo Agent Handoff

    getpaseo/paseo

    Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.

    20k GitHub starsUsed in 1 repo~606 tokens
    Agent WorkflowsAuto-check passed

More from dralgorhythm/claude-agentic-framework

All 20 skills in this repo
  • Threat Modeling

    dralgorhythm/claude-agentic-framework

    Finds security threats in a design with a STRIDE pass per component, rates severity and records fixes, with extra checks for AI agent and tool risks.

    125 GitHub stars~581 tokensUpdated 2 mo ago
    Auto-check passed
  • Architecture Decision Record Writer

    dralgorhythm/claude-agentic-framework

    Writes Architecture Decision Records with title, status, context, decision, rationale and consequences for significant technical choices, kept short and numbered.

    125 GitHub stars~529 tokensUpdated 2 mo ago
    Auto-check passed
  • Codebase Health Auditor

    dralgorhythm/claude-agentic-framework

    Runs a user-invoked, swarm-style audit of a whole codebase for SOLID and DRY violations, code smells, complexity, dead code and pattern consistency, with a prioritized report.

    125 GitHub stars~980 tokensUpdated 2 mo ago
    Auto-check passed
  • Dependency Upgrade Protocol

    dralgorhythm/claude-agentic-framework

    Sequences safe dependency upgrades: read the changelog, verify the version exists upstream, pin it, and keep major bumps in separate commits behind a full gate run.

    125 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Designing Systems

    dralgorhythm/claude-agentic-framework

    Produces this framework's ADR and system-design artifacts from bundled templates with trade-off analysis.

    125 GitHub stars~458 tokensUpdated 2 mo ago
    Auto-check passed
  • Land The Plane

    dralgorhythm/claude-agentic-framework

    Lands in-flight work: quality gates, atomic commit, rebase, push, verified remote sync, then handoff — a user-invoked finish-line workflow.

    125 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Swarm Coordination

What does Swarm Coordination do?

Rules for several agents sharing one repository: an orchestrator tracks work in two tiers, workers write to scratch files, and every handoff leaves a pointer to an artifact. The skill sets protocols for running more than one Claude Code agent in the same codebase without collisions. Task tracking has two tiers.

When should I use Swarm Coordination?

Swarm Coordination fits situations like: running several agents in parallel on one repository; handing a task from one agent to another without losing state; deciding where to record durable versus in-progress work items; dispatching workers with focused, self-contained prompts.

How do I install Swarm Coordination in Claude Code?

Run `npx skills add dralgorhythm/claude-agentic-framework --skill swarm-coordination -a claude-code`. Or copy the skill folder (.claude/skills/operations/swarm-coordination in dralgorhythm/claude-agentic-framework) into .claude/skills/swarm-coordination in your project. Claude Code loads it when a task matches its description.

How do I install Swarm Coordination in Codex?

Run `npx skills add dralgorhythm/claude-agentic-framework --skill swarm-coordination -a codex`. Or copy the skill folder (.claude/skills/operations/swarm-coordination in dralgorhythm/claude-agentic-framework) into .agents/skills/swarm-coordination in your project. Codex loads it when a task matches its description.

Can I use Swarm Coordination in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dralgorhythm/claude-agentic-framework --skill swarm-coordination -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swarm-coordination, .gemini/skills/swarm-coordination, .github/skills/swarm-coordination and .opencode/skills/swarm-coordination in your project.

What does Swarm Coordination need to run?

Going by SKILL.md and its folder, Swarm Coordination needs the command-line tools its instructions call (git). Our summary lists: File-lock hooks from the same agent framework; GitHub Issues or an ISSUES.md file for durable records.

Does Swarm Coordination access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Swarm Coordination safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Swarm Coordination use?

No licence was found for Swarm Coordination or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Swarm Coordination use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Swarm Coordination?

Skills that share tags, products or a category with Swarm Coordination: Beads (matthiasn/lotti, 1.2k stars), Gh Issues (serejaris/personal-corp-os, 229 stars), Agent Kanban Task Worker (saltbo/agent-kanban, 486 stars) and Orca CLI (stablyai/orca, 87k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swarm Coordination?

dralgorhythm (a GitHub user) maintains it in dralgorhythm/claude-agentic-framework, which has 125 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on July 24, 2026.

Source: dralgorhythm/claude-agentic-framework on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.