CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

67

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

A highly actionable, well-sequenced protocol with strong workflow checkpoints and concrete examples. The main gaps are minor redundancy that could be tightened and the lack of any progressive-disclosure bundle structure for a skill of this length.

Suggestions

Collapse the four "exempt from casting" bullets for Scribe/Ralph/Rai/Fact Checker into a single line to remove redundancy.

Tighten or relocate the explanatory merge-driver paragraph ("The `union` merge driver keeps all lines...") into a short comment or a reference file, keeping only the actionable .gitattributes block inline.

Consider extracting the Casting & Persistent Naming algorithm detail (referenced via `.squad/templates/casting-reference.md`) into a bundled reference file under references/ so the SKILL.md body stays an overview with one-level-deep navigation.

DimensionReasoningScore

Conciseness

Mostly efficient instructional prose with concrete specifics, but contains redundancy: four separate "exempt from casting" bullets for Scribe/Ralph/Rai/Fact Checker that could be one line, the roster shown as an example and then re-referenced verbatim for the confirm question, and explanatory padding like the merge-driver paragraph. Not level 3 because of this padding; not level 1 because it does not explain concepts Claude already knows and is largely actionable.

2 / 3

Actionability

Provides fully concrete, copy-paste-ready guidance: `git config user.name`, exact directory structure, a complete `.gitattributes` block, a roster example, and an exact ask_user question shape with literal choices. Matches the level-3 anchor of executable/specific copy-paste guidance; not level 2 because nothing is left as pseudocode or vague direction.

3 / 3

Workflow Clarity

Two-phase flow is clearly sequenced (Phase 1 steps 1-5, an explicit "⚠️ STOP...Wait for the user's reply" validation checkpoint, Phase 2 steps 6-8) with a feedback loop for "add someone/change a role" that routes back to Phase 1. Matches the level-3 anchor of clear sequence with explicit validation and error-recovery feedback; not level 2 because the confirmation gate is explicit and emphasized rather than implicit.

3 / 3

Progressive Disclosure

Content is well-organized into Phase 1/Phase 2 sections, but the skill is monolithic (~90 lines, over the 50-line simple-skill threshold) with no bundle files in references/scripts/assets. External paths it cites (`.squad/templates/casting-reference.md`, charter/policy templates, `squad.agent.md`) are operational runtime targets, not navigational references into a bundled reference tree. Not level 3 because there is no one-level-deep reference structure to navigate; not level 1 because sections are clearly organized and references are not deeply nested.

2 / 3

Total

10

/

12

Passed

Description

85%

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, specific description that clearly conveys both the two-phase behavior and the precise load condition. Its only weakness is that the trigger terms are internal/technical rather than natural user language, which is somewhat inherent to a coordinator-internal skill.

Suggestions

Consider adding at least one user-natural trigger phrase alongside the technical condition (e.g., "Use when squadifying a fresh repo or setting up a new Squad team") so the trigger reads naturally rather than only as coordinator-internal jargon.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: "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)". Matches the level-3 anchor of multiple specific concrete actions; not level 2 because it goes beyond naming a domain to enumerating concrete setup actions.

3 / 3

Completeness

Explicitly answers both what ("two-phase Init Mode protocol...Phase 1 = propose...Phase 2 = create .squad/ scaffolding...") and when ("Loaded on demand when the coordinator detects no .squad/team.md exists"). Matches the level-3 anchor answering both what and when with explicit triggers; not level 2 because the when is explicit, not merely implied.

3 / 3

Trigger Term Quality

States a clear trigger condition ("when no team exists yet in the current repo", "when the coordinator detects no .squad/team.md exists") but the terms are technical jargon ("Init Mode protocol", ".squad/team.md") rather than language a user would naturally say. Not level 3 because it lacks natural user phrasing; not level 1 because it does specify a concrete, relevant detectable trigger rather than being purely generic.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear narrow niche (Squad init mode) with a distinct system-state trigger (no .squad/team.md) unlikely to fire for unrelated skills. Matches the level-3 anchor of a clear niche with distinct triggers; not level 2 because the trigger is highly specific rather than a broad overlap risk.

3 / 3

Total

11

/

12

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.

Validation15 / 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
bradygaster/squad
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.