Content
52%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 well-organized routing doctrine with a clear workflow, a concrete checklist, and an unusually disciplined deferral of detail to reference files — but the referenced files do not exist, so the skill's actual substance is unreachable. Combined with significant repetition across the four routing sections, the skill reads as the skeleton of a strong artifact missing its meat.
Suggestions
Ship the six referenced ./rules/*.md files (laws, decision-ladder, performance-selection-rules, update-policy, pattern-catalog, anti-patterns) or inline their essential rules — every 'Run the...' workflow step currently dead-ends.
Collapse the overlapping routing sections ('Use When', 'Do Not Use When', 'Hard Routing Rule', 'Routing Matrix', 'Who Owns What') into the Routing Matrix plus one short do-not-use list; they restate the same decision three to four times.
Cut or rewrite 'Best Mix' (it lists ProseMirror/Lexical/Portable Text with one-line glosses whose actionable meaning is unclear) and trim 'Final Law', which is rhetorical restatement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight doctrine language with no education of concepts Claude already knows, but it restates the same routing decision three to four times ('Use When', 'Do Not Use When', 'Hard Routing Rule', 'Routing Matrix', 'Who Owns What'), and the 'Best Mix' and 'Final Law' sections are cryptic or rhetorical padding. That is 'some unnecessary explanation / could be tightened' rather than the several padded sections of a 2. | 3 / 5 |
Actionability | The matcher-extraction heuristic, reaffirmation strings ('north-star reaffirmed: laws'), and binary review checklist are genuinely concrete, instruction-only guidance. But the workflow's substance is delegated to six ./rules/*.md files ('Run the decision ladder', 'Check the pattern catalog') that do not exist in the bundle, so key executable detail is missing rather than merely incomplete in the way anchor 4's 'minor gaps' implies. | 3 / 5 |
Workflow Clarity | An 8-step numbered workflow gives a clear sequence with the binary review checklist and the reaffirmation contract acting as explicit checkpoints. Not 5 because there is no error-recovery guidance (what to do when two ladder rungs conflict, or when a pattern matches both core and feature ownership) and because half the steps resolve to missing files. | 4 / 5 |
Progressive Disclosure | The body correctly defers detail to one-level-deep, clearly labeled references (Constitutional Layer, Pattern Layer, workflow steps), which is the right structure — but all six referenced files (laws.md, decision-ladder.md, performance-selection-rules.md, update-policy.md, pattern-catalog.md, anti-patterns.md) are absent from the bundle, so every deep link is broken and navigation dead-ends. That is broken navigation, not the minor organization gaps of a 4 or the merely 'not clearly signaled' references of a 3. | 2 / 5 |
Total | 12 / 20 Passed |