Content
68%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 a well-structured, token-efficient authoring template with concrete rules, formats, and real one-level-deep reference files. Its main weakness is the absence of explicit validation checkpoints for the authoring workflow it implicitly sequences, plus placeholder scaffolding in the Examples and Guidelines sections.
Suggestions
Add an explicit validation checklist at the end of the authoring sequence: description in third person, body under 500 lines, all referenced files exist, claims backed by registry IDs.
Replace placeholder scaffolding in Examples and Guidelines ("Guideline one with specific, verifiable criteria", "[describe input]") with one complete filled-in exemplar so authors have a concrete model.
Make the reference map explicit — label the references/ links as this skill's own supporting files rather than showing them only as template placeholders.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~110-line body is efficient for its purpose: each section carries a rule or format ("Keep the total SKILL.md body under 500 lines", "Write in third person", numbered gotcha format), with a concrete good/avoid example pair rather than generic explanation. Minor over-explanation remains (ownership-boundary guidance repeated in the intro and When to Activate; the placeholder prose in Detailed Topics adds little), so it fits anchor 4 ('efficient; minor instances that could be trimmed') rather than the fully lean anchor 5, and is well above the padded anchor 3. | 4 / 5 |
Actionability | The body gives mostly executable guidance for a skill author: a 500-line budget, third-person rule with a good/avoid example ("Processes Excel files" vs "I can help you"), a three-level freedom framework for matching specificity to fragility, required gotcha format, plain-text related-skill lists, and a rule that claims need inline `claim-*` IDs backed by `researcher/claims/index.jsonl`. The gaps are placeholder scaffolding ("Guideline one with specific, verifiable criteria", the `[describe input]` example block), so it fits anchor 4 ('mostly executable guidance with minor gaps') — not 5 because no example is complete and copy-paste ready, not 3 because the concrete rules dominate over pseudocode. | 4 / 5 |
Workflow Clarity | The section order (When to Activate → Core Concepts → Detailed Topics → Practical Guidance → Examples → Guidelines → Gotchas → Integration → References → Metadata) provides an implicit authoring sequence, but there are no validation checkpoints (e.g., 'verify description is third person', 'confirm body is under 500 lines', 'check all referenced files exist') — matching anchor 3 ('steps listed but validation gaps; checkpoints missing or implicit'). Not a 4 because no checkpoint is made explicit anywhere, and not a 2 because the structural sequence is coherent rather than gapped. The skill is not destructive/batch, so the cap-at-3 rule for missing validation is not additionally triggered. | 3 / 5 |
Progressive Disclosure | The body is well structured at ~110 lines, points to real one-level-deep bundle files ("See [detailed reference](./references/topic-details.md)" and "[Reference Name](./references/reference-file.md)" — both exist in references/), and instructs moving long material out of SKILL.md. It fits anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps') rather than 5 because reference links are shown as template placeholders within section examples rather than clearly signaled as this skill's own reference map, leaving navigation slightly ambiguous. | 4 / 5 |
Total | 15 / 20 Passed |