Content
78%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 highly actionable, well-sequenced skill body with executable code and validation checkpoints for batch figure generation. Its main weaknesses are structural redundancy between sections and a lack of progressive disclosure into separate reference files despite its length.
Suggestions
Move the Figure Type Reference table and full per-figure code templates into a references/ file (e.g. FIGURE_TYPES.md), keeping SKILL.md as an overview that links one level deep, to improve progressive disclosure.
De-duplicate the Step 3 decision tree with the Figure Type Reference table and merge overlapping items between Key Rules and the Step 8 checklist to tighten conciseness.
Add an explicit fix-and-retry feedback loop after the Step 5 render-then-verify check (e.g. "if any label is clipped or legend overlaps data, adjust the script and re-run before proceeding to review") to lift workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and assumes Claude's competence (no explaining of matplotlib or PDF basics), but the Step 3 decision tree duplicates the Figure Type Reference table and Key Rules repeats several Step 8 checklist items, so it could be trimmed. | 4 / 5 |
Actionability | Provides fully executable, copy-paste-ready code for the shared style config, line plots, bar charts, LaTeX tables, include snippets, and a bash run loop, covering the common figure cases. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced steps with an explicit render-then-verify validation checkpoint and a quality checklist; the batch operation has validation so avoids the 3-cap, but it lacks an explicit fix-and-retry feedback loop. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the ~310-line skill is monolithic; it has good internal section headers, but content such as the Figure Type Reference table and full code templates that could live in separate referenced files is inlined. | 3 / 5 |
Total | 16 / 20 Passed |