Content
88%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.
An exemplary operational skill body: concrete, executable, and project-specific, with a well-gated three-phase workflow and thorough verification loops. The only deductions are minor verbosity in anecdotal passages and a small navigation gap — an orphaned bundle file (simple-english-checklist.md) and inlined noun lists that fit the established reference-file pattern.
Suggestions
Reference references/simple-english-checklist.md from the body (e.g., in the Read-first list or the self-check step) so it is discoverable, or remove it.
Move the two legal-technical-noun lists into a vocabulary reference file and link them, matching the pattern the groups establish.
Trim the war-story in the trap section to the rule it evidences (grep misses some; run the suites) to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and project-specific throughout — classification tables, word limits, and exact file paths with almost no explanation of concepts Claude already knows. Minor trimmable padding exists: the anecdote in the trap section ("One pass found them in two rounds. A grep found five...") and a few justification asides ("Consequences worth knowing") keep it at the 4 anchor rather than 5. | 4 / 5 |
Actionability | Fully executable guidance: exact diff command ("git diff <base>" with the explicit anti-pattern), a runnable AST-comparison snippet, concrete grep patterns ("match=", "in str(exc", "in str(reject"), make targets, line-length and word-count limits, and a per-group file map. Copy-paste-ready with specific examples covering the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | A clear three-phase workflow (Audit → Apply → Verify) with an explicit hard checkpoint ("Stop. Wait for approval."), a two-phase apply split with rationale, and five concrete verification steps including feedback loops ("Explain every file that appears", "Run the suites anyway. The grep is a head start, not the check"). This matches the 5 anchor's explicit validation steps and error-recovery loops; batch-edit operations with real verification cannot score higher. | 5 / 5 |
Progressive Disclosure | Structure is excellent: the 53 STE rules, use cases, and all nine vocabulary groups plus adding-terms live one level deep in references/ and every referenced file exists, with a table indexing exactly when to read each group. Two minor gaps keep it at 4: references/simple-english-checklist.md exists in the bundle but is never referenced from the body, and the cross-group legal-noun lists are inlined in SKILL.md where the pattern established elsewhere would put them in a reference file. | 4 / 5 |
Total | 18 / 20 Passed |