Content
82%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 well-structured, highly actionable skill body with a clear seven-step workflow, concrete field-level guidance, and correctly signaled one-level-deep references verified to exist. The gaps are minor: a dangling `example.html` entry in the resource map, no explicit fix-and-re-check loop after the checklist step, and light redundancy with the frontmatter description.
Suggestions
Remove `example.html` from the resource map (or add the file), since the bundle only contains SKILL.md and references/ — a listed-but-missing file undermines the resource map's reliability.
In Step 7, add an explicit feedback loop: if any P0 checklist item fails, fix the artifact and re-run the checklist before emitting, mirroring the validate-fix-retry pattern.
Trim the opening framing paragraph and the 'When to use this skill' trigger list, which largely restate the frontmatter description and could be condensed to a single scope statement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and instructional with no explanation of concepts Claude already knows, but the framing paragraph ("The output is not a decorative research deck. It is a working room for debate") and the "When to use this skill" section restate information already in the frontmatter description — minor instances that could be trimmed, so anchor 4 rather than the every-token-earns-its-place of anchor 5. | 4 / 5 |
Actionability | Fully executable guidance for an instruction-only skill: exact ledger row fields (`id`, `source_type`, `segment`, `signal`, `quote_or_metric`, `strength`, `limitations`), enumerated source types, a fixed 8-section artifact information architecture, defined 1-to-5 scoring dimensions, and a copy-paste-ready `<artifact>` emission template with a defined stopping point ("Nothing after the closing `</artifact>`"). | 5 / 5 |
Workflow Clarity | Seven clearly sequenced steps with an explicit validation checkpoint ("Run the checklist. Then emit") and strong anti-fabrication rules, but the failure path is only implied — the anchor-5 pattern expects an explicit "if the checklist fails, fix and re-run" feedback loop rather than just a single pre-emit check. | 4 / 5 |
Progressive Disclosure | References are well signaled at the right workflow moments ("Read `references/evidence-model.md` before synthesis and run `references/checklist.md` before emitting") and both files exist one level deep. However, the resource map lists `example.html`, which does not exist in the bundle — a dangling entry that keeps this below anchor 5. | 4 / 5 |
Total | 17 / 20 Passed |