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-organized, highly actionable single-file skill: executable examples, exact parameter and response contracts, explicit staleness/error handling, a prompt-injection safety note, and a clear "When NOT to use" routing section. Its only deductions are mild verbosity in the coverage/stale explanation and response-shape detail that could be split into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with API-specific knowledge Claude cannot already know (epoch-millisecond timestamps, the staleReason closed vocabulary, feed-status semantics), with no generic-concept padding — but the long coverage/stale paragraph and the map-view caveat paragraphs run somewhat long and could be trimmed, matching anchor 4 (efficient, minor over-explanation) rather than anchor 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready curl examples with real headers, JMESPath projections, a jq pipeline, a concrete parameter table with shapes and fallback behavior, a complete response-shape JSON sample, and explicit error codes with remediation ("429 — rate limited; retry with backoff") — the examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Both workflows (connected MCP and server-to-server HTTP) are clearly sequenced auth → call → interpret → handle errors, with validation checkpoints ("reject a response when coverage.servedStale is true", honest reporting of translate failures and stale coverage); it lacks an explicit numbered step sequence with feedback loops, so anchor 4 fits better than anchor 5 — and the destructive/batch cap at 3 does not apply since no such operations exist. | 4 / 5 |
Progressive Disclosure | No bundle files exist; the body is a single file with clear section headers, and the References section points to one-level-deep external links. The full response-shape JSON and the stale-policy vocabulary are candidates to move to a reference file, and the skill exceeds the under-50-lines simple-skill exception — good structure with minor organization gaps (anchor 4). | 4 / 5 |
Total | 17 / 20 Passed |