CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coordinator-init-mode

The complete two-phase Init Mode protocol the Squad coordinator runs when no team exists yet in the current repo. Phase 1 = propose the team (no files created, wait for user confirm). Phase 2 = create .squad/ scaffolding, casting state, .gitattributes for merge drivers, and the always-on built-ins (Scribe, Ralph, Rai, Fact Checker). Loaded on demand when the coordinator detects no .squad/team.md exists.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tightly written, highly executable two-phase protocol: exact commands, verbatim prompts, exact file structures, an emphatic confirmation gate, and an explicit re-propose feedback loop. The only weaknesses are mild — repeated phase-gate emphasis that could be consolidated, and external references (casting algorithm, charters, templates) that are clearly signaled but not bundled or summarized.

DimensionReasoningScore

Conciseness

Mostly lean, imperative instruction with no explanation of concepts Claude already knows, but the phase-gate is stated three times ("⚠️ Eager-execution exception... Do not bypass", "⚠️ STOP. Your response ENDS here. Do NOT proceed to Phase 2", "Do NOT enter Phase 2 until the user confirms") and the four built-ins are re-enumerated in the roster, the confirmation requirement, and the casting exemptions. Not 5 because that duplicated emphasis could be trimmed; not 3 because there is no padding or over-explanation beyond the deliberate repetition.

4 / 5

Actionability

Fully executable throughout: "Run `git config user.name`", a copy-paste-ready .gitattributes block, exact dialogue scripts with choices (`["Yes, hire this team", "Add someone", "Change a role"]`), exact structural requirements ("a section titled exactly `## Members`"), and concrete registry fields ("persistent_name, universe, created_at, legacy_named: false, status: \"active\""). Not 4: virtually every step carries executable specifics — commands, exact file lists, or verbatim text to emit.

5 / 5

Workflow Clarity

Clear two-phase sequence with numbered steps, an explicit validation checkpoint ("⚠️ STOP. Your response ENDS here... Wait for the user's reply"), an explicit Phase 2 trigger ("The user replied to Phase 1 with confirmation... OR the user's reply to Phase 1 is a task"), and a feedback loop for error recovery ("If the user said 'add someone' or 'change a role,' go back to Phase 1 step 3 and re-propose"). The file-creation step is gated by user confirmation, so the destructive-operation cap does not apply. Not 4: checkpoints and recovery loops are explicit, not implicit.

5 / 5

Progressive Disclosure

Well-organized single-file protocol with clear phase sections, and its external references ("the canonical Casting reference at `.squad/templates/casting-reference.md`", "their dedicated sections in `squad.agent.md`") are clearly signaled and one level deep. Not 5: no bundle files exist, and the referenced casting/template material lives outside the skill without a bundled copy or in-skill summary, leaving navigation to rely on repo state the skill does not guarantee exists.

4 / 5

Total

18

/

20

Passed

Description

85%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly states both what the skill does (the two-phase Init Mode protocol with its concrete deliverables) and when to load it (no .squad/team.md exists), in third person with minimal conflict risk. The main weakness is trigger-term naturalness: it leans on internal squad jargon rather than phrases a user would naturally say when they need team initialization.

Suggestions

Add natural user phrasings such as "set up a new squad", "create a team for this repo", or "initialize the squad" alongside the technical file-state trigger so utterance-based matching also works.

Pair internal jargon with user-facing equivalents, e.g. "casting state" → "persistent agent naming", "merge drivers" → "conflict-free merging of squad state across branches".

Surface the "fresh repo" / "repo that has never been squadified" signal as an explicit trigger synonym, since users describe the situation in those terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions across both phases — "propose the team (no files created, wait for user confirm)" and "create .squad/ scaffolding, casting state, .gitattributes for merge drivers, and the always-on built-ins (Scribe, Ralph, Rai, Fact Checker)" — comprehensively covering the protocol's deliverables in third-person voice. Not 4: the enumeration of both phases' concrete outputs leaves no minor gaps in coverage.

5 / 5

Completeness

Explicitly answers both questions: what ("The complete two-phase Init Mode protocol... Phase 1 = propose the team... Phase 2 = create .squad/ scaffolding...") and when ("Loaded on demand when the coordinator detects no .squad/team.md exists") with a concrete trigger condition. Not 4: the when-clause is explicit and state-based rather than merely present but vague, matching the anchor-5 pattern.

5 / 5

Trigger Term Quality

Includes some relevant trigger phrases ("Init Mode", "when no team exists yet in the current repo", "when the coordinator detects no .squad/team.md exists") but is dominated by internal jargon ("Squad coordinator", "casting state", "merge drivers") and misses natural user variations like "set up a squad", "create a team", or "new squad". Not 4 because natural user-phrase coverage is thin; not 2 because usable natural terms like "no team exists yet" and "propose the team" are present.

3 / 5

Distinctiveness Conflict Risk

Occupies a clear niche with distinct, state-based triggers — "no team exists yet in the current repo", "no .squad/team.md exists" — plus protocol-specific names ("Scribe, Ralph, Rai, Fact Checker") that no other skill would match. Not 4: overlap risk is essentially nil because the trigger condition is uniquely specific to this protocol.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

github/gh-aw

Path

.squad/templates/skills/coordinator-init-mode/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.