Content
81%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 reference: every command is executable, the two-step workflow has explicit gates and error-recovery loops, and failure modes (quota, ambiguity, wrong matches) are covered. The main weakness is redundancy — repeated command blocks and a thrice-stated sensitive-data warning — plus detail sections that could be split into a reference file.
Suggestions
State the two npx commands once (either in the intro or the Workflow section) instead of repeating the identical command pair in both places.
Consolidate the 'Do not include any sensitive or confidential information' guidance into a single statement — it currently appears in Step 1, 'Writing good queries', and 'Common Mistakes'.
Move the 'Result fields' and 'Selection process' detail blocks into a one-level-deep reference file (e.g. references/library-resolution.md) to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely useful operational guidance and does not explain concepts Claude already knows, but the same two commands are repeated verbatim in the intro and again in the Workflow section, and "Do not include any sensitive or confidential information..." is stated three times (Step 1, Writing good queries, Common Mistakes), with "one topic per query" also repeated twice. This matches "mostly efficient but includes some unnecessary explanation or could be tightened" — not 2 because the padding is duplicated instructions rather than padded concept explanations. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: `npx ctx7@latest library <name> "<query>"`, `npx ctx7@latest docs /facebook/react "..."`, `--language Ruby` flag usage, and realistic examples covering the common cases (ID resolution, version-specific IDs, authentication, quota errors). The good/bad query table makes quality guidance concrete. Nothing is pseudocode or abstract. | 5 / 5 |
Workflow Clarity | A clearly sequenced two-step process (resolve ID, then query docs) with an explicit gate ("You MUST call `library` first to obtain a valid library ID UNLESS the user explicitly provides a library ID"), a hard attempt limit ("Do not run these commands more than 3 times per question"), and feedback loops for error recovery: quota error → inform user → suggest login → documented fallback; "If results look wrong, try alternate spellings"; and ambiguity → request clarification. This is a read-only lookup skill, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Good single-file structure with clear, navigable sections (Workflow, Step 1, Step 2, Authentication, Error Handling, Common Mistakes) and no orphaned or nested references (no bundle files exist). Not 5 because at ~147 lines it exceeds the simple-skill range where section organization alone suffices, and self-contained detail blocks like "Result fields" and "Selection process" (~25 lines) could live in a one-level-deep reference file to slim the overview. | 4 / 5 |
Total | 17 / 20 Passed |