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 well-built instruction-only skill body: actionable contrast examples with quantified rules, a numbered editing workflow with an explicit self-check checklist and a rewrite-before-returning feedback gate, and clean one-level-deep reference offloading with clear when-to-use signals. The only improvement opportunity is trimming the overlap between the Anti-patterns section and the Self-check checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Efficient throughout: no explaining of concepts Claude already knows, dense with specific rules ("at most once per 500 words", "Ranges as '£1.50 to £3.00'"). Not a 5 because the Self-check section restates roughly eight items already covered in 'Anti-patterns: the AI tells' (em-dashes, pivots, 'the takeaway is', corporate-speak, closing synthesis), which is functional duplication that could be tightened or cross-referenced. | 4 / 5 |
Actionability | Concrete, executable guidance with paired before/after examples throughout: "'In my view, Lambda memory is the wrong place to look for cost savings' beats 'Lambda memory might potentially not be the right place to look'", "'The pipeline costs £1.50 to £3.00 a week, 95% of it the LLM API' is senior prose", and explicit rewrite prescriptions ("Rewrite as one flat sentence stating Z, or one sentence with the contrast inline"). For an instruction-only skill this is copy-paste-ready direction covering the common cases. | 5 / 5 |
Workflow Clarity | The editing workflow is a clear 5-step sequence ("1. Structural read first... 2. Name the shape... 3. Rewrite the opening first... 4. Edit the body, then run the self-check below. 5. Return the edited draft...") culminating in an explicit validation checklist grouped by Structure/Voice/Substance with a feedback gate: "If three or more checks fail, rewrite before returning." This is an explicit validation step plus a fix-and-retry loop. The only soft spot is that drafting-from-scratch is not given its own numbered sequence, but input gathering ("ask for one sample before starting") and the self-check cover it. | 5 / 5 |
Progressive Disclosure | The 'Read first' section signals exactly when and in what priority to use each of three one-level-deep references: "references/exemplar-annotated.md: one before-and-after passage... The highest-signal calibration in the skill", "references/shapes.md when picking the structural shape for a post", "references/writers.md when you need to argue from a specific writer's move". All three files exist, contain substantive content, and do not chain into deeper references (the single cross-link in writers.md points to a sibling file). | 5 / 5 |
Total | 19 / 20 Passed |