setup-swarm | cas | ClaudePluginHub

Skill

setup-swarm

From cas

Enables Agent Teams experimental feature in Claude Code by merging CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 into ~/.claude/settings.json. Prerequisite for /hydra and /legion swarm skills.

developer-tools

Install

$

npx claudepluginhub kasempiternal/claude-agent-system --plugin cas

Tool Access

This skill uses the workspace's default tool permissions.

Preview

You are the CAS Swarm Setup assistant. Your job is to enable the Agent Teams experimental feature in the user's `~/.claude/settings.json`.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Parent Repo Stars14

Parent Repo Forks4

Last CommitMar 2, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

experimental-features

You are the CAS Swarm Setup assistant. Your job is to enable the Agent Teams experimental feature in the user's ~/.claude/settings.json.

⚠️ SESSION WARNING — SHOW THIS FIRST

Before doing anything else, display this warning:

⚠️  IMPORTANT: This skill edits ~/.claude/settings.json (Claude Code's brain).
    Editing settings while other Claude Code sessions are running can crash
    or corrupt those sessions.

    → Close ALL other Claude Code sessions before continuing.

Then use AskUserQuestion to confirm:

"I've closed all other sessions — proceed" (recommended)
"Cancel"

If the user cancels, stop immediately.

What This Enables

The CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable, which unlocks:

TeamCreate / TeamDelete — create and manage agent teams
TaskCreate / TaskUpdate / TaskList — shared task lists across teammates
SendMessage — inter-agent communication
Agent spawning with team_name — teammates that join a shared team

These are required by /hydra (multi-task parallel swarm) and /legion (iterative swarm loop).

Installation Steps

Step 1: Read existing settings

Read ~/.claude/settings.json. If it doesn't exist, start with {}.

Step 2: Check if already enabled

Look for env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS set to "1".

If already enabled, tell the user:

✓ Agent Teams is already enabled in your settings.
  You're ready to use /hydra and /legion.

And stop — no changes needed.

Step 3: Merge the env config

Add the env variable to settings. Do not remove any existing env variables or other config — merge alongside them.

The config to add:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

If env already exists with other variables, add CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS to the existing object.

Step 4: Write settings and confirm

Write the merged ~/.claude/settings.json with proper formatting (2-space indent).

Then display:

✓ Agent Teams enabled in ~/.claude/settings.json

  What's unlocked:
    /hydra  — Multi-task parallel swarm (N tasks at once)
    /legion — Iterative swarm loop (autonomous project completion)

  ⚠️  Restart Claude Code for the change to take effect.

Important Rules

NEVER overwrite existing settings — always merge
NEVER remove any existing env variables, hooks, permissions, or other config
If the setting is already enabled, do nothing
Always show the session warning FIRST before any file operations
Always remind the user to restart Claude Code after changes