skills.rest
codebytes
codebytesCOMMUNITY
Explore all skills by this author →
Website𝕏@chris_l_ayersGitHub

init-mode

Proposes and creates a confirmed AI team roster with .squad directory structure.

Updated Jun 2, 2026
Search Tags:#multi-agent#orchestration#roster#gitattributes#casting#github workflows#team initialization
One-click install
npx skills add https://github.com/codebytes/btt --skill init-mode-codebytes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init-mode
Source: https://github.com/codebytes/btt/tree/main/.squad/templates/skills/init-mode
Command: npx skills add https://github.com/codebytes/btt --skill init-mode-codebytes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a multi-agent AI team from scratch requires consistent structure, naming, and state files; this Skill guides a two-phase flow that proposes a cast roster and only creates the .squad/ directory after explicit user confirmation. ## Core Features & Use Cases - Two-Phase Initialization: Phase 1 proposes a cast team roster and waits for confirmation via an ask_user menu; Phase 2 creates the .squad/ structure, casting state, and seeded agent histories. - Casting & Naming: Selects character names from a universe (custom universes preferred) with Scribe and Ralph exempt from casting. - Workflow-Safe Structure: Enforces the exact ## Members header in team.md required by GitHub label-routing workflows, and configures union merge drivers in .gitattributes for append-only files. - Use Case: A developer starting a new TypeScript CLI project triggers Init Mode, confirms a proposed team of Lead, Frontend, Backend, and Tester agents, and gets a fully seeded .squad/ directory ready for task routing. ## Quick Start Ask the coordinator to set up 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 AI agent 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 via an ask_user menu, and creates the full .squad/ structure only after you confirm.

How does the casting algorithm assign agent names?▼

The coordinator derives resonance signals from the session and repo, selects a universe (preferring custom ones from .squad/templates/casting/), and allocates character names from it. Scribe and Ralph are exempt 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, squad-issue-assign.yml, and sync-squad-labels.yml for label automation. A differently titled header breaks label routing across the repository.

What happens if I ask to change the proposed team roster?▼

If you reply with 'add someone' or 'change a role', the coordinator returns to Phase 1 and re-proposes the roster. No files or directories are created until you give an explicit confirmation.

Does Init Mode store my git email address?▼

No. The flow reads only git config user.name for personalization and explicitly forbids reading or storing git config user.email, since email addresses are PII and must not be written to committed files.

Related Skills

Explore More Software Engineering Skills→
imbue-aiimbue-ai
401

triage-backlog

Convert informal engineering backlog notes into prioritized GitHub issues.

Official
Intermediate
githubnextgithubnext
5.1k

init-mode

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

Official
Intermediate
getzikragetzikra
8

Zikra — AI Persistent Memory

Store, search, and log project memories across AI sessions via ZIKRA_URL.

Official
Intermediate
bradygasterbradygaster
3.1k

squad

Scaffold AI agent teams in a project directory using a CLI.

Community
Advanced