Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured body with executable code for both Python and R, a clearly sequenced figure-contract workflow with explicit gates, and a clean one-level-deep reference table. The only weakness is repetition of the backend-exclusivity and privacy rules, which inflates token count.
Suggestions
Consolidate the backend-exclusivity rule into a single authoritative statement; the rule is currently restated ~4 times across the 'First move' gate, the 'Python-only execution rule' section, and the contract step list.
Merge the top-level 'User-facing privacy rule' section with the brief privacy note near the top to avoid echoing the same guidance twice.
Move the detailed render-inspect-revise QA loop inline (or ensure qa-contract.md is invoked explicitly in the contract steps) so the validation feedback loop is visible in the main workflow rather than only referenced.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient (tight rcParams/theme code, bullet stances) but the backend-exclusivity rule is restated ~4 times across 'First move', 'Python-only execution rule', and contract steps, and the privacy rule is echoed, so it could be tightened rather than earning 'every token earns its place'. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready code for both backends (Python rcParams + save_pub_py exporting svg/pdf/tiff; R theme_set + save_pub_r using svglite/cairo_pdf/ragg::agg_tiff) with specific archetypes and formats, matching the 'fully executable code/commands' anchor. | 3 / 3 |
Workflow Clarity | Clear sequenced 5-step figure contract with explicit blocking gate ('ask Python or R? Then stop') and a missing-runtime checkpoint ('stop before rendering and report the exact blocker'), matching the 'clear sequence with explicit validation steps; feedback loops' anchor. | 3 / 3 |
Progressive Disclosure | SKILL.md is a concise overview with a well-signaled one-level-deep 'Related files' table of 11 real reference files (all verified present), each with an 'Open when' trigger, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 3 / 3 |
Total | 11 / 12 Passed |