Content
77%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 dense, actionable rulebook with an exemplary render-then-verify loop and concrete parameters throughout. Its main weakness is that everything lives inline in SKILL.md — the long checklist and QA code would benefit from one-level-deep reference files so the overview stays light.
Suggestions
Split §6 chart-family guidance into a reference file (e.g. references/chart-families.md) and keep a one-line-per-family decision table in SKILL.md, with clearly signaled links.
Move the §9.1/§9.2 verification code into a scripts/ or references/qa.md file and keep only the workflow ('run bbox check → fix → re-save until clean → per-panel perceptual crop check') inline.
Add a short quick-start block showing a complete apply_figure_style() call plus one helper usage so the entry-point workflow is executable without reading the full checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Terse, rule-per-line prose that assumes Claude's competence (e.g. 'Never draw filled bars on a log-scaled value axis') with no explanation of known concepts, but §8 restates rules already given in §3.3, §4.5, and §1.1, which is minor trimmable repetition. | 4 / 5 |
Actionability | Concrete parameters throughout ('ax.margins(0.04)', 'wspace≤0.06', 'apply_figure_style(sizes=(8,7,6))') and two copy-paste-ready code blocks (§9.1 bbox check, §9.2 panel crops), but no complete end-to-end usage example for apply_figure_style() or the named helpers — a minor gap. | 4 / 5 |
Workflow Clarity | Explicit sequencing ('Load it and call apply_figure_style() before any plot'; §9 'After fig.savefig(...), before you finalize') with an explicit validate→fix→retry feedback loop ('Fix (move, shorten, stagger) and re-save until clean') and a per-panel perceptual checklist. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned (§0–§9) but is a single 330-line monolith with no bundle files and no file references; §6 chart-family guidance and the §9 verification code are candidates for separate reference files that could be loaded on demand. | 3 / 5 |
Total | 16 / 20 Passed |