Content
85%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 strong, actionable instruction skill: a concrete limitation formula, worked examples, a phrase bank, and a validation checklist make the drafting workflow fully executable. The main defect is bundle integration — the existing references/audit-reference.md and scripts/main.py are orphaned, never referenced from SKILL.md, leaving genuinely useful functionality undiscoverable.
Suggestions
Add a section in SKILL.md (e.g., '## Tools') that links scripts/main.py for template-based generation (python scripts/main.py --issues retrospective,single_center) and references/audit-reference.md for audit paths, or remove the unused bundle files.
Trim the category table's explanatory parentheticals (e.g., "cross-sectional (cannot establish temporality)") to just the limitation names — Claude already knows these concepts.
Add worked example statements for the Measurement and Generalizability categories, which currently appear in the categorization table but have no template output.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — every section serves the drafting task, and the examples and phrase bank are the skill's genuine added value. Minor over-explanation could be trimmed, e.g., the category table's parentheticals "cross-sectional (cannot establish temporality)" and "single-center" explanations restate concepts Claude already knows. It fits anchor 4 (minor instances of over-explanation) rather than anchor 3 (noticeably padded sections) or anchor 5 (nothing trimmable). | 4 / 5 |
Actionability | Concrete, executable guidance throughout: the formula "[Acknowledge the constraint clearly] + [State its specific impact on interpretation] + [Note mitigation taken or propose future direction]", four copy-adaptable worked examples covering the common cases (single-center, retrospective, short follow-up, internal validation), a quotable phrase bank, and per-context tone assembly rules. For an instruction-only skill this is the anchor-5 equivalent of copy-paste-ready code covering common cases; it is not 4 because no key execution detail is missing. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (collect → categorize → apply formula → assemble/calibrate → check) with an explicit validation checklist in Step 5 covering acknowledgment, impact, mitigation, repetition, tone consistency, and fabrication. This matches anchor 5 (explicit validation steps plus a checklist); the skill involves no destructive or batch operations, so no workflow cap applies. It is not 4 because the validation checkpoint is fully explicit, not merely implied. | 5 / 5 |
Progressive Disclosure | The body itself is well-sectioned with clear headers, but the provided bundle is never surfaced: neither references/audit-reference.md nor scripts/main.py is mentioned or linked anywhere in SKILL.md, so a reader would never discover that the script exists (it generates limitation statements from templates). Per the guideline to score against the actual bundle structure, this fits anchor 3 (structure present but references not clearly signaled); it is not 4 because the disconnect is total rather than a minor organization gap, and not 2 because the body's own structure is good and appropriately sized rather than a wall of inlined content. | 3 / 5 |
Total | 17 / 20 Passed |