Agent skill

Swarmclaw

by LeoYeAI in LeoYeAI/openclaw-master-skills

Manage your SwarmClaw agent fleet, create and assign tasks, check agent and session status, trigger workflows, and orchestrate multi-agent work from chat.

MITAuto-check passedAgent Workflows

Install Swarmclaw

skills CLI
$ npx skills add LeoYeAI/openclaw-master-skills --skill swarmclaw -a claude-code

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

GitHub CLI
$ gh skill install LeoYeAI/openclaw-master-skills swarmclaw --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/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/swarmclaw .claude/skills/swarmclaw && 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
swarmclaw
GitHub stars
2.2k
Token cost
~1.3k tokens
SKILL.md length
515 words
Files
1
Skills in repo
1,235
Repo updated
First seen
Licence
MIT

At a glance

Manage your SwarmClaw agent fleet, create and assign tasks, check agent and session status, trigger workflows, and orchestrate multi-agent work from chat.

  • Works in 3 steps: Install: npm i -g @swarmclawai/swarmclaw → Set env var: export… → Full docs: https://swarmclaw.ai/docs —…
  • Orchestrate multi-agent work from chat
  • SKILL.md covers Overview, Setup, Multi-Gateway Fleet Management and Commands, plus 2 more sections
  • Calls npm; needs SWARMCLAW_ACCESS_KEY

What it does

Swarmclaw is an agent skill from LeoYeAI/openclaw-master-skills. Manage your SwarmClaw agent fleet, create and assign tasks, check agent and session status, trigger workflows, and orchestrate multi-agent work from chat. Use when asked to dispatch work to other agents, check what agents are doing, run diagnostics, or coordinate across a SwarmClaw dashboard instance.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

  • Orchestrate multi-agent work from chat
  • Asked to dispatch work to other agents
  • Check what agents are doing
  • Run diagnostics

Example prompts

  • “/swarmclaw”

Requirements

  • Node.js
  • A credential in SWARMCLAW_ACCESS_KEY

Workflow steps

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

  1. Install: npm i -g @swarmclawai/swarmclaw
  2. Set env var: export SWARMCLAW_ACCESS_KEY= (shown in terminal on first run)
  3. Full docs: https://swarmclaw.ai/docs — CLI reference: https://github.com/swarmclawai/swarmclaw

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. 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:

    • npm

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

  • Network

    Links to these hosts (documentation or services it may open):

    • swarmclaw.ai
    • github.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SWARMCLAW_ACCESS_KEY

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

Context cost

Swarmclaw loads about 1.3k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 515 words of instructions outside code blocks.

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

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

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 515 words, ~1,307 tokens.

