Content
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise and well-organized but fundamentally acts as a catalogue pointer rather than a working skill: it provides no executable commands or concrete workflow and delegates all substance to an external upstream repository. As a discoverable entry it is tidy, but as standalone guidance it lacks actionability.
Suggestions
Add a concrete install/invocation command (e.g., a copy-pasteable git clone or skill-install snippet) instead of only directing the reader to open the upstream README.
Provide at least one executable example of invoking the skill or its API so the body is actionable on its own.
If local reference files exist in the upstream bundle, surface them as signaled one-level-deep links (e.g., See [REFERENCE.md](REFERENCE.md)) rather than a single external URL, to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, with no padding or explanation of concepts Claude already knows; every section (What it does, Source, How to use) is terse and earns its place. | 3 / 3 |
Actionability | The guidance is abstract rather than executable — it tells the reader to 'Inspect the upstream README' and 'ask the agent to invoke this skill by name', with no concrete commands, code, or copy-paste-ready instructions beyond opening a URL, matching the 'describes rather than instructs' anchor. | 1 / 3 |
Workflow Clarity | A sequence is implied (open the upstream repo, install the bundle, invoke the skill), but the steps are vague with no concrete install command and no validation checkpoints; the guidance rests on pointing elsewhere, which is present-but-implicit rather than clear. | 2 / 3 |
Progressive Disclosure | The body is organized into clear sections and points one level deep to the upstream repo, but there is no local bundle (references/, scripts/, assets/ are absent) and the single reference is an external URL rather than signaled local files, so navigation could be clearer and more self-contained. | 2 / 3 |
Total | 8 / 12 Passed |