Content
87%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.
Highly actionable and token-efficient content with excellent example payloads and parameter documentation. The main gap is the destructive clear workflow: it documents the guard against unscoped wipes but never sequences a validate-before-clear step (e.g., preview matches, then clear).
Suggestions
Add an explicit safe-clear workflow: run the query/url_pattern first to preview matching entries, confirm scope, then re-run with clear: true.
For check_changes batch re-fetches, add a verification checkpoint (e.g., review the diff summary before acting on reported changes) to satisfy the batch-operation feedback-loop expectation.
Clarify the boundary with wigolo-find-similar in Modes (when hybrid search here is the right tool vs. delegating to find-similar) to reduce overlap confusion.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven with compact JSON examples and no re-teaching of known concepts; the brief 'instant (0ms network), free (no engine query)' line is decision justification that earns its tokens rather than padding. | 5 / 5 |
Actionability | Quick Reference provides copy-paste-ready payloads for every mode (keyword, glob, hybrid, since, stats, check_changes, clear), and the Parameters table pairs each option with defaults and explicit 'when to use' guidance. | 5 / 5 |
Workflow Clarity | The cache-first probe-then-fall-through sequence is clear, but the destructive clear operation has no explicit validation checkpoint — only the note that 'the handler refuses an unscoped wipe' — so per the rubric cap for destructive/batch operations without validation steps, workflow clarity is capped at 3. | 3 / 5 |
Progressive Disclosure | A single well-organized file with nothing inlined that belongs in separate bundle files; the See Also links to sibling skills are clearly signaled, one level deep, and support easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |