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-structured, lean instruction skill that points cleanly to three real reference files and includes a scoring feedback loop. Main gaps are mild redundancy between Core Rules and Quick Checks and an implicit rather than explicit workflow sequence.
Suggestions
Collapse or cross-reference Quick Checks against Core Rules to remove the restated adverb/passive/em-dash items and tighten token efficiency.
Make the workflow explicit with a short numbered sequence (apply rules → run Quick Checks → score each dimension → revise if <35/50) so the feedback loop is unambiguous.
Inline one or two complete before/after transformations in the Examples section rather than only linking out, so the core action is fully demonstrated without a file hop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, but the Quick Checks section restates the Core Rules (e.g. "Any adverbs? Kill them" reprises rule 1, "Em dash anywhere? Remove it" reprises rule 6), a minor redundancy that could be trimmed, placing it just below the 5 anchor. | 4 / 5 |
Actionability | Concrete, specific guidance with inline anti-pattern examples ("the complaint becomes a fix", "The implications are significant") and a pre-delivery checklist; not a 5 because full before/after transformations live only in examples.md rather than inline, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The Quick Checks checklist plus the Scoring gate ("Below 35/50: revise") form an implicit apply → check → score → revise feedback loop, but the sequence is never numbered or explicitly tied together, so it sits at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The body is a concise overview with well-signaled, one-level-deep references to phrases.md, structures.md, and examples.md (all verified to exist), matching the anchor for clear overview with appropriately split content. | 5 / 5 |
Total | 17 / 20 Passed |