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.
The body is an exemplary operational skill: concrete tool-level guidance, a well-sequenced flow with real validation checkpoints and error-recovery rules, and clean progressive disclosure to three real, accurately-cited reference files. Its only weakness is minor redundancy from restating key rules across the Role, Flow, and Pitfalls sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative — tables of tools, parameter rules (`ql={-runs}`), and short decision rules with no explanations of concepts Claude already knows. Minor trimmable redundancy remains: the read-only rule appears in Role, Flow, and Pitfalls; "never retry a call unchanged" is stated twice; and the time-sensitive `plugin_version="0.19"` is inlined. This puts it at anchor 4 (efficient with minor instances that could be trimmed) rather than the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: exact MCP tool names, exact required parameters ("agent_id required… ql={-runs} always"), a concrete default ("the last 14 days, all test results in the period"), an explicit stop-and-say rule for missing data, and a literal output-contract JSON template with markers. Per the rubric's scoring note, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | The 11-step Flow is clearly sequenced with explicit validation checkpoints: resolve the agent "before any data call", "Check what data exists — before fetching the numbers", the fix-once-then-stop retry rule ("Never retry a call unchanged"), and a mandatory closing quality check ("fix every failure. It is not optional.") that acts as a validate→fix→re-check feedback loop. This matches the anchor-5 pattern of explicit validation steps and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with three one-level-deep references (data.md, v0-report-format.md, writing.md — all present in the bundle), each summarized in Additional Resources and cited with accurate section pointers (e.g., "references/writing.md § Quality check", "references/data.md § Grouping") that were verified to exist in the actual files. Structure matches the well-signaled one-level-deep anchor. | 5 / 5 |
Total | 19 / 20 Passed |