Content
92%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-structured instruction-only skill: concrete brief specification, clear activation heuristics with a decision tiebreaker, and thoughtful guardrails against brief prose leaking into drafts. The single improvement would be showing one worked example of a pull-quotable fact with its attribution.
Suggestions
Add a one-line worked example of a pull-quotable fact with its attribution (a number, date, or verbatim quote plus a link) so the fact format in section 4 is unambiguous.
Show what one 'positions' entry looks like (position — named holder — where the author's likely take sits) to make section 1 fully executable without interpretation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | A lean ~50-line body with no filler: every line adds project-specific guidance Claude could not infer (skip heuristics, brief structure, 'Never write "some argue."', source-handling rules). Nothing explains concepts Claude already knows, and nothing could be cut without losing information. | 5 / 5 |
Actionability | The brief spec is concrete and executable — 'Two or three live positions, each tied to named people', '3 to 5, each with a source', 'If a fact has no source, leave it out', and a specified save location — but no worked example of a position line or a sourced fact is shown. Anchor 5's 'specific examples cover the common cases' is unmet, so this fits anchor 4's 'minor gaps'. | 4 / 5 |
Workflow Clarity | A simple single-purpose skill whose action is unambiguous: an explicit run/skip decision with a tiebreaker question ('is this one you lived, or one you watched?'), a four-part deliverable spec, and a defined save-and-note step. No destructive or batch operations exist, so no validation checkpoints are required, and the simple-skill exception applies. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no need for external references, and no bundle files exist to manage. The body is organized into clear sections (Run it or skip it / The brief / Rules), which the rubric's simple-skill guideline explicitly credits as a 5. | 5 / 5 |
Total | 19 / 20 Passed |