Content
72%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.
The router is well-sequenced with concrete scripts, explicit validation checkpoints, and a disciplined load-on-demand philosophy. However, the entire routing protocol hinges on a manifest.yaml and a static/ fragment layer that are not present in the bundle, which breaks the progressive-disclosure structure it advertises.
Suggestions
Ship the missing manifest.yaml and static/ files (contract.md, stance.md, fragments/backend/python.md and r.md) that steps 1–3 require, or rewrite the router to inline the minimal contract/stance so it is self-sufficient.
Move the inline NMI legend-word-count guidance fully into the nature-machine-intelligence.md reference and reference it by pointer, keeping the router to the routing rule.
Verify the ../nature-shared/journal-formats/nature-machine-intelligence.md path resolves from the skill directory, since a broken relative path silently disables the NMI branch.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The router is lean for its scope and repeatedly tells Claude to load fragments from disk rather than reproducing them, but it still re-explains journal-specific rules inline (e.g., the full NMI word-count advisory and 'count the whole legend, not each panel') that belong in the loaded reference, leaving minor over-explanation to trim. | 4 / 5 |
Actionability | Concrete, executable commands are given throughout (`scripts/nature_figure_backend.py set python`, `scripts/nature_figure_backend.py get`, `scripts/validate_figure.py`, `scripts/audit_pdf_text.py`) with exact file paths to Read; it stops just short of copy-paste-ready examples because the actual code/quick-start lives in the on-demand fragments by design. | 4 / 5 |
Workflow Clarity | A clearly numbered routing protocol (0–5) sequences every invocation with a blocking backend gate, an ordered build step, and an explicit delivery preflight with validation checkpoints (validate_figure.py → audit_pdf_text.py → panel-by-panel audit), plus error-recovery framing ('If no saved preference exists, ask… and stop'). | 5 / 5 |
Progressive Disclosure | Although the body signals many on-demand references, several core paths it instructs Claude to load are missing from the bundle (manifest.yaml, static/core/contract.md, static/core/stance.md, static/fragments/backend/python.md and r.md, ../nature-shared/journal-formats/nature-machine-intelligence.md) — the central routing mechanism is broken because the static layer and manifest the whole protocol depends on are absent, so the disclosure structure does not actually resolve. | 2 / 5 |
Total | 15 / 20 Passed |