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-structured, judgment-heavy editing skill: the body stays a routing and stance layer, defers the smell catalogs to one-level-deep references that all exist, and anchors the workflow with an executable, verified punctuation gate and explicit done-when criteria. The only real cost is mild redundancy and a few overlong compound sentences.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational rule-content with no concept-explaining padding ("Over-editing is failure, equal to under-editing", "Most polish is subtraction"), but a few rules are restated across sections (the author's-own-draft per-sentence list appears in Core Stance and again in Output) and several bullets are overlong compound sentences (the "A piece has a speaker" bullet) that could be trimmed. | 4 / 5 |
Actionability | The Mode Picker routes each ask to a named file ("Contains Chinese characters (default prose) loads `references/write-zh.md`"), the Punctuation Gate block is executable after one explicitly documented substitution ("Replace `<skill-base-dir>` with the installed Write skill or Waza dispatcher directory"), and the gate script exists in scripts/ and passes a smoke test; the Gotchas table maps concrete observed failures to concrete rules. | 5 / 5 |
Workflow Clarity | The sequence is clear (Pre-flight 1-2-3, Mode Picker, mode procedures, Hard Rules, Punctuation Gate, Output contract with explicit "Done when" criteria) and validation is explicit and mandatory ("Before returning any produced text ... resolve the checker across install layouts and run it", "Fix every finding while preserving meaning"), with feedback loops in Gotchas ("Re-review the fix diff itself"), a Document Review checklist, and batch-edit reconciliation; the batch-operation validation cap does not trigger because validation is present. | 5 / 5 |
Progressive Disclosure | SKILL.md is a routing hub whose every referenced path resolves in the bundle (all 10 references/*.md files plus scripts/check-punctuation.sh verified present), references are one level deep with only well-signaled lateral sibling pointers (e.g., write-technical.md -> write-product-localization.md), and each mode row names exactly which file to load and when. | 5 / 5 |
Total | 19 / 20 Passed |