Content
88%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |