Content
43%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.
The body is token-efficient and cleanly sectioned, but it functions as a README for an external repository rather than a skill: it provides almost no executable guidance for the skill's core capability, and it delegates examples and troubleshooting to an external URL instead of carrying them in bundle files.
Suggestions
Replace the vague steps with concrete, executable instructions for the skill's core workflow — how Context7 is invoked, an example query/response, and the API-key environment variable names.
Move examples and troubleshooting guidance into local bundle files (e.g. references/examples.md, references/troubleshooting.md) with clearly signaled one-level-deep links, instead of pointing to the external GitHub repo.
Cut the duplicated Overview line and the filler bullets ("seamless integration", "Use naturally") so every remaining token carries actionable content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — no padding, no explanations of concepts Claude already knows — but the "Overview" section repeats the frontmatter description verbatim and "Use the skill's auto-trigger feature for seamless integration" is marketing filler that earns no tokens, so it falls just short of anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | Only the install command ("npx skills add -g BenedictKing/context7-auto-research") is copy-paste executable; the rest are high-level hints — "Configure API key (optional, see GitHub repo for details)" and "Use naturally in Claude Code conversations" give no concrete steps or examples of the skill's actual operation, matching anchor 2's 'minimal concrete guidance; missing the specific steps to execute'. | 2 / 5 |
Workflow Clarity | The Step-by-Step Guide is a rough three-step sequence (install → configure key → use naturally) but the steps are poorly defined — 'see GitHub repo for details' and 'use naturally' leave the user with no concrete actions or checkpoints — matching anchor 2 rather than anchor 3's adequately listed steps. | 2 / 5 |
Progressive Disclosure | Sections are well-organized for a short skill, but there is no bundle at all (references/, scripts/, assets/ are absent) and essential content — examples and troubleshooting — is deferred to an external GitHub URL ("See [GitHub Repository](...) for examples", "See the GitHub repository for troubleshooting guides") instead of one-level-deep bundle files, matching anchor 3's 'references present but not clearly signaled / could be better organized'. | 3 / 5 |
Total | 11 / 20 Passed |