Content
68%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, disciplined style standard that shows rather than tells: nearly every rule ships with a before/after phrase pair and a real-symbol worked example. Its weaknesses are process-shaped, not content-shaped — no explicit application order beyond mode-first and no verification pass for the review workflow it explicitly claims.
Suggestions
Add an explicit application sequence for reviewing (e.g., mode check → structure → sentence-level layers → rhythm), plus a final verification pass such as re-reading the doc once against the three meta-rules before returning it.
Add one short worked example per Diátaxis mode (a tutorial paragraph and a reference paragraph), mirroring the existing reference-style example, so the mode rules are demonstrated rather than only stated.
Deduplicate rules that appear in multiple layers — passive voice and one-word-per-action each appear in two sections — and cross-reference the other section instead, tightening the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive, with nearly every rule carrying an inline before/after pair ("'In order to' is 'to'"), but rules repeat across sections — passive voice appears in both the Google section and the STE section, and one-word-per-action appears in both STE ("Pick one word per action and stick to it") and Global English ("Call each thing by one name, everywhere"). This matches anchor 4 (efficient with minor instances that could be trimmed) rather than 5, since the duplication means not every token earns its place. | 4 / 5 |
Actionability | Guidance is highly concrete: paired replacements throughout ("Use", not "utilize"; "a column rename fails the build"), a two-question mode-selection procedure, and a worked example with real symbols (`budget.mjs`, `budget.json`, `--write`). It falls just short of anchor 5 because examples do not cover all common cases — only one worked example is given, with no sample tutorial/how-to restructuring. | 4 / 5 |
Workflow Clarity | Only "Pick the mode first (Diátaxis)" establishes an application order; the sequence for the remaining layers is implicit and no verification checkpoint exists for the reviewing side of the skill (e.g., a final pass checking the doc against each layer). This matches anchor 3 (steps listed but checkpoints missing or implicit) rather than 4, which requires most checkpoints present. | 3 / 5 |
Progressive Disclosure | No bundle files exist, so all content lives in one well-sectioned ~100-line SKILL.md with clear headers ("Pick the mode first (Diátaxis)", "Worked example") and easy in-file navigation. This matches anchor 4 (good structure, minor organization gaps) — the per-mode paragraphs could split into reference files and the "Vary the rhythm" section sits oddly before mode-picking — and the under-50-line simple-skill exception to reach 5 does not apply at this length. | 4 / 5 |
Total | 15 / 20 Passed |