Content
21%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 an auto-generated documentation index rather than skill instructions: it catalogs sections, statistics, and scraped snippets but never tells Claude what to do. Navigation to the two real reference files is its only structural strength; the rest is padded, partially broken filler.
Suggestions
Replace the metadata, statistics, quick-reference, and code-example sections with a short task-oriented guide: what questions this skill answers and the 2-3 step lookup workflow (check references/index.md for the topic, then read the relevant section of references/manual.md).
Delete the dummy 'x0 = 0 ... x37' filler example and the empty 'From section: API Usage' table stub — they consume tokens and misrepresent the documentation.
Move the extracted code examples and table contents into references/manual.md or a dedicated examples file, keeping SKILL.md to a concise overview with one-level-deep, clearly labeled links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is padded with auto-generated boilerplate — document metadata (author, created/modified dates), a statistics section that duplicates the section overview, and a ~40-line dummy Python example ('x0 = 0 ... x37 = 37') that ends mid-token with '...' and teaches nothing. It is noticeably verbose with several padded sections, though it does not explain concepts Claude already knows, placing it at anchor 2 rather than 1. | 2 / 5 |
Actionability | The body is entirely descriptive metadata — section counts, topic lists, scraped code snippets like 'pip install thing' and "print('hello')" — with no instruction on what to do with any of it. It describes rather than instructs, matching anchor 1 (no concrete code or commands in service of the skill's task). | 1 / 5 |
Workflow Clarity | No sequenced process exists; the only implied path is 'consult references/index.md, then references/manual.md', which is a rough, implicit sequence with major gaps and no checkpoints. It does not fall to anchor 1 because a navigable structure and section numbering do exist, but it lacks anything resembling anchor 3's explicit step list. | 2 / 5 |
Progressive Disclosure | References are real (references/index.md and references/manual.md both exist), one level deep, and clearly signaled in a Navigation section. However, large content that belongs in those files — full code examples, table dumps (one of which is empty), and statistics — is inlined in SKILL.md, matching anchor 3 (some structure, content that should be separate is inline) rather than 4. | 3 / 5 |
Total | 8 / 20 Passed |