Content
86%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.
The body is an exemplar of token-efficient, repository-specific guidance: it encodes non-obvious FastMCP testing conventions and a bug-fix regression workflow with explicit validation checkpoints, without a wasted word. Its only gap is the absence of a copy-paste example test and an explicitly numbered workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with non-obvious repository-specific knowledge ('`asyncio_mode = "auto"` is configured globally', '`pythonpath` in pyproject shadows `PYTHONPATH`', 'The default timeout is five seconds') and never explains concepts Claude already knows. Every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | Concrete, executable guidance is given throughout ('Use `Client(server)` for real MCP dispatch', 'capture the outgoing request with `httpx2.MockTransport`', 'pin `mode="legacy"` only when the handshake era is the subject', 'copy it into a main worktree'). It falls short of anchor 5 because there is no copy-paste-ready example test covering the common cases, though it is well above anchor 3's pseudocode level. | 4 / 5 |
Workflow Clarity | A clear sequence with explicit validation checkpoints is present ('Read nearby tests ... first', 'run the regression against unchanged code and confirm it fails for the reported reason, then run it with the fix', 'Run focused tests during development, then the full commands required by AGENTS.md before committing'), including error-recovery guidance ('If a failure appears unrelated, reproduce it on the unchanged base'). It misses anchor 5 because the sequence is dispersed across prose and bullets rather than presented as explicit ordered steps with a checklist. | 4 / 5 |
Progressive Disclosure | The skill is a 21-line body with no bundle files, well organized into a heading, orientation paragraph, and focused bullets, and its single reference (the '[testing guide](../../../docs/development/tests.mdx)') is clearly signaled and one level deep. Per the rubric guideline for skills under 50 lines with no need for external references, this matches anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |