Content
96%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 exemplary single-purpose API skill body: fully executable auth and request examples, exact endpoints, explicit error-recovery guidance, prompt-injection hygiene for untrusted feed data, and clear routing to sibling skills. The only structural nit is that the response schema and parameter reference are inlined in SKILL.md rather than split into a bundled reference file. Results are strong across all dimensions.
Suggestions
If the skill grows, move the full response schema and parameter tables into a references/ file (e.g. references/api.md) and keep only the field mapping needed for the worked example in SKILL.md.
Add a brief note in the worked example showing how to follow pagination with the nextCursor value, since the response shape introduces it but no example demonstrates its use.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place: auth header format, three endpoints, a compact parameter table with a concrete JMESPath example, a minimal response schema, one worked curl command, error handling, and routing disambiguation. Nothing explains concepts Claude already knows, and the content-safety note is skill-specific guidance about untrusted feed data rather than padding. Lean and efficient matches anchor 5. | 5 / 5 |
Actionability | The worked example is copy-paste ready ("curl -s --get -H 'X-WorldMonitor-Key: $WM_API_KEY' ... --data-urlencode 'page_size=25' | jq ..."), endpoints are exact URLs, parameters are tabulated with types and constraints, and the response shape is shown field-by-field including the degraded-snapshot signal ("fetchedAt: 0 or dataAvailable: false"). Fully executable and covers the common cases — anchor 5. | 5 / 5 |
Workflow Clarity | The entry point and escalation path are explicit: "Start with `list-climate-disasters` for event records, then use anomalies or climate news when the user needs broader context." The Errors section provides recovery feedback for each failure mode (401 missing key, 429 retry with backoff, seed-unavailable signals to retry later). This is a simple, single-purpose retrieval skill with no destructive or batch operations, so the simple-skill exception applies and the single action is unambiguous. | 5 / 5 |
Progressive Disclosure | Sections are clearly labeled and the References section points one level deep to well-signaled external resources (OpenAPI operations ListClimateDisasters/ListClimateAnomalies/ListClimateNews and the auth matrix). However, the ~90-line body inlines the full response schema and complete parameter tables — content that would sit appropriately in a reference file if the skill grows. Good structure with minor organization gaps matches anchor 4 rather than the fully split structure of anchor 5. | 4 / 5 |
Total | 19 / 20 Passed |