Content
75%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 disciplined, well-structured meta-skill: no teaching of known concepts, explicit mode routing to real one-level-deep references, per-mode done conditions, and mandated validation. Its weaknesses are density and altitude — several rules compress three ideas into one fused sentence (ironically against its own plain-sentence rule), and some inline rule detail belongs in the references it already points to.
Suggestions
Apply the skill's own plain-sentence rule to its longest rules: split the description-authoring rule and the completion-report paragraph (each packs 3+ rules into one sentence with fused clauses) into one idea per sentence so they survive a single careful read.
Move topic-specific detail — the Sol/Fable portability rule and the description-authoring rule's example enumeration — into a reference linked at their point of use, keeping the always-loaded rules to the condition each rule states.
Inline one compact worked example of the review output (a Change finding with its condition, and a two-line completion report) so the report shape and finding classes are executable rather than only described.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body wastes nothing on concepts Claude already knows — there is no definition-stuffing, no library tutorials, no padded rationale; every line is a rule or a routing instruction. It sits at anchor 4 rather than 5 because several rules are packed to the edge of comprehension (e.g., the 100+ word description-authoring rule and the fused clauses in the sediment and completion-report rules), which is tightening room rather than over-explanation, so it does not drop to 3. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is largely executable: the mode table gives read-this-reference, done-when triples for all four modes, and the completion report prescribes a concrete per-mode output shape. It falls short of anchor 5 because the "Rules that hold in every mode" section is largely principle statements ("Conditions, not cases", "Sediment first") whose application steps live in the references rather than here, and no worked example of a finding, verdict, or report is given inline. | 4 / 5 |
Workflow Clarity | The sequence is clear and gated: read the standard first, apply the cross-mode rules, pick a mode from the request, each mode carries an explicit done condition, and validation is mandated per risk ("the eval ran or its exact skip reason is recorded") with a completion report closing every mode. It does not reach anchor 5 because the validation loop itself (run eval, read failures, fix, re-run) is referenced via `references/evaluate.md` rather than sequenced here, and the mode chaining path ("a review that becomes an edit") is mentioned but not walked through. | 4 / 5 |
Progressive Disclosure | The body routes by mode to five real one-level-deep bundle files (all of `references/new-skill.md`, `edit-skill.md`, `review-skill.md`, `respond-to-review.md`, and `evaluate.md` exist and are named at their point of use), with a single external authority document. It holds at 4 rather than 5 because the cross-mode rules section carries substantial inline detail — notably the description-authoring rule and the Sol/Fable portability rule — that reads as mode- or topic-specific material which could live in a reference, keeping the overview thicker than a clean index-and-signpost split. | 4 / 5 |
Total | 16 / 20 Passed |