Content
92%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 well-built reference skill: a complete, unambiguous file-by-file permission table backed by four explicit precedence and enforcement rules, with no filler and no assumed-knowledge explanations. The single weak point is the opening 'Load this skill when' blockquote, which partially duplicates the frontmatter description and could be trimmed for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — the 19-row hierarchy table carries information in every cell, the 4 rules are each one to two sentences, and nothing explains concepts Claude already knows. The one trimmable block is the opening quote ("Load this skill when: ... when about to write `.squad/decisions.md`, when reviewing whether an agent broke the append-only rule ..."), which largely restates the frontmatter description, though it adds routing context about `squad.agent.md`. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than the level-5 'every token earns its place' anchor. | 4 / 5 |
Actionability | For an instruction/reference skill the guidance is fully concrete: exact file paths (`.squad/decisions.md`, `.squad/agents/{name}/history.md`), per-file write/read assignments, explicit precedence ("If `squad.agent.md` and any other file conflict, `squad.agent.md` wins"), a concrete correction procedure ("Corrections go in a new entry that references the prior one"), and named runtime tools (`squad_state_read`, `squad_state_append`, ...). A coordinator can resolve any ownership or write-permission question directly from this content with no gaps; per the rubric's code-vs-instruction note, the absence of code is not penalized. | 5 / 5 |
Workflow Clarity | This is a single-task lookup/ adjudication skill with no multi-step build or destructive batch process, so the simple-skill exception applies: the single action (locate the file in the hierarchy table, apply the precedence and permission rules) is unambiguous. Conflicts have an explicit resolution rule (squad.agent.md wins; append-only files never retro-edited; violations are contract bugs refused by non-local backends). Not level 4 because there are no gaps — the rules section fully covers the conflict, correction, and enforcement cases the skill exists for. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so there are no broken or nested references to check. The body is ~35 lines — under the 50-line threshold — and is organized into well-labeled sections ('State backend note', 'File hierarchy', 'Rules') with the state-backend distinction clearly flagged up front. Per the rubric's under-50-lines guideline, well-organized sections with no need for external references score 5. | 5 / 5 |
Total | 19 / 20 Passed |