Content
77%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 highly actionable, well-sequenced docs-search workflow with strong validation and recovery. The main weaknesses are verbosity in the honesty-rules section and the absence of bundle files to offload the large routing/mapping tables.
Suggestions
Trim the 'Never say' bad-examples table and meta-narration in the Honesty rules to the essential rules; Claude can infer most of the leak-internals cases from a short principle.
Move the static reference tables (slug-name patterns, npm-package→product mapping, framework-name normalization) into a references/ file (e.g. SDK_MAP.md) linked from Step 1, reducing SKILL.md size and improving progressive disclosure.
The skill ships no bundle files but the body references ../stream/RULES.md and ../stream/SKILL.md; add a one-line note clarifying these are sibling pack skills, not bundle files of this skill, so navigation expectations are explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient for a complex routing skill, but the large 'Never say' bad-examples table and verbose honesty rationale explain behavior Claude could largely infer and could be tightened. | 3 / 5 |
Actionability | Fully executable guidance: exact grep probes, exact URLs, verbatim fetch prompts, precise citation format, and concrete version 200/404 handling covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 1–4 are clearly sequenced with sub-steps and explicit validation checkpoints (verify URLs after fetch, re-fetch once with a stricter prompt, stop if still empty) plus 404 recovery feedback loops. | 5 / 5 |
Progressive Disclosure | No bundle files ship with the skill, and large reference tables (slug patterns, package→product mappings, framework normalization) are inlined rather than split into navigable detail files, though section headers provide reasonable structure. | 3 / 5 |
Total | 16 / 20 Passed |