Content
53%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 content is a tidy, well-organized catalogue stub rather than a functioning skill: it is concise and easy to scan, but provides almost no executable guidance, deferring everything to an upstream repository the agent cannot act on directly. Workflow and actionability are the weak points.
Suggestions
Replace "install the upstream bundle into your active agent's skills directory" with a concrete, copy-pasteable command (e.g., a git clone or file-copy step plus the exact target path).
Add at least a minimal in-bundle quick-start (one command or invocation example showing what the skill actually does once installed), so the entry is actionable without leaving the session.
Trim redundancy: drop the verbatim restatement of the description in 'What it does' and consolidate the three mentions of the upstream source into the Source section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and free of concept over-explanation, but carries minor redundancy: the 'What it does' section repeats the frontmatter description verbatim and the upstream provenance is stated three times (blockquote, Source section, and How to use). This fits 'efficient; minor instances that could be trimmed' rather than the perfectly lean anchor 5. | 4 / 5 |
Actionability | The core instruction "install the upstream bundle into your active agent's skills directory" provides no concrete command, and the only executable line is `open https://github.com/...` for inspecting the README. This matches 'high-level hints but missing the specific steps to execute' rather than 3, which would require at least partially executable guidance for the install/invoke flow. | 2 / 5 |
Workflow Clarity | A rough sequence exists (inspect upstream README → install bundle → invoke by name or trigger), but the steps are poorly defined: no install command, no path placement guidance, and no verification that the skill is discoverable. This is anchor 3 ('sequence present but checkpoints missing or implicit'), not 4. | 3 / 5 |
Progressive Disclosure | The body is under 50 lines with clearly organized sections and one clearly signaled external reference (the upstream GitHub URL), and no bundle files exist to organize. It does not reach 5 because all substantive content is delegated to an external URL rather than a self-contained overview with one-level-deep reference files, making the skill itself unexecutable from this bundle. | 4 / 5 |
Total | 13 / 20 Passed |