Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable analysis skill with a clear sequenced workflow and validation gate. Its main weaknesses are redundant restatement of the same quality rules and several dangling references to non-existent files.
Suggestions
Consolidate the repeated rules (real figures, no fabricated stats, complete statistics) so they appear once — in the Non-negotiable quality bar or the QA gate — rather than restated across all three sections, to tighten the body.
Fix or remove the broken references: the three files listed under "Example files" (examples/example-*.md) and ../research-ideation/references/research-contract.md do not exist in the bundle, so the dead links currently break navigation.
Move inline template and example content (the full Claim Candidates block and the Failure mode policy examples) into reference files to keep SKILL.md a lean overview pointing one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational guidance with no concept padding, but core rules (prefer real figures, never fabricate stats, report complete statistics) are restated across the Non-negotiable quality bar, Standard workflow, and Final QA gate and could be tightened. | 2 / 3 |
Actionability | Provides concrete, copy-paste-ready guidance: named artifacts (analysis-report.md, stats-appendix.md, figure-catalog.md), exact required figure elements, a Claim Candidates template, and an explicit output tree. | 3 / 3 |
Workflow Clarity | A clear 6-step sequenced workflow ends in an explicit 10-item QA validation gate, with feedback loops such as quarantining contradictory stats files until provenance is checked. | 3 / 3 |
Progressive Disclosure | Six references/*.md files exist and are well-signaled one level deep, but four referenced paths are broken (the three examples/*.md and ../research-ideation/references/research-contract.md do not exist), which breaks navigation. | 2 / 3 |
Total | 10 / 12 Passed |