# Squad

Squad's command catalog and interactive menu.

- Repository: https://github.com/microsoft/waza (1496 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/waza --skill squad -g -a claude-code -y`
Codex: `npx skills add microsoft/waza --skill squad -g -a codex -y`
Cursor: `npx skills add microsoft/waza --skill squad -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/waza --skill squad -g -a gemini-cli -y`

## Description

Squad's command catalog and interactive menu. Invoke via /squad where the host exposes user-invocable skills as commands, or natural language ("squad commands", "what can squad do", "show me squad options"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Menu Presentation Rules

**Host-dependent invocation:** `user-invocable: true` declares menu intent, not a guarantee
that every host exposes `/squad`. Use natural-language triggers or the host skill picker/tool
when slash invocation is unavailable. This menu is separate from the `Squad` coordinator agent.

When the user triggers this skill (via `/squad` slash command, "squad commands", "help", "what can squad do", etc.):

1. **Category-level menu first.** Present category names as an `ask_user` choice list:
   ```
   📋 Squad Commands, pick a category:
   1. Install & Upgrade
   2. Team Management
   3. Issues & PRs
   4. Plugins & Skills
   5. Model & Cost
   6. Sessions & State
   ```
2. **Drill-down.** After selection, show operation titles in that category as a second `ask_user` list.
3. **Direct match skips the menu.** If the user says "how do I upgrade with state backend," match to the specific entry and go straight to argument collection.
4. **Compact fallback.** If `ask_user` is unavailable, render as a markdown table instead.
5. **Back / Cancel.** Include "← Back to categories" in sub-menus. Include "Cancel" in confirmation prompts. Respect "never mind" / "cancel" at any point.

**Argument collection:** For entries with `args`, iterate the list sequentially. Use `ask_user` with choices when `choices` is provided; free-text prompt otherwise. If the user says "just do it" or "defaults are fine," skip remaining args and use their defaults.

**Confirmation template:**
```
⚠️ This will {action-description}.
{what will change}
Proceed? (yes / no)
```

---

## Install & Upgrade

### Upgrade Squad CLI

The rest: https://github.com/microsoft/waza/blob/HEAD/.github/skills/squad/SKILL.md