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.
An exceptionally dense, expert-level instruction skill: every token delivers non-obvious repository-specific rules, the regression-test workflow has genuine validation checkpoints, and external detail is correctly deferred to repo docs. Remaining gaps are minor — a concrete test-run command, an example snippet, and light grouping of the bullet conventions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries repo-specific knowledge Claude cannot infer ("asyncio_mode = \"auto\" is configured globally", "pythonpath in pyproject shadows PYTHONPATH", "The default timeout is five seconds"), with no padding or explanation of known concepts. It is lean and fully assumes Claude's competence. | 5 / 5 |
Actionability | Guidance names exact APIs and procedures ("Use `Client(server)` for real MCP dispatch", "capture the outgoing request with `httpx2.MockTransport`") and is actionable despite having no code, which the rubric does not penalize for instruction-only skills. Minor gaps: no example test snippet and no concrete command for running the tests. | 4 / 5 |
Workflow Clarity | The workflow is clearly sequenced (read existing tests/guide first, place the test, "run the regression against unchanged code and confirm it fails for the reported reason, then run it with the fix", run checks before committing) with explicit validation and error-recovery guidance ("reproduce it on the unchanged base"). The sequence lives in prose rather than an explicit ordered checklist, a minor gap versus anchor 5. | 4 / 5 |
Progressive Disclosure | At 26 lines with no bundle files, the skill appropriately keeps everything inline and clearly signals external repo docs ("[testing guide](../../../docs/development/tests.mdx)", "Follow AGENTS.md"). The flat bullet list mixes setup conventions with assertion guidance where light grouping would help, which is a minor organization gap. | 4 / 5 |
Total | 17 / 20 Passed |