MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
Main agent orchestrator that coordinates a specialized squad of agents
Install Agent Squad
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install sickn33/agentic-awesome-skills agent-squad --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agent-squad .claude/skills/agent-squad && rm -rf skills-srcUse ~/.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/
Install the "agent-squad" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/agent-squad into .claude/skills/agent-squad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-squad", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/agent-squadType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install sickn33/agentic-awesome-skills agent-squad --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/agent-squad .agents/skills/agent-squad && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "agent-squad" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/agent-squad into .agents/skills/agent-squad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-squad", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install sickn33/agentic-awesome-skills agent-squad --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/agent-squad .cursor/skills/agent-squad && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "agent-squad" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/agent-squad into .cursor/skills/agent-squad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-squad", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/sickn33/agentic-awesome-skills.git --path skills/agent-squad--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install sickn33/agentic-awesome-skills agent-squad --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/agent-squad .gemini/skills/agent-squad && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "agent-squad" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/agent-squad into .gemini/skills/agent-squad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-squad", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install sickn33/agentic-awesome-skills agent-squadInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/agent-squad .github/skills/agent-squad && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "agent-squad" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/agent-squad into .github/skills/agent-squad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-squad", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install sickn33/agentic-awesome-skills agent-squad --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/agent-squad .opencode/skills/agent-squad && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "agent-squad" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/agent-squad into .opencode/skills/agent-squad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-squad", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
agent-squad- GitHub stars
- 47k
- Used in
- 1 other repo
- Token cost
- ~1.7k tokens
- SKILL.md length
- 736 words
- Files
- 1
- Skills in repo
- 1,354
- Repo updated
- First seen
- Licence
- MIT
At a glance
Main agent orchestrator that coordinates a specialized squad of agents
- Works in 4 steps: Agents are Autonomous, Not Chained → Context Window Discipline → Structured Relay → …
- Agent Workflows work in your project
- SKILL.md covers When to Use, The Squad, Core Principles and Routing Logic, plus 4 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Agent Squad is an agent skill from sickn33/agentic-awesome-skills. Main agent orchestrator that coordinates a specialized squad of agents
Its SKILL.md is about 1.7k 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: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.
When your agent uses it
- Agent Workflows work in your project
Example prompts
- “/agent-squad”
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit ec02547. 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
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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
Agent Squad loads about 1.7k tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 736 words of instructions outside code blocks.
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: warnings
The automated check found patterns that need a careful read before installing.
- WarningContains instruction-override wording (e.g. “without asking the user”)SKILL.md:40
auto-chain from Rex → Alex → ... → Dep without user consent.
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 sickn33/agentic-awesome-skills at commit ec02547, republished under its MIT licence (© sickn33). 736 words, ~1,725 tokens.
Download SKILL.mdSave it as
.claude/skills/agent-squad/SKILL.md (or your agent's skills folder).- name
- agent-squad
- description
- Main agent orchestrator that coordinates a specialized squad of agents
- risk
- critical
- source
- community
- date_added
- 2026-09-04
- role
- Orchestrator / Agent Panel
- phase
- all
- squad
- agent-squad
- version
- 1
Main Agent — The Orchestrator
The Main Agent is the single point of contact between the user and the squad. It never builds, reviews, or tests code itself. Its job is to understand what the user wants, route to the right agent, receive that agent's structured report, and relay a clean, compressed summary back to the user — preserving context without flooding its own context window.
When to Use
- Use this skill when the task matches this description: Main agent orchestrator that coordinates a specialized squad of agents.
The Squad
| Agent | Name | Phase | Triggers |
|---|---|---|---|
| Rex | Analyst | Requirements | New project, new feature, scope change |
| Alex | Strategist | Planning | After Rex, or "plan this out" |
| Aria | Architect | Architecture | After Alex, or "design the system" |
| Mason | Builder | Implementation | After Aria, or "build this" |
| Luna | Reviewer | Code Review | After Mason, or "review this code" |
| Quinn | QA Tester | Testing | After Luna, or "write tests / test this" |
| Max | Optimizer | Refactoring | Explicit request only — "refactor / optimize" |
| Dep | DevOps | Deployment | After Quinn, or "deploy / containerize / CI setup" |
Core Principles
1. Agents are Autonomous, Not Chained
- The squad does NOT auto-chain from Rex → Alex → ... → Dep without user consent.
- Each agent is invoked deliberately — by the user or by the main agent with explicit user approval.
- Any agent can be called at any time for any project state.
- Example: User can call Luna on existing code without going through Rex, Alex, Aria, or Mason.
2. Context Window Discipline
The main agent's context window is precious. It must never be filled with raw agent output.
Rule: Store artifacts by reference, not by content.
After each agent completes, the main agent:
- Stores the agent's full report under a versioned label (e.g.
REX_REPORT_v1,ALEX_PLAN_v1). - Keeps only the compressed summary in active context.
- When spinning up the next agent, passes only: (a) the compressed summary + (b) the version label of any full artifact the agent needs.
Compressed Summary Format (what stays in context):
[AGENT] [version] — [date]
Status: [COMPLETE / BLOCKED / PARTIAL]
Key outputs: [2–3 bullet points max]
Blockers: [if any]
Next recommended: [agent name or "awaiting user decision"]3. Structured Relay
When relaying to the user, the main agent always uses this structure:
## [Agent Name] — [Phase] Complete
**What happened:** [1–2 sentences]
**Key outputs:**
- [output 1]
- [output 2]
**Blockers / Decisions needed:**
- [question or decision for user]
**Recommended next step:** Invoke [Agent] or [awaiting your direction]Never relay the raw agent report to the user. Summarize; link the full artifact by reference.
4. Agent Invocation
When invoking an agent, the main agent passes a briefing packet — not the full prior reports. The briefing packet contains:
BRIEFING FOR [AGENT NAME]
Project: [name]
Context (compressed):
- Rex Report v[x]: [3-bullet summary]
- Alex Plan v[x]: [3-bullet summary]
- Aria Blueprint v[x]: [3-bullet summary]
- [etc. — only what this agent needs]
Your task:
[Specific instruction for this invocation]
Artifacts available by reference:
- REX_REPORT_v[x] — full feature list and user stories
- ALEX_PLAN_v[x] — full checklist and DoDs
- ARIA_BLUEPRINT_v[x] — full schema, API contract, file structure
- [etc.]
Constraints:
- [anything locked in that this agent must not change]Routing Logic
New Project
- → Rex (Requirements)
- → Alex (Planning) — after Rex report confirmed
- → Aria (Architecture) — after Alex plan confirmed
- → Mason (Implementation) — after Aria blueprint confirmed
- → Luna (Code Review) — after Mason milestone complete
- → Quinn (QA) — after Luna PASS or PASS WITH CONDITIONS
- → Dep (Deployment) — after Quinn PASS
- → Max (Refactoring) — only if explicitly requested
Show full SKILL.md (304 more words)Show less
Mid-Project Feature Addition
- → Rex (AMENDMENT — not full re-spec)
- → Alex (AMENDMENT)
- → Aria (AMENDMENT — if schema/API changes)
- → Mason (new milestone only)
- → Luna → Quinn → Dep as normal
Existing Codebase, No Prior Squad Context
- For review only: → Luna directly
- For testing only: → Quinn directly (may need Luna first if code is unreviewed)
- For optimization: → Max directly (user must confirm tests are passing)
- For deployment only: → Dep directly
When an Agent Reports a Blocker
- Main agent surfaces the blocker to the user immediately.
- Does NOT attempt to resolve it by invoking another agent without user input.
- Records the blocker in the project state.
Project State Tracking
The main agent maintains a lightweight project state object in its context:
PROJECT STATE
Name: [project name]
Started: [date]
Artifacts:
REX_REPORT_v1: [date] — COMPLETE
ALEX_PLAN_v1: [date] — COMPLETE
ARIA_BLUEPRINT_v1: [date] — COMPLETE
MASON_M1: [date] — COMPLETE
MASON_M2: [date] — IN PROGRESS
LUNA_REVIEW_v1: [date] — COMPLETE (2 HIGH resolved, 3 LOW deferred)
QUINN_REPORT_v1: [date] — COMPLETE (47/47 passing)
MAX_REFACTOR_v1: — NOT STARTED
DEP_PACKAGE_v1: — NOT STARTED
Current phase: Implementation (M2)
Active agent: Mason
Blockers: none
Open decisions: noneThis object is updated after every agent interaction. It is the single source of truth for project progress.
What the Main Agent Never Does
- Never writes application code.
- Never makes architecture decisions.
- Never resolves conflicts between agents by picking a side — surfaces to user.
- Never passes a full agent report as input to another agent — always compresses.
- Never invokes Max without explicit user request.
- Never invokes the next agent in a chain without confirming the user wants to continue.
- Never loses track of what phase the project is in.
User-Facing Communication Style
- Clear, brief, and structured.
- Presents one decision at a time — never overwhelms with choices.
- When agents disagree or a finding blocks progress, presents the tradeoff neutrally.
- Always tells the user which agent is active and what they're doing.
- Proactively flags when skipping a phase introduces risk (e.g. "Deploying without Quinn's tests means we have no automated verification — is that intentional?").
Limitations
- AI agents may occasionally hallucinate or provide incorrect guidance. Always verify generated code and architectural designs before pushing to production.
- Context window constraints mean large project histories must be compressed by the Orchestrator.
© sickn33, 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/agent-squad of sickn33/agentic-awesome-skills.
Open the folder on GitHubat commit ec02547
Used in 1 other repository
We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Agent Squad 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Agent Squad this skillsickn33/agentic-awesome-skills | 47k | 1 repos | ~1.7k | Automated safety check: Warn | MIT | |
| MCP Server Builderanthropics/skills | 180k | 64 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| Hook Development for Claude Code Pluginsanthropics/claude-plugins-official | 38k | 11 repos | ~4.1k | Automated safety check: Notes | Apache-2.0 | |
| Using Superpowersfarm-fe/farm | 5.6k | 35 repos | ~1.4k | Automated safety check: Pass | MIT | |
| Executing Plans Inlineobra/superpowers | 296k | 2 repos | ~5.1k | Automated safety check: Pass | MIT | |
| Claude Code Agent Developmentanthropics/claude-plugins-official | 38k | 8 repos | ~2.8k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
- Official
Hook Development for Claude Code Plugins
anthropics/claude-plugins-official
Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.
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
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.
- Official
Claude Code Agent Development
anthropics/claude-plugins-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.
- Official
Skill Creator
Azure/azqr
Create new skills, modify and improve existing skills, and measure skill performance.
More from sickn33/agentic-awesome-skills
All 1,354 skills in this repoLiuguang Banlan UI
sickn33/agentic-awesome-skills
Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.
User Thoughts Memory
sickn33/agentic-awesome-skills
Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.
Using LWC Memory and Graphs
sickn33/agentic-awesome-skills
Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.
Find Complementary Founders
sickn33/agentic-awesome-skills
Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.
Cline Pilot
sickn33/agentic-awesome-skills
Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.
Content Creator
sickn33/agentic-awesome-skills
Drafts and reviews audience-specific content from supplied brand examples, with local scripts for brand voice and SEO diagnostics, channel templates and a content calendar.
Related
Categories
Questions about Agent Squad
What does Agent Squad do?
Main agent orchestrator that coordinates a specialized squad of agents. Agent Squad is an agent skill from sickn33/agentic-awesome-skills.
When should I use Agent Squad?
Agent Squad fits situations like: agent Workflows work in your project.
How do I install Agent Squad in Claude Code?
Run `npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a claude-code`. Or copy the skill folder (skills/agent-squad in sickn33/agentic-awesome-skills) into .claude/skills/agent-squad in your project. Claude Code loads it when a task matches its description.
How do I install Agent Squad in Codex?
Run `npx skills add sickn33/agentic-awesome-skills --skill agent-squad -a codex`. Or copy the skill folder (skills/agent-squad in sickn33/agentic-awesome-skills) into .agents/skills/agent-squad in your project. Codex loads it when a task matches its description.
Can I use Agent Squad 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 sickn33/agentic-awesome-skills --skill agent-squad -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-squad, .gemini/skills/agent-squad, .github/skills/agent-squad and .opencode/skills/agent-squad in your project.
What does Agent Squad need to run?
SKILL.md names no scripts, command-line tools or credentials: Agent Squad is instructions for the agent only.
Does Agent Squad access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Agent Squad safe to install?
Our automated static check of SKILL.md flagged 1 warning(s): contains instruction-override wording (e.g. “without asking the user”). Read the flagged lines before installing; the check is not a guarantee either way.
What licence does Agent Squad use?
Agent Squad 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 Agent Squad use?
About 1.7k tokens (SKILL.md is roughly 6.9k 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 Agent Squad?
Skills that share tags, products or a category with Agent Squad: 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, 296k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Agent Squad?
sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,343 GitHub stars. The repository holds 1,354 skills in this directory. The repository was last updated on October 7, 2026.
Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.