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.
An exemplary instruction-only skill body: lean, decision-oriented, and well-structured, with a clear decision procedure, a validation checklist, and clean delegation of templates to real one-level-deep references. The only gap is that executable code lives entirely in the references and a few directives (e.g., port abstraction) remain abstract.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is pure decision policy with zero concept explanations ("Avoid mock-by-default", "Keep stubs configurable per scenario; do not build mini-systems") and assumes Claude already knows what fakes, stubs, spies, and mocks are. Every section instructs rather than teaches, matching the 'lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | Provides a concrete branchable decision tree, copy-ready naming patterns ("FakeXxxRepo", "FixedClockStub"), and numeric thresholds ("More than 2-3 interaction expectations"), but no inline executable code (templates are delegated to references) and "raise the abstraction of the port" is abstract direction without a how. This lands at 'mostly executable guidance with minor gaps' rather than fully copy-paste ready. | 4 / 5 |
Workflow Clarity | The 4-step decision tree is a clearly sequenced procedure with explicit yes/no branches, and the "Quick PR Smell Check" section is a validation checklist with error-recovery redirections (rename-breaks-test implies over-mocking; fake divergence implies a contract test is needed). Not a destructive or batch operation, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is an overview with a Quick Navigation TOC, and all template/detail content is split into three real, one-level-deep reference files (references/examples.md, references/usage.md, references/quick.md), each introduced with a descriptive pointer of its contents. This matches the 'clear overview with well-signaled one-level-deep references' anchor exactly. | 5 / 5 |
Total | 19 / 20 Passed |