init-mode

Proposes and creates a .squad team structure after user confirmation.

1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill init-mode-seiggy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-mode
Source: https://github.com/seiggy/maf-copilot-studio-demo/tree/main/.squad/templates/skills/init-mode
Command: npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill init-mode-seiggy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a multi-agent team structure from scratch is error-prone: roster files, casting state, agent folders, and Git merge configuration all need to be created consistently. This Skill guides the coordinator through a two-phase flow that proposes a team roster, waits for explicit user confirmation, and then creates the complete .squad/ directory structure. ## Core Features & Use Cases - Two-phase initialization: Phase 1 proposes a cast-named team roster and confirms it via an ask_user selectable menu; Phase 2 creates directories, casting state files, and seeded agent histories only after confirmation. - Casting and naming rules: Selects character names from a universe, keeps Scribe and Ralph exempt from casting, and initializes casting/policy.json, registry.json, and history.json. - Workflow-safe conventions: Enforces the exact ## Members header in team.md required by GitHub label automation, and configures union merge drivers in .gitattributes for append-only squad files. - Use Case: A developer starts a new TypeScript CLI project with no .squad/team.md; the coordinator asks what they are building, proposes a five-agent cast, and on confirmation scaffolds the full team structure with seeded context. ## Quick Start Ask the coordinator to initialize a new squad team for your project and confirm the proposed roster when prompted.

Frequently Asked Questions about init-mode

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

FAQPage Schema
How do I initialize a new squad team for my project?

Init Mode activates automatically when .squad/team.md is missing or has no members. The coordinator asks what you are building, proposes a cast roster, and creates the full .squad/ directory structure only after you confirm via the selection menu.

How does the squad casting and naming algorithm work?

The coordinator determines team size and assignment shape, derives resonance signals from the session, and selects a universe of character names. Scribe and Ralph are exempt from casting and always keep their fixed names.

Why must team.md use the exact ## Members header?

The header is hard-coded in GitHub workflows such as squad-heartbeat.yml and squad-triage.yml for label automation. Using a different title like Team Roster breaks label routing across the repository.

Can I change the proposed team roster before it is created?

Yes. Choosing Add someone or Change a role in the confirmation menu returns the flow to Phase 1 for re-proposal. No files or directories are created until you explicitly confirm the roster.

Why does init-mode avoid reading git user email?

Email addresses are PII and must not be written to committed files. The flow reads only git config user.name to personalize conversation and store the name in team.md Project Context.