Content
88%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 excellent executable reference: complete input/output schemas, copy-paste payloads, practical jq recipes, and a CLI-to-JSON mapping table with the key comma-string-vs-array gotcha called out. The only trims are the maximal payload examples that restate the schema blocks, and the single-file layout is acceptable but sits at the boundary where a per-command split would help.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense reference with no padding or explanations of concepts Claude already knows — field notes, backend-difference gotchas, and a mapping table all earn their tokens. The maximal payload blocks for search and ask largely restate the preceding schema listings with example values, which is the kind of minor over-explanation that could be trimmed, matching the 4 anchor rather than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Copy-paste-ready minimal and maximal JSON payloads, five runnable jq one-liners per output schema, and a complete CLI-to-JSON field mapping table. Everything is executable and the examples cover the common cases (extract URLs, snippets, citations, token usage), matching the 5 anchor. | 5 / 5 |
Workflow Clarity | This is a single-purpose reference/lookup skill with no multi-step process and no destructive or batch operations, so the simple-skill exception applies: the single action (consult the schema, construct or parse a payload) is unambiguous, and sections are cleanly organized per command with input, output, and mapping each clearly delineated. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so all content is inline in a ~230-line file with well-organized per-command sections and one clearly signaled one-level-deep reference (../models/SKILL.md). Structure is good, matching the 4 anchor; it is not the 5 anchor's overview-pointing-to-split-files pattern, and the under-50-lines exception for a top score does not apply. | 4 / 5 |
Total | 18 / 20 Passed |