Content
73%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, workflow-driven skill body with explicit sequencing, validation checkpoints, and strong progressive disclosure into a verified bundle of executable recipe files. Its weaknesses are redundancy (duplicated install guidance and three overlapping output-contract sections) and a dangling 'examples/' reference.
Suggestions
Merge 'Missing dependency behavior' into step 0 and collapse 'Define the delivery contract', 'Output style rules', and 'Recommended response shape' into a single section to remove the duplicated install commands and overlapping output guidance.
Remove or fix the 'For prompt-shaped examples, see examples/' pointer — the directory does not exist in the bundle.
Inline one minimal runnable pubfig snippet (fig = pf.line(...); pf.save_figure(fig, 'figure1.pdf')) in step 4 so the primary generation route is copy-paste ready without leaving the main file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body does not explain concepts Claude already knows, but it is noticeably redundant: the install command list appears in full twice (step 0 and 'Missing dependency behavior'), and three sections — 'Define the delivery contract', 'Output style rules', and 'Recommended response shape' — restate overlapping output guidance. This fits anchor 3 (mostly efficient, could be tightened) rather than anchor 4, whose 'minor instances' understate this level of duplication. | 3 / 5 |
Actionability | Environment probing, install fallbacks, and route selection are fully executable ('python3 scripts/ensure_publication_tooling.py --require pubfig --json', 'uv pip install pubfig'), and the runnable artifact code lives in well-mapped reference files. However, the body itself never shows a runnable snippet for the primary generation task — 'one pubfig call + one save_figure(...)' and 'batch_export(...)' are named but never demonstrated — leaving minor gaps versus anchor 5's copy-paste-ready coverage of common cases. | 4 / 5 |
Workflow Clarity | The workflow is an explicitly numbered 8-step sequence (0-7) with validation checkpoints throughout: probe → auto-install → re-probe → continue/degrade, an evidence-contract gate ('Do not create a paper-ready plot while the unit of analysis, missing-cell handling, or error-bar basis is unresolved'), a concrete QA step, and a revise loop with specific falsifiable changes. This matches anchor 5's explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview with a well-annotated Resources section pointing to 13 one-level-deep files, all of which exist in the bundle (references/, scripts/, source-guides/ verified on disk). It falls short of anchor 5 because the closing pointer 'For prompt-shaped examples, see examples/' references a directory that does not exist in the bundle, a dangling navigation link. | 4 / 5 |
Total | 16 / 20 Passed |