coordinator-init-mode

Proposes and scaffolds a new Squad agent team in repositories lacking .squad/team.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a repository has never been set up with a Squad agent team, the coordinator needs a safe, structured way to propose a team roster and then create all the required .squad/ scaffolding without prematurely writing files before the user confirms.

Core Features & Use Cases

  • Two-phase init protocol: Phase 1 proposes a cast of 4-5 domain agents plus the four always-on built-ins (Scribe, Ralph, Rai, Fact Checker) and waits for explicit user confirmation; Phase 2 creates the .squad/ directory structure only after approval.
  • Casting and naming: Runs the casting algorithm to select a character universe, allocate persistent agent names, and seed casting state (policy.json, registry.json, history.json).
  • Scaffolding and merge safety: Creates team.md with the mandatory ## Members header used by GitHub workflow label automation, seeds agent charters and history files, and configures .gitattributes union merge drivers for append-only squad state files.
  • Use Case: A developer opens a fresh repository with the Squad coordinator; the skill detects the missing .squad/team.md, proposes a themed team roster for confirmation, then scaffolds the full team structure and offers optional PRD, GitHub issues, and Copilot agent onboarding.

Quick Start

Ask the coordinator to set up a new Squad team in this repository and confirm the proposed roster when prompted.

Frequently Asked Questions about coordinator-init-mode

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

FAQPage Schema
How do I set up a new Squad agent team in a fresh repository?

The coordinator detects the missing .squad/team.md and loads Init Mode. It proposes a roster of 4-5 cast agents plus the built-ins Scribe, Ralph, Rai, and Fact Checker, then creates the .squad/ scaffolding only after you confirm.

How does Squad casting assign agent names?

Casting derives resonance signals from the session and repo context, selects a character universe, and allocates persistent character names to agents. Scribe, Ralph, Rai, and Fact Checker are exempt and always keep their fixed names.

Why must team.md contain a ## Members section header?

The exact `## Members` header is hard-coded in GitHub workflows such as squad-heartbeat.yml and squad-triage.yml for label automation. A missing or renamed header breaks label routing across the squad workflows.

Can the coordinator create squad files before I confirm the team?

No. Phase 1 ends with a blocking confirmation via the ask_user tool, and no files or directories are created until you reply affirmatively. This is the one exception to the coordinator's eager-execution doctrine.

Why does Squad use union merge drivers in .gitattributes?

Append-only squad files like decisions.md, agent history files, and logs use the union merge driver so lines from both branches are kept during merges. This lets worktree-local strategies combine decisions and memories across branches without conflicts.