skills.rest
github
githubOFFICIAL
Explore all skills by this author →
WebsiteGitHub

squad-help

Explains correct invocation paths for the Squad custom Copilot agent.

5.1k|530|Updated Aug 12, 2025
Search Tags:#custom agent#Onboarding#Task tool#copilot cli#agent invocation#Squad
One-click install
npx skills add https://github.com/github/gh-aw --skill squad-help
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: squad-help
Source: https://github.com/github/gh-aw/tree/main/.squad/templates/skills/squad-help
Command: npx skills add https://github.com/github/gh-aw --skill squad-help

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users and AI agents frequently confuse Squad with a skill or slash command, causing failed invocations like skill(Squad) or /squad. This Skill clarifies that Squad is a custom Copilot CLI agent and documents the correct ways to invoke it.

Core Features & Use Cases

  • Invocation Routing: Maps user intent to the right path — the task tool with agent_type="Squad", the squad-commands skill catalog, or the squad init shell command.
  • Anti-Pattern Guardrails: Lists explicit mistakes to avoid, such as calling skill(Squad) or typing /squad as a slash command.
  • Use Case: When a user says "use Squad to build X" or "set up a squad", the agent reads this Skill and correctly invokes the Squad coordinator via the task tool instead of failing with a skill-not-found error.

Quick Start

Ask the agent to use Squad to set up a team for your project, and it will invoke the Squad coordinator through the task tool.

Frequently Asked Questions about squad-help

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I invoke the Squad agent in Copilot CLI?▼

Invoke Squad through the task tool with agent_type set to "Squad" and a prompt describing the work. Squad is a custom agent registered at .github/agents/squad.agent.md, not a skill, so skill(Squad) will fail.

Why does skill(Squad) fail with Skill not found?▼

Squad is a custom Copilot CLI agent, not a skill, so the skill loader has no entry named Squad. Use the task tool with agent_type="Squad" instead to reach the Squad coordinator.

Is there a /squad slash command in Copilot CLI?▼

No, /squad does not exist. Slash commands are built-in CLI keywords like /agent, /skills, and /mcp. Use /agent to browse agents or invoke Squad via the task tool.

How do I initialize Squad in a new project?▼

Run the shell command `squad init` in a terminal inside a project that has no .squad/ directory yet. It is a shell command, not a tool call, so it cannot be invoked from within an active Copilot session.

When should I not use the Squad coordinator?▼

Avoid invoking Squad for trivial tasks the current agent can handle directly, such as small edits. Squad is designed for work that needs orchestration across a team of specialist agents.

Related Skills

Explore More Software Engineering Skills→
B0yZ4kr14B0yZ4kr14

speckit-squad-init

Initialize a Squad workspace from a Speckit spec with agent definitions and routing rules.

Community
Intermediate
lbouriezlbouriez

cross-squad

Coordinate cross-squad work via manifests and structured handoff protocols.

Community
Advanced
nicolehaugennicolehaugen

cross-squad

Discover Squad capabilities and delegate tasks across Squad instances.

Community
Intermediate
lucking7lucking7

s-two

Execute tasks directly without persona-based sub-agent dependencies.

Community
Basic