Content
71%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 lean, highly actionable reference with copy-paste commands, documented flags, and a clear output contract. Its main defects are the missing bundle scripts referenced throughout, and the absence of any setup verification or error-recovery guidance.
Suggestions
Ship the referenced bundle files (`search.js`, `content.js`, `package.json`) or correct the paths — every usage example depends on files absent from the bundle.
Add a one-line setup verification step (e.g., a minimal `search.js "test"` run to confirm the API key and install work) plus a note on common failures like invalid/missing `BRAVE_API_KEY`.
Drop or compress the 'When to Use' section, which duplicates the frontmatter description, to remove the remaining redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-focused: numbered setup, concrete invocations, a compact options list, and an output-format sample — no explanations of concepts Claude already knows. Minor trimming is possible (the 'When to Use' section largely repeats the frontmatter description, and 'no browser required' appears in both), which fits the 'efficient; minor instances that could be trimmed' anchor rather than the every-token-earns-its-place level-5 anchor. | 4 / 5 |
Actionability | Commands are concrete and copy-paste ready with defaults and limits documented (e.g., `{baseDir}/search.js "query" -n 10 --content`, `max 20`, freshness formats), and setup gives exact steps including the env-var export. It falls short of fully executable because the referenced bundle files (`search.js`, `content.js`, and the `package.json` implied by `npm install`) are not present in the bundle listing, leaving a gap between the written commands and a runnable skill. | 4 / 5 |
Workflow Clarity | The setup is a clearly numbered sequence (account → subscription → API key → env var → npm install) and usage is unambiguous; as a read-only search skill the destructive/batch validation cap does not apply. It sits at level 4 rather than 5 because there are no checkpoints or error-recovery guidance for the setup (e.g., verifying the key works, what to do on a 401/422), and at 4 rather than 3 because the sequence is fully explicit with only these minor validation gaps. | 4 / 5 |
Progressive Disclosure | Section structure is sensible (Setup / Search / Options / Extract / Output Format) and the content is appropriately inline for a simple skill. However, scoring against the actual bundle structure: the body's core referenced paths (`{baseDir}/search.js`, `{baseDir}/content.js`, and the package.json implied by `npm install`) do not exist in the bundle, so its references do not resolve — a structural gap that keeps it below the level-4 'references mostly clear' anchor while the organized sections keep it above level 2. | 3 / 5 |
Total | 15 / 20 Passed |