Content
78%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-crafted instruction-only skill: the body lays out a coherent four-stage dialectic process with concrete interrogation questions, named revision options, per-genre guidance, and a clean boundary against sibling skills (page-writing, writing-voice). Its only gaps are minor — a few sentences could be tightened and a worked example of the dialectic would make the process fully concrete — and its single reference is real, relevant, and well signaled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — it never explains what an essay, narrative, or profile is, and the genre guidance ('look for tension, conflict, agency, change') is compressed rather than padded. A few discursive sentences could still be trimmed (e.g., 'Do not treat "show, don't tell"... as automatic verdicts' runs long), which matches anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is concrete: a bulleted interrogation list ('What has been shown through scene, action, image, voice, or consequence?'), specific revision moves ('keep the statement, replace it with a scene or detail, move it later, or cut it'), and per-genre directives. This is 'mostly executable guidance... with minor gaps' (anchor 4); it falls short of anchor 5 only because no worked example of the dialectic applied to a passage is provided. | 4 / 5 |
Workflow Clarity | The stages are clearly sequenced — start with the intended discovery, stage the collision, move through the dialectic, judge the language — and include an explicit checkpoint ('Let the writer react before treating a revision as settled'), matching anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'). It lacks the explicit validate-and-recover loop of anchor 5, though the 'Treat first-reader confusion as evidence to investigate' line gestures at one. | 4 / 5 |
Progressive Disclosure | The ~45-line overview is appropriately split: provenance material lives in references/source-map.md (verified to exist and contain the index/draft paths), signaled by a clearly conditional pointer ('Read [references/source-map.md]... when a task calls for the provenance of a principle, comparison with a particular English 120 reading, or locating an original assignment or draft'). This matches anchor 5: a clear overview with a well-signaled, one-level-deep reference. | 5 / 5 |
Total | 17 / 20 Passed |