Content
96%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.
An exceptionally well-crafted process skill: lean, jargon-free, with a 10-step workflow that bakes validation and feedback loops into every phase and delegates detail to clearly-signaled, real reference files at exactly the right steps. The single blemish is that two of the six referenced resources live outside the skill directory and cannot be verified from the bundle.
Suggestions
Make the out-of-bundle resources verifiable: either co-locate `writing.md` and `prose-lint.py` under the skill's own directory, or state in the references table what to do when they are absent (e.g., 'if missing, apply the rules from memory') so step 9 never dead-ends.
Add one line to the references table describing what `prose-lint.py` checks, so a reader can judge whether the lint output is fully addressed without opening the script.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~60-line body is lean with no re-teaching of concepts Claude already knows; even the framing lines ("A cheap experiment beats confident reasoning, and the source on `HEAD` beats memory") are compact behavioral rules, not padding. Every token earns its place, matching the 'lean and efficient; assumes Claude's competence' anchor rather than the score-4 anchor's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Per the instruction-only scoring note, guidance is thoroughly concrete: each step names its object and success criterion ("Classify each as Verified, Plausible, or Risky"; every command/tool/port "comes from a `file:line` in the repo, never from training data"; "Run `<plugin root>/scripts/prose-lint.py` on it"; "After about three rounds, surface that the problem needs reframing"), and the exact reference file to read is pinned to each step. There are no missing key details for a process skill of this genre, so it sits at the 'fully actionable' anchor rather than 'minor gaps'. | 5 / 5 |
Workflow Clarity | Ten numbered steps are clearly sequenced with explicit validation checkpoints and feedback loops: "A refuted assumption sends you back to step 2. Never patch around it", the loop-or-commit rule with a three-round reframing trigger at step 8, an evidence-based Definition of done that "sends you back to the step that produces it", and a gated step 10 requiring explicit approval for deviations. This matches the 'explicit validation steps; feedback loops for error recovery' anchor; score 4's 'minor validation gaps' does not apply. No destructive/batch-operation cap applies to a planning skill. | 5 / 5 |
Progressive Disclosure | The 'Required references' table (File / Read at / Holds) is exemplary one-level-deep navigation — better-signaled than the score-5 example — and all four `references/*.md` files exist and match their stated contents. However, two referenced paths (`../../assets/writing.md` and `<plugin root>/scripts/prose-lint.py`) do not resolve within the skill's bundle, so scored against the actual file listing plus referenced paths this is 'good structure ... minor organization gaps' rather than fully clean navigation. | 4 / 5 |
Total | 19 / 20 Passed |