Content
71%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 tight, well-organized behavioral skill: concise, third-person-adjacent directives with concrete example phrasings and explicit decision criteria, and no concept padding. Its main defect is structural — both format references point at files absent from the bundle, so the promised detailed guidance is unreachable.
Suggestions
Add the referenced CONTEXT-FORMAT.md and ADR-FORMAT.md to the bundle (or inline the essential entry/ADR templates), since both links currently dangle and the skill depends on them for the exact formats.
Tighten progressive_disclosure by either shipping the format files under references/ with matching link paths or inlining a minimal example entry so the skill is self-contained.
Trim secondary tokens (the parenthetical contrast with 'merely reading CONTEXT.md' and one of the two ASCII layout trees) to push conciseness to the top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive — terse sections ("Challenge against the glossary", "Offer ADRs sparingly") with example phrasings and two compact file-layout trees, assuming Claude's competence throughout. A few tokens could be trimmed (the parenthetical contrasting with merely reading CONTEXT.md, and the two ASCII trees), so it sits just below the 'every token earns its place' 5 anchor and clearly above the 'some unnecessary explanation' 3 anchor. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is highly actionable: verbatim challenge phrasings ("Your glossary defines 'cancellation' as X... Which is it?"), three explicit numbered ADR criteria, and lazy-creation rules for files. It loses a point because the actual formats are delegated to CONTEXT-FORMAT.md and ADR-FORMAT.md, which are not in the bundle — so a key executable detail (the entry format) is unavailable — leaving minor gaps rather than fully complete guidance. | 4 / 5 |
Workflow Clarity | The organization is clear and unambiguous: file-structure rules up front, then five concrete session behaviors each with an exact trigger and response, plus an explicit decision gate for ADRs (all three criteria or skip). No destructive or batch operations exist, so no validation cap applies; it is not a 5 because the sections are parallel heuristics rather than an explicitly sequenced process with checkpoints. | 4 / 5 |
Progressive Disclosure | The body itself is well-sectioned and the two references are clearly signaled one level deep ([CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md), [ADR-FORMAT.md](./ADR-FORMAT.md)), but the bundle contains no such files and no references/ directory — both links are dangling, so the disclosed detail is actually missing. Scored against the actual bundle structure this is a real organization defect, placing it at 'some structure but could be better organized' (3) rather than the 'appropriately placed' 4 anchor. | 3 / 5 |
Total | 15 / 20 Passed |