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.
An exemplary router-style SKILL.md: lean, well-sequenced, with explicit validation loops and disciplined on-demand reference loading for the files that do ship. The main weakness is that the core layer it routes to (manifest, core/*.md, static fragments, shared terminology ledger) is not present in the bundle, and the audit-script invocation lacks a concrete command.
Suggestions
Ship the routing targets in the bundle — manifest.yaml, the core/*.md files, the static/ paper-type fragments, and the shared terminology ledger — or inline a minimal fallback in SKILL.md so step 1 does not dead-end when they are unavailable.
Show the exact audit invocation (e.g., `python scripts/audit_pptx_quality.py output/deck.pptx`) with its key arguments and output format so the QA gate is copy-paste executable.
Add a one-line example of the paper_type confirmation message and a compact Terminology Ledger entry format to make those two steps unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean ~60-line router with zero concept explanations and no padding — every sentence directs action ("Read manifest.yaml", "Do not read every fragment in static/", "Reuse already loaded guidance on follow-ups"). It assumes Claude's competence and every token earns its place. | 5 / 5 |
Actionability | Gives concrete, executable direction: named file paths, a six-value paper_type taxonomy with detection criteria, a five-priority application order, an on-demand table mapping tasks to specific reference files, and a named audit script and report path. Not 5 because the audit script is never shown with its invocation command or arguments, and steps like the Terminology Ledger and the classification announcement lack a concrete example. | 4 / 5 |
Workflow Clarity | A clear five-step numbered sequence with an explicit validation feedback loop: "run scripts/audit_pptx_quality.py. Treat high-severity findings as blockers, revise the deck, then re-run the audit and record the final result in output/qa_report.md" — an audit→fix→re-run loop, plus a mid-process checkpoint ("State the detected value in one short line... so they can correct you cheaply") and an edit-path rule to re-audit before delivery. | 5 / 5 |
Progressive Disclosure | The router design is good — overview-only body, one-level-deep references, an explicit on-demand table — and all files under references/ and scripts/ exist and match their descriptions. But the primary routing targets the body instructs to read (manifest.yaml, core/principles.md, core/toolchain.md, core/workflow.md, core/output-and-quality.md, static/ fragments, ../nature-shared/core/terminology-ledger.md) are absent from the provided bundle, so step 1 dead-ends; scored against the actual bundle structure this is more than the minor gap of a 4. | 3 / 5 |
Total | 17 / 20 Passed |