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 CLI skill body with executable commands and a clear step sequence. The main weakness is a referenced REFERENCE.md that does not exist in the bundle, plus minor verbosity in the anonymous-tier and naming-gotcha passages.
Suggestions
Add the missing REFERENCE.md to the bundle (or remove the reference and inline the few needed exit codes / env vars), since the body currently points to a file that is not present.
Tighten the Step 3 anonymous-tier paragraph and consolidate the repeated npx-vs-command naming caveats into a single note to reduce token overhead.
Add one explicit validation checkpoint (e.g. 'Confirm Node >= 20.10 before proceeding; if `--version` fails, stop and install Node') to push workflow clarity toward the top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence (no explanation of npm, API keys, or URLs), but a few spots could be tightened — e.g. the long Step 3 paragraph on anonymous-tier behavior and the repeated naming-gotcha caveats. Fits the 'efficient; minor instances that could be trimmed' anchor, not a 5 because of those padded passages. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout (npx version check, scan with flag variants, get/list/ask invocations) plus a concrete options table and jq example, covering the common cases — matches the anchor-5 example. | 5 / 5 |
Workflow Clarity | Clear numbered sequence (Steps 1–7) with decision branches (A/B/C for key location) and error-handling notes (quota_exhausted, --no-wait capture). Not a 5 because there are no explicit validate-then-proceed checkpoints, though the non-destructive scan task does not strictly require them. | 4 / 5 |
Progressive Disclosure | Well-structured into labeled sections with a clearly signaled one-level reference ('see [REFERENCE.md](REFERENCE.md)'). Not a 5 — and a real gap — because REFERENCE.md is referenced but is absent from the bundle (no references/ directory or file exists), leaving a dangling pointer. | 4 / 5 |
Total | 17 / 20 Passed |