Content
81%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 tightly-written, highly actionable ruleset with a strong render-then-verify feedback loop and real executable code. Its weaknesses are the absence of any bundle files to split out the helper implementations, and minor verbosity/over-restatement in a few rules.
Suggestions
Move the helper implementations (focal_palette, bar_with_points, strip_with_median, end_of_line_labels, panel_letter, set_frame, panel_crops) into a referenced scripts/ file and link to it, so SKILL.md stays a lean overview and progressive disclosure goes from 4 to 5.
Trim restated rules (e.g. comparator-naming appears in both §2.1 and §5.6, and the closing maxim re-states §2 and §4) to tighten conciseness.
Add the concrete matplotlib call alongside rules that currently only name a check (e.g. the CVD check in §4.5 and the contrast check in §5.5) so every rule has an executable action.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and rule-packed with almost no padded concept explanation (no 'what is a PDF'-style filler), but it is long and a few rule comments and the closing maxim restate ideas, leaving minor trims available — efficient but not maximally lean. | 4 / 5 |
Actionability | Provides concrete, executable artifacts: real matplotlib calls (ax.margins(0.04), apply_figure_style(sizes=(8,7,6)), panel_letter(ax, 'a', case=...)) and a complete bbox-collision check snippet; minor gaps are that several rules describe what to check without the exact call to perform it. | 4 / 5 |
Workflow Clarity | Sequences the work explicitly (§0 scope, §1–§9 rules, then §9 render-then-verify) and §9 gives an ordered feedback loop: savefig -> geometric bbox check (assert overlaps==[]) -> fix and re-save until clean -> per-panel perceptual crop check, with explicit 'only finalize after clean' gating. | 5 / 5 |
Progressive Disclosure | Well-organized into nine numbered sections with a clear scope header and forward references to figure-composer and paper-narrative, but the document is a single monolithic SKILL.md with no references/ scripts/ or assets/ bundle files, so the helper inventory (focal_palette, bar_with_points, etc.) lives only in prose rather than being split into referenced files. | 4 / 5 |
Total | 17 / 20 Passed |