Download SKILL.mdSave it as .claude/skills/swarmclaw/SKILL.md (or your agent's skills folder).
name
swarmclaw
description
Manage your SwarmClaw agent fleet, create and assign tasks, check agent and session status, trigger workflows, and orchestrate multi-agent work from chat. Use when asked to dispatch work to other agents, check what agents are doing, run diagnostics, or coordinate across a SwarmClaw dashboard instance.
version
1.0.2
emoji
🦞
homepage
https://github.com/swarmclawai/swarmclaw

Overview

SwarmClaw is a self-hosted AI agent orchestration dashboard. This skill gives you CLI access to manage agents, tasks, sessions, schedules, and memory across a SwarmClaw instance.

Install the CLI:

bash
npm i -g @swarmclawai/swarmclaw

Authentication uses SWARMCLAW_ACCESS_KEY (preferred) or CLI key flags. Default URL is http://localhost:3456; override with SWARMCLAW_URL, --url (legacy commands), or --base-url (API-mapped commands).

Use machine-readable output when parsing command results:

  • --raw for legacy commands
  • --json for API-mapped commands

Setup

  1. Install: npm i -g @swarmclawai/swarmclaw
  2. Set env var: export SWARMCLAW_ACCESS_KEY=<your-key> (shown in terminal on first run)
  3. Full docs: https://swarmclaw.ai/docs — CLI reference: https://github.com/swarmclawai/swarmclaw

Multi-Gateway Fleet Management

SwarmClaw can connect to multiple OpenClaw gateways at the same time. Each SwarmClaw agent can target a different gateway, including one local and several remote instances. This skill’s commands operate through the SwarmClaw control plane, so your agent/task/session actions apply across the fleet view. Use it when you need status and task coordination across more than one OpenClaw instance.

Commands

Agents:

  • swarmclaw agents list — list all agents with IDs, names, providers, status
bash
swarmclaw agents list --raw
  • swarmclaw agents get <agentId> — get full details for a specific agent
bash
swarmclaw agents get <agentId> --raw

Tasks:

  • swarmclaw tasks create --title "..." --description "..." --agent-id <agentId> — create and assign a task
bash
swarmclaw tasks create --title "Analyse competitor pricing" --description "Research and compare competitor pricing strategies, identify gaps and opportunities" --agent-id <agentId> --raw
  • swarmclaw tasks list — list all tasks with status
bash
swarmclaw tasks list --raw

Sessions:

  • swarmclaw sessions list — list active sessions
bash
swarmclaw sessions list --raw
  • swarmclaw sessions chat <id> --message "..." — send a message to an existing session
bash
swarmclaw sessions chat <id> --message "Give me a status update" --raw

Memory:

  • swarmclaw memory maintenance — run memory maintenance analysis
bash
swarmclaw memory maintenance --raw

Diagnostics:

  • swarmclaw setup doctor — run system diagnostics and report issues
bash
swarmclaw setup doctor --raw

Version:

  • swarmclaw version check — check current version and update status
bash
swarmclaw version check --raw
Show full SKILL.md (268 more words)Show less

Rules

  1. Always verify an agent ID exists by running agents list before creating tasks for it.
  2. Never pass the access key as a CLI argument in visible output — rely on the SWARMCLAW_ACCESS_KEY env var.
  3. If the SwarmClaw instance is unreachable, run swarmclaw setup doctor and report the findings before retrying.
  4. When the user says "dispatch work", "get X agent to do Y", or "assign this to", use tasks create to assign the work to the appropriate agent.
  5. When the user asks "what's running", "agent status", or "what are my agents doing", combine output from agents list and sessions list to give a full picture.
  6. For complex multi-step orchestration, create individual tasks rather than chaining commands.
  7. Use --raw/--json output modes when you need to parse command output for further processing.
  8. Do not run commands that modify or delete agents without explicit user confirmation.

Examples

Dispatch work to another agent: User says: "Get my research agent to analyse competitor pricing"

bash
swarmclaw agents list --raw
swarmclaw tasks create --title "Analyse competitor pricing" --description "Research and compare competitor pricing strategies, identify gaps and opportunities" --agent-id <research-agent-id> --raw

Then confirm the task was created and the agent will pick it up.

Check fleet status: User says: "What are all my agents doing right now?"

bash
swarmclaw agents list --raw
swarmclaw sessions list --raw

Then summarize which agents are idle, which have active sessions, and any tasks in progress.

Run diagnostics: User says: "Something seems wrong with SwarmClaw"

bash
swarmclaw setup doctor --raw

Then report issues found and suggest fixes based on the doctor output.

Check agents across gateways: User says: "What's happening across all my OpenClaw instances?"

bash
swarmclaw agents list --raw

Then use the output to identify agents across multiple gateways with their connection status, and summarize which gateways are healthy and which agents are active on each.

© LeoYeAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/swarmclaw of LeoYeAI/openclaw-master-skills.

Open the folder on GitHubat commit e5199b5

Compare with similar skills

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

Swarmclaw compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swarmclaw this skillLeoYeAI/openclaw-master-skills2.2k—~1.3kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 35 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    297k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

More from LeoYeAI/openclaw-master-skills

All 1,235 skills in this repo
  • DevOps Pipeline Management

    LeoYeAI/openclaw-master-skills

    Manages pipelines on a DevOps quality and efficiency platform through its OpenAPI: list workspaces and templates, create, update, run and cancel pipelines, and read run records.

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Auto-check: notes
  • Feishu Document Collaboration

    LeoYeAI/openclaw-master-skills

    Patches OpenClaw's Feishu extension so an edited document triggers an isolated agent session that reads the doc and replies inline, turning it into a live chat space.

    2.2k GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Files Memory System

    LeoYeAI/openclaw-master-skills

    Multi-context memory management system for OpenClaw agents with group-isolated storage, global shared memory, workspace organization, and group-specific skills isolation.

    2.2k GitHub stars~3.8k tokensUpdated 2 mo ago
    Auto-check passed
  • GEO-Claw AI Visibility Agent

    LeoYeAI/openclaw-master-skills

    Runs a brand's AI-search visibility work end to end: diagnosing how AI platforms represent it, repositioning it, producing AI-optimized content and monitoring ongoing mentions.

    2.2k GitHub stars~4.7k tokensUpdated 2 mo ago
    Auto-check passed
  • Google Workspace CLI

    LeoYeAI/openclaw-master-skills

    Installs and authenticates the gws CLI, then automates Gmail, Drive, Sheets, Calendar, Docs, Chat and Tasks with ready-made recipes, persona bundles and security audits.

    2.2k GitHub stars~2.6k tokensUpdated 2 mo ago
    Auto-check: notes
  • HealthFit Health Advisors

    LeoYeAI/openclaw-master-skills

    Runs four advisor roles, a fitness coach, nutritionist, data analyst and TCM practitioner, to build a health profile and track workouts, diet and wellness over time.

    2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Swarmclaw

What does Swarmclaw do?

Manage your SwarmClaw agent fleet, create and assign tasks, check agent and session status, trigger workflows, and orchestrate multi-agent work from chat. Swarmclaw is an agent skill from LeoYeAI/openclaw-master-skills. Manage your SwarmClaw agent fleet, create and assign tasks, check agent and session status, trigger workflows, and orchestrate multi-agent work from chat.

When should I use Swarmclaw?

Swarmclaw fits situations like: orchestrate multi-agent work from chat; asked to dispatch work to other agents; check what agents are doing; run diagnostics.

How do I install Swarmclaw in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill swarmclaw -a claude-code`. Or copy the skill folder (skills/swarmclaw in LeoYeAI/openclaw-master-skills) into .claude/skills/swarmclaw in your project. Claude Code loads it when a task matches its description.

How do I install Swarmclaw in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill swarmclaw -a codex`. Or copy the skill folder (skills/swarmclaw in LeoYeAI/openclaw-master-skills) into .agents/skills/swarmclaw in your project. Codex loads it when a task matches its description.

Can I use Swarmclaw 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 LeoYeAI/openclaw-master-skills --skill swarmclaw -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swarmclaw, .gemini/skills/swarmclaw, .github/skills/swarmclaw and .opencode/skills/swarmclaw in your project.

What does Swarmclaw need to run?

Going by SKILL.md and its folder, Swarmclaw needs the command-line tools its instructions call (npm) and credentials named SWARMCLAW_ACCESS_KEY. Our summary lists: Node.js; A credential in SWARMCLAW_ACCESS_KEY.

Does Swarmclaw access the network?

SKILL.md names 2 domains. As links in the text: swarmclaw.ai and github.com. This is read from the text; nothing was executed.

Is Swarmclaw 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 Swarmclaw use?

Swarmclaw is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Swarmclaw use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 Swarmclaw?

Skills that share tags, products or a category with Swarmclaw: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swarmclaw?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,161 GitHub stars. The repository holds 1,235 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.