Content
88%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 content with executable commands, a clearly sequenced workflow with explicit gating and error-recovery loops, and clean section organization. The main improvement opportunity is deduplication — the sensitive-data warning and query-quality guidance each appear multiple times — and splitting a couple of secondary sections into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely efficient: commands, examples, and tables with almost no explanation of concepts Claude already knows. Slipping from 5 due to avoidable repetition — the sensitive-data warning appears three times ("Do not include any sensitive or confidential information" in Step 1, Writing good queries, and Common Mistakes) and the descriptive-query guidance is stated twice — plus the Selection process sub-bullets ("Analyze the query to understand what library the user is looking for") state the obvious. | 4 / 5 |
Actionability | Fully executable throughout: concrete invocations with realistic arguments ("ctx7 library react \"How to clean up useEffect with async operations\""), a copy-paste fallback ("mise exec npm:ctx7 -- ctx7 <command>"), version-specific ID examples, a good/bad query table, and exact auth commands. Common cases are covered with ready-to-run commands, matching the top anchor. | 5 / 5 |
Workflow Clarity | Clear two-step sequence (resolve ID, then query) with an explicit gating rule ("You MUST call ctx7 library first... UNLESS the user explicitly provides a library ID"), a bounded retry policy ("Do not run these commands more than 3 times per question"), and error-recovery feedback loops for quota failures including a no-silent-fallback disclosure requirement. The skill is a non-destructive lookup, so the destructive-operation validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Single-file skill (no references/, scripts/, or assets/ bundles exist) with well-organized, clearly headed sections in a sensible order (workflow, resolve, query, auth, errors, mistakes). At ~130 lines it exceeds the under-50-line simple-skill case, and minor content like the auth options or the detailed Selection process could live in a reference file, so it lands at good-structure rather than the top anchor. | 4 / 5 |
Total | 18 / 20 Passed |