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 instruction-only skill with a clear workflow, explicit validation gates, and concrete formats, caps, and examples. The main weaknesses are mild redundancy (the fabrication rule repeated three times) and bundle files (a guided CLI script and audit reference) that are never surfaced from the body.
Suggestions
Consolidate the repeated no-fabrication rules into the Hard Rules section and remove the duplicates from Step 2 and the Citation Placeholder Density Rule.
Add a brief section pointing to scripts/main.py for users who want the interactive guided framework, and clarify whether references/audit-reference.md is user-facing or internal tooling.
Add an explicit feedback loop after the Step 3 checklist: instruct to revise the draft for any failed check and re-verify before delivery.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient instruction-only guidance with no padding that explains concepts Claude already knows, but the no-fabrication rule is stated three times (literature comparison rules, Hard Rules, and the Citation Placeholder Density Rule) and Step 2 partially restates the Recommended Discussion Structure, so some trimming is possible. | 4 / 5 |
Actionability | Guidance is fully concrete: the 6-part structure with sentence counts, the limitation format "[Constraint] → [Impact on interpretation] → [How future work could address it]", the placeholder syntax "[CITE: study showing similar/contrasting result]", quantitative caps ("Maximum 4 placeholders per 400 words"), word/paragraph calibration per manuscript type, and a worked example ("HR 1.43, 95% CI 1.12–1.82"). For an instruction-only skill this is copy-paste-ready guidance. | 5 / 5 |
Workflow Clarity | The four-step sequence (collect inputs → draft → revise checklist → deliver) is clearly ordered with explicit input validation ("If key results are not provided, ask before writing") and an 8-item verification checklist, but there is no explicit fix-and-re-verify feedback loop after the checklist, matching anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Sections are well organized and all body content is appropriately inlined for a ~140-line skill, but bundle files exist (scripts/main.py, references/audit-reference.md) that the body never references or surfaces, leaving a minor navigation gap consistent with anchor 4 rather than the fully navigable anchor 5. | 4 / 5 |
Total | 17 / 20 Passed |