Content
82%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.
The body is a strong, well-structured instruction skill: every pattern is grounded in concrete project invariants, the examples demonstrate real decisions, and the output format is fully specified. The only gaps are minor — a couple of statements restating common knowledge, no explicit ordering across the eight checks, and everything inlined in a single long file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and almost every token carries project-specific knowledge Claude cannot know (the protected-file table, dependency direction rules, template locations, the .squad/ leakage policy), with no padding of generic concepts. It sits at 4 rather than 5 because of minor trimmable over-explanation, e.g. 'Barrel files define the public API of a package' and 'Removing an export is a breaking change', which restate things Claude already knows. | 4 / 5 |
Actionability | Guidance is fully concrete and executable: exact file paths in the protected-files table, the literal dependency direction to check ('squad-cli → depends on → squad-sdk'), a 5-step sweeping-refactor checklist with the exact marker string to scan for ('— zero dependencies'), five worked review examples with verdicts and recommendations, and a copy-paste output format template. This matches the top anchor of specific examples covering the common cases; as an instruction-only skill, absence of runnable code is not penalized. | 5 / 5 |
Workflow Clarity | The eight patterns are each framed as explicit checklists ('Check every new import statement'), the sweeping-refactor pattern has a sequenced 5-step verification checklist, the examples demonstrate the reject/approve decision loop, and the Review Output Format section specifies verdicts, severities, and required fields. It does not reach 5 because there is no explicit ordering or triage flow connecting the eight checks into a single review pass (which check runs when, and what to do first when a PR matches several patterns). | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/ directories), and the body is organized into well-labeled sections (Context, Patterns 1–8, Examples, Review Output Format, Anti-Patterns) with the one cross-reference — 'see architectural-proposals/SKILL.md' — clearly signaled and one level deep. It stays at 4 rather than 5 because the ~200-line body inlines everything, including the examples block and the protected-files table, some of which could be split into a reference file to keep the main file a leaner overview. | 4 / 5 |
Total | 17 / 20 Passed |