squad-commands

Presents a categorized interactive menu of Squad CLI operations and coordinator workflows.

5.1k|530|Updated Aug 12, 2025
One-click install
npx skills add https://github.com/github/gh-aw --skill squad-commands
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squad-commands
Source: https://github.com/github/gh-aw/tree/main/.squad/templates/skills/squad-commands
Command: npx skills add https://github.com/github/gh-aw --skill squad-commands

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users of the Squad multi-agent framework often do not know which commands or operations are available, forcing them to memorize CLI syntax and coordinator flows. This Skill catalogs common Squad operations and presents them as an interactive, drill-down menu so users can discover and execute the right command quickly.

Core Features & Use Cases

  • Interactive Category Menu: Presents six categories (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an ask_user choice list with drill-down to individual operations.
  • Guided Argument Collection: For operations with arguments, prompts sequentially with choices or free-text, supports defaults, and asks for confirmation on destructive actions like removing team members or archiving decisions.
  • Direct Intent Matching: Skips the menu when the user's phrasing matches a specific entry, such as "how do I upgrade with state backend", going straight to argument collection.
  • Use Case: A user types "what can squad do" and receives a category menu, selects "Issues & PRs", then chooses "Start Squad Watch" and is told to run squad watch --interval 10 in their terminal.

Quick Start

Ask the assistant "show me squad commands" or "what can squad do" to open the interactive category menu and pick an operation.

Frequently Asked Questions about squad-commands

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

FAQPage Schema
How do I see all available Squad commands?

Say "squad commands", "help", or "what can squad do" to trigger the interactive menu. It shows six categories first, then drills down into individual operations within the category you select.

How do I upgrade the Squad CLI to the latest version?

Run `squad upgrade` in a terminal. In VS Code, open the integrated terminal and run the command directly, since the operation requires terminal access.

Can I change where Squad stores its state?

Yes, edit the stateBackend field in .squad/config.json to switch between worktree, git-notes, orphan, or two-layer backends. Switching away from worktree may require migration, so the current and new values are shown before confirming.

How do I add or remove agents from my Squad team?

Use the Add Team Member flow to specify a role and optional name, or the Remove Team Member flow to delete an agent along with their charter and history files. Removal requires confirmation before proceeding.

Does squad watch work inside VS Code?

Squad watch is a long-running foreground CLI process, so it is not viable in VS Code without an integrated terminal. Run `squad watch --interval N` in a standalone terminal instead.

What happens if I skip argument prompts in a Squad command?

Saying "just do it" or "defaults are fine" skips the remaining argument prompts and applies their documented default values, such as a 10-minute polling interval or a 30-day archival threshold.