Content
36%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 sparse, stub-like body that installs the skill but never explains how to use it: the core Context7 usage, examples, and troubleshooting are all delegated to an external GitHub repo, and the Overview/When-to-Use sections merely duplicate the frontmatter. Structurally navigable but substantively hollow.
Suggestions
Replace the externalized guidance with concrete, executable steps for the skill's actual purpose — e.g. how to query the Context7 API (endpoint or command, library-name resolution, and reading the returned docs) — instead of "Use naturally in Claude Code conversations".
Include at least one real inline example (a sample query for React or Prisma docs and the expected result) rather than "See GitHub Repository for examples".
Cut the redundant "Overview" and "When to Use" sections (they restate the frontmatter description) and either inline a short troubleshooting entry (e.g. rate-limit/auth errors and the env-var fix) or move the detail into a bundled references/ file linked from the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short (~35 lines) but padded: "## Overview" and "## When to Use" repeat the frontmatter description nearly verbatim, "## Examples" contains no examples, and "## Troubleshooting" is a one-line pointer. This fits the 3 anchor ("mostly efficient but ... could be tightened"); it is above 2 because there is no concept-explaining verbosity and the total token footprint is small. | 3 / 5 |
Actionability | The only executable content is the install command ("npx skills add -g BenedictKing/context7-auto-research"). Everything about the skill's actual purpose is vague or externalized: "Configure API key (optional, see GitHub repo for details)", "Use naturally in Claude Code conversations", "See [GitHub Repository](...) for examples". This matches the 2 anchor ("Minimal concrete guidance; high-level hints but missing the specific steps to execute"); it is not 3 because no executable code or commands for actually fetching documentation via the Context7 API exist anywhere in the body. | 2 / 5 |
Workflow Clarity | The three-step guide is a rough sequence ("1. Install the skill ... 2. Configure API key ... 3. Use naturally") but the steps are poorly defined — step 3 is not an action and step 2 defers to an external repo — and there are no checkpoints or validation. This fits the 2 anchor ("Rough sequence present but many gaps; steps poorly defined"); it is not 1 because a numbered sequence does exist, and no destructive/batch-operation cap applies. | 2 / 5 |
Progressive Disclosure | Sections are present and the only references are one-level external links to the GitHub repo, but no bundle files exist (no references/, scripts/, or assets/), and the substantive content (API usage, examples, troubleshooting) lives outside the skill entirely. This fits the 3 anchor ("Some structure but could be better organized; references present but not clearly signaled") — the simple-skill 5 exception does not apply because the skill does need external/bundled references for its core content, yet they are not provided; it is not 2 because the body itself is not an inlined wall of misfiled content. | 3 / 5 |
Total | 10 / 20 Passed |