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

85%

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

73%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.

The body is a well-sequenced, gated two-phase protocol with strong validation checkpoints and mostly concrete, executable instructions. Its weaknesses are token efficiency — redundant bullets, repeated phrases, and an over-dense governance paragraph — and content that could be moved into bundled reference files since none ship with the skill.

Suggestions

Collapse the four consecutive 'exempt from casting' bullets for Scribe, Ralph, Rai, and Fact Checker into a single line (e.g., 'Scribe, Ralph, Rai, and Fact Checker keep their fixed names — exempt from casting').

De-duplicate the casting-state initialization section: 'Initialization requires a genuinely empty new target' restates the opening of the preceding paragraph; merge them into one passage.

Move the 'Waza reviewer seeding override' governance rules and the reviewer-policy details into a bundled reference file (e.g., references/governance-seeding.md) and keep a two-line pointer in the body, which would also give the skill a real bundle structure for progressive disclosure.

DimensionReasoningScore

Conciseness

The protocol is mostly dense, project-specific guidance Claude would not already know, but there is real tightening to do: four consecutive bullets each restating 'exempt from casting' for Scribe/Ralph/Rai/Fact Checker (lines 25-28), the phrase 'genuinely empty new target' repeated across the casting-state paragraphs, and the verbose 'Waza reviewer seeding override' paragraph (lines 84-94) mixes several governance rules in long sentences. This fits the anchor for mostly-efficient-but-could-be-tightened rather than the minor-trims anchor at 4.

3 / 5

Actionability

Mostly executable guidance: exact command ('git config user.name'), the full directory structure list, a copy-paste .gitattributes block, exact ask_user choices ('["Yes, hire this team", "Add someone", "Change a role"]'), the exact '## Members' header requirement, and a concrete roster example. It stops short of fully copy-paste ready because the core casting step defers to '.squad/templates/casting-reference.md' and the Waza seeding paragraph includes abstract directions like 'require an equivalent atomic operation or stop'.

4 / 5

Workflow Clarity

The two phases are clearly sequenced with an explicit hard checkpoint ('⚠️ STOP. Your response ENDS here. Do NOT proceed to Phase 2'), a defined Phase 2 trigger, and a feedback loop for non-confirming replies ('If the user said "add someone" or "change a role," go back to Phase 1 step 3'). This matches the 5 anchor: explicit validation steps, error-recovery loops, and a checklist-shaped protocol.

5 / 5

Progressive Disclosure

Good structure: two clearly headed phases, numbered steps, and one-level-deep external references signaled with paths ('.squad/templates/casting-reference.md', 'Rai-charter.md', 'fact-checker-charter.md', '.squad/governance.md'). No bundle files ship with the skill, and the dense Waza seeding/governance paragraphs are inline content that arguably belongs in a separate reference file — a minor organization gap consistent with the 4 anchor rather than the 5 anchor's clean split.

4 / 5

Total

16

/

20

Passed

Description

92%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: third-person, explicit about both capability and trigger condition, with concrete file paths and named components. The only minor gap is a few missing natural synonym phrases a user might use when asking for team setup.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'propose the team (no files created, wait for user confirm)', 'create .squad/ scaffolding, casting state, .gitattributes for merge drivers, and the always-on built-ins (Scribe, Ralph, Rai, Fact Checker)' — comprehensively covering the skill's scope. It matches the anchor for comprehensive specific concrete actions; score 4 would require notable coverage gaps, which are absent.

5 / 5

Completeness

Both what and when are explicit: the 'what' is the two-phase protocol with each phase's actions spelled out, and the 'when' is 'Loaded on demand when the coordinator detects no .squad/team.md exists' — an explicit equivalent of a 'Use when...' clause. Score 4 would require the trigger to be less explicit; it is not.

5 / 5

Trigger Term Quality

Good keyword coverage: 'Init Mode', 'Squad coordinator', 'no team exists yet', '.squad/team.md', 'propose the team', and the built-in names are natural terms for this domain, including a concrete file path. It falls short of the 5 anchor because common variations like 'team setup', 'squadify', or 'new repo onboarding' are not present.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Squad Init Mode for repos with no existing team) with a distinct state-based trigger ('no .squad/team.md exists') and named built-ins, minimizing overlap with other skills. It matches the 5 anchor for a clear niche with distinct triggers.

5 / 5

Total

19

/

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

microsoft/waza

Path

.github/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.