Content
82%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-crafted, lean skill body: it leads with the stack and explicit not-X alternatives, gives per-test-type templates, preserves project-specific gotchas, and defers bulk detail to referenced rule files. The main gaps are placeholder-templated code (fine for a generation convention) and no explicit run-to-verify loop tying the Run section back into the writing workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is dense with project-specific knowledge and zero padding: naming conventions, mock patterns ("assert the specific token, not the default (NSubstitute fills optional params with default)"), and run commands. Nothing explains concepts Claude already knows; every token earns its place. | 5 / 5 |
Actionability | Concrete code templates for handler, validator, and entity tests plus executable run commands ("dotnet test src/Tests/{X}.Tests") cover the common cases. The {Entity}/{X} placeholders keep it from being copy-paste ready, but they are deliberate templates rather than pseudocode — mostly executable with minor gaps. | 4 / 5 |
Workflow Clarity | The body progresses logically by test type and ends with a Run section (unit, architecture, coverage) that functions as verification, plus an explicit guardrail ("Don't weaken these to make a change pass — fix the code"). It lacks an explicit write-then-run feedback loop statement, leaving minor validation gaps versus the 5 anchor. | 4 / 5 |
Progressive Disclosure | The body acts as an overview with clearly signaled one-level-deep pointers ("Detailed conventions + integration-test gotchas live in .agents/rules/testing.md and .agents/rules/integration-testing.md"), and bulk detail is appropriately split out of SKILL.md. The pointers use bare repo paths rather than linked bundle files and no bundle directory exists, so navigation is good but not fully polished. | 4 / 5 |
Total | 17 / 20 Passed |