Content
71%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 tight, well-crafted reference body: lean prose, concrete mechanics and decision rules, and correct use of a one-level-deep split to references/craft.md. Its one real defect is a dangling pointer — the glossary that the body instructs the reader to consult for every bold term is missing from the bundle.
Suggestions
Resolve the GLOSSARY.md dangling link: either ship the glossary file defining the bold terms, or retarget the bold-term pointer to references/craft.md (which already defines most of them) so the body's navigation promise holds.
If adding the glossary, keep it one level deep and co-located with the craft reference rather than nesting further, preserving the current clean disclosure structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with no padding and explains nothing Claude already knows — every section carries non-default guidance, tests, or cures. It falls short of 5 because of minor restatements, e.g. "Pick model-invocation only when the agent must reach the skill on its own, or another skill must" re-summarizes the two invocation bullets above it. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact frontmatter mechanics ("set `disable-model-invocation: true`"), decision rules, an ordered defense ladder ("sharpen the completion criterion first; only if it is irreducibly fuzzy... split"), and a runnable no-op test ("does it change behaviour versus the default?"). Minor gaps only — no worked example of a good description in the body. | 4 / 5 |
Workflow Clarity | This is a reference skill (no multi-step process, no destructive or batch operations, so no validation cap applies), and its consult-on-demand structure is clear: each section's purpose is stated, and read-ordering is explicit ("Read it before restructuring a skill"). Below 5 because the skill serves several distinct uses (choose invocation, write description, edit body, diagnose) without ordering the diagnosis path across the five failure modes. | 4 / 5 |
Progressive Disclosure | The structure is right — a compact overview with one-level-deep, clearly signaled pointers (references/craft.md exists and matches its billing) — but the body's primary lookup promise is broken: "**Bold terms** are defined in [GLOSSARY.md](GLOSSARY.md)" points to a file that does not exist in the bundle, so the advertised navigation path for the defined vocabulary fails. | 3 / 5 |
Total | 15 / 20 Passed |