squad-help

Skill: squad-help

Quick reference. If you're reading this because a user said "use squad" or "squad" or "set up a squad", you're in the right place — read on for the correct invocation paths.

---

Squad is a custom agent, not a skill

The Squad framework registers a custom Copilot CLI agent at .github/agents/squad.agent.md. The agent is named Squad and its description is "Your AI team. Describe what you're building, get a team of specialists that live in your repo."

Copilot CLI agents and skills are different things:

Thing	How to invoke	Example
Skill	skill(name) tool call or natural-language match	skill(squad-commands)
Agent	task tool with agent_type=<name>	task(name="...", agent_type="Squad", prompt="...")
Slash command	Built-in CLI keyword	/agent, /skills, /mcp

Calling skill(Squad) will fail with "Skill not found: Squad" because Squad is the agent, not a skill. (/squad as a slash command also does not exist — only built-in CLI keywords like /agent, /skills, /mcp are slash commands. There's no way to map a skill name to a slash command without a Copilot CLI feature change.)

---

How to actually use Squad

Pick the path that matches the user's intent:

A) Invoke the Squad coordinator agent (most common)

The Squad coordinator orchestrates a team of specialists. It routes work to the right agent, scaffolds a team if none exists, and enforces handoffs.

task(
  name="<short-task-name>",
  agent_type="Squad",
  prompt="<what you want the team to do>"
)

Use this when the user says things like:

• "Use Squad to build X"
• "Set up an AI team for this project"
• "Have the Squad coordinator design Y"
• "Spawn Squad" / "Squad, help me with ..."

B) See what Squad commands exist

The squad-commands skill is a categorized catalog of common Squad operations. The coordinator presents it as an interactive menu.

Trigger by natural-language match: "squad commands", "what can squad do", "show me squad options", "slash commands", "what commands are available".