Content
88%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-engineered, highly actionable skill body: a 12-step workflow with embedded validation commands, feedback loops, and fail-closed human gates, backed by a real bundle whose files all exist. Minor deductions for unsignaled reference files, time-sensitive dates outside a deprecation section, and the promotional citation tail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of padding — no explanations of concepts Claude already knows, and lists are tight — but there are minor trimming targets: time-sensitive dates outside any 'old patterns/deprecated' section ("rechecked on 2026-10-01", "21 July 2026", "January 2026"), and a tail self-citation section that is not core instruction. Not 5: those few tokens don't earn their place; not 3: nothing rises to 'unnecessary explanation', only minor trims. | 4 / 5 |
Actionability | Every workflow step ships copy-paste-ready commands with full arguments (e.g. `python3 scripts/scaffold_manuscript.py --output-dir ./draft-workspace --document-id local-draft --study-design randomized_trial --guideline consort-2025`, plus seven other fully-specified script invocations), a concrete ID scheme (E/C/N/M/O/R), and an exact inline claim marker format. Fully executable with the common cases covered. | 5 / 5 |
Workflow Clarity | A clearly sequenced 12-step workflow with explicit validation checkpoints at steps 6, 7, 8, 11, and 12, feedback loops ("Resolve every mismatch manually", "re-run every affected audit", fix-and-re-validate), and human approval gates for every consequential action. The revision section adds a 7-step per-change loop. This matches the anchor 5 pattern of validate → fix → retry with checklists. | 5 / 5 |
Progressive Disclosure | Good structure: the body is an overview with one-level-deep references that all exist on disk, each contextually signaled ("See references/evidence_workflow.md") and enumerated in a Bundled files section. Not 5: two reference files (`references/source_ledger.md`, `references/citation_styles.md`) appear only in the file listing with no contextual pointer from the workflow steps where they'd be relevant, so navigation into them is not well-signaled. | 4 / 5 |
Total | 18 / 20 Passed |