Content
85%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 skill: terse rules with inline counter-examples, an explicit pre-delivery checklist, a quantified revise threshold, and clean one-level-deep references. Its only slack is mild duplication between Core Rules and Quick Checks, and a couple of rules that lean abstract.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence ("No passive constructions. No inanimate objects performing human actions"), with no explanations of known concepts; the Quick Checks section restates several Core Rules (adverbs, passive voice, em dashes, vague declaratives), which is trimmable duplication. | 4 / 5 |
Actionability | Guidance is mostly executable for an instruction-only skill: named patterns with inline examples ("the complaint becomes a fix", "The reasons are structural"), a concrete pre-delivery checklist, and a scoring threshold; a few rules like "Trust readers" and "Cut quotables" remain abstract, and worked before/after transformations live only in the reference file. | 4 / 5 |
Workflow Clarity | This single-task skill has an unambiguous action plus explicit validation: the Quick Checks run "Before delivering prose" and the Scoring section defines a feedback loop ("Rate 1-10 on each dimension... Below 35/50: revise"). The simple-skill exception applies and the validation/checklist requirements for a 5 are met. | 5 / 5 |
Progressive Disclosure | The ~60-line overview is well organized with clear sections, and all three references (phrases.md, structures.md, examples.md) are real files, one level deep, clearly signaled with markdown links, holding the bulk detail (128/134/59 lines) appropriately out of the main file. | 5 / 5 |
Total | 18 / 20 Passed |