Content
100%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.
Exemplary skill body: a complete executable command reference up front, an explicit routing decision tree with stopping rules and error-recovery loops, and disciplined delegation to a single one-level-deep reference with precise read/don't-read signals. Latency costs and common failure modes (over-escalating type, adding filters to an empty query) are exactly the non-obvious knowledge a skill should contribute.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries non-obvious, skill-specific guidance — token budgets ("Start at the default --tokens 5000. Retry once at 10000"), latency costs ("deep (4-15s)... deep-reasoning (12-40s)"), and fallback discipline ("Fall through at most once") — with zero padding and no explanation of concepts Claude already knows. Matches the lean/efficient top anchor; there is nothing trimmable without losing operative detail. | 5 / 5 |
Actionability | The full CLI signature with every flag is copy-paste ready, a concrete example invocation is given ("scripts/exa.sh context \"expose a Rust struct to Node via napi-rs threadsafe function\""), and specific numeric defaults (5000/10000/10000 tokens, 600-char highlights, 10 results) cover the common cases. Fully executable guidance matching the top anchor. | 5 / 5 |
Workflow Clarity | The routing decision tree is explicit and fully sequenced: /context first, five enumerated fall-through conditions (empty response, non-code query, recency, provenance, follow-up), narrated fallback with a quoted example, "Fall through at most once" as a stopping rule, and error-recovery loops for empty results ("Remove filters first, then simplify the query") and a missing API key. This is not a destructive or batch operation, so no validation cap applies, and the error-recovery guidance matches the top anchor's feedback-loop standard. | 5 / 5 |
Progressive Disclosure | The body is a lean overview that delegates cleanly: all HTTP lives in scripts/exa.sh (a real bundle file), and references/search-tuning.md (a real 92-line file with no nested references) is signaled with both when-to-read ("when tuning /search filters, choosing a type, or debugging a 400") and when-not-to-read ("Do not read it for a routine /context lookup") guidance. One level deep, clearly signaled, easy to navigate — the top anchor. | 5 / 5 |
Total | 20 / 20 Passed |