Content
63%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 well-structured, lean instruction-only skill with a sensible claim-first workflow and useful caption/check guidance, weakened by dangling references to nonexistent `_references` files and by guidance that stays one notch above pseudocode — no example caption, output-path convention, or Output Contract format. Wiring the referenced files into the bundle and adding one worked example would lift it substantially.
Suggestions
Ship the two referenced files (`../_references/section-patterns-and-story.md` and `../_references/submission-and-editorial-readiness.md`) in the bundle, or remove/inline the links — currently they dangle.
Add a worked example: one sample caption filled into the 4-question template plus a concrete output-path and source-ref convention.
Define the Output Contract concretely (field names or a short template) instead of a bare list of items to return.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no explanation of what a figure or matplotlib is, every section carries operational content. It falls short of level 5 due to minor redundancy: three consecutive bullets in 'Figure selection rules' ('Do not use matplotlib...', 'Keep figure text sparse', 'Any explanation longer than a short phrase belongs in the caption') restate the same point, and the 'Suggested tools' list duplicates the frontmatter metadata block. | 4 / 5 |
Actionability | The workflow names concrete tools ('use `generate_schematic_figure` with a precise prompt', 'use reproducible scripts or rendering tools, and keep the script path') and the caption template and image checks are specific, but there is no example caption, no concrete output-path convention, and the Output Contract is a bare noun list ('Return figure intent, output path, script path, source refs, and caption draft') with no format. This is more than level 2's high-level hints but lacks the completeness and copy-ready specificity of level 4. | 3 / 5 |
Workflow Clarity | The six-step workflow is a clear claim-first sequence with an inspection checkpoint (step 5: 'Inspect the figure for readability, labeling, and whether the intended comparison is obvious') reinforced by a checks checklist. It misses level 5 because there is no explicit feedback loop — what to do when inspection fails or when data/paths are missing beyond the single 'do not invent figures' guard — and the checkpoint is implicit rather than a validate-and-retry cycle. | 4 / 5 |
Progressive Disclosure | The body itself is well organized with clear sections, and the two references ('Read [../_references/section-patterns-and-story.md] for figure logic', 'Read [../_references/submission-and-editorial-readiness.md] before finalizing legends') are clearly signaled and purpose-annotated. However, the referenced files do not exist in the bundle — there is no `_references/`, `references/`, `scripts/`, or `assets/` directory — so the navigation structure is broken at the exact point it delegates detail, which the guideline to score against the actual bundle structure penalizes. It stays above level 2 because the inline content is well sectioned and references are clearly signaled, not buried. | 3 / 5 |
Total | 14 / 20 Passed |