Content
86%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, token-efficient SOP that assumes Claude's competence and gives exact paths, parameters, and conventions. The main gaps are the absence of an executable example script and of explicit post-render validation checkpoints, which keep actionability and workflow clarity just below full marks.
Suggestions
Add a short copy-paste-ready matplotlib snippet (one full example script for a line chart with title, labelled axes, and the specified save call) to lift actionability to fully executable.
Add an explicit validation step after rendering (e.g. confirm the PNG exists and is non-empty, and check the data frame is non-empty before plotting) to close the workflow-clarity checkpoint gap.
Mention the US spelling 'visualize' and the synonym 'graph' in the description's trigger phrases to broaden natural trigger coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | A lean SOP with no padding: every section directs action (decision table, render conventions, anti-patterns, delegation rule) and nothing explains concepts Claude already knows. Every token earns its place. | 5 / 5 |
Actionability | Concrete guidance throughout — exact paths (knowledge/charts/<topic>.png, scratch/charts/<topic>.py), exact parameters (bbox_inches='tight', dpi=150), named pandas methods, and the markdown embed syntax — but no executable example script to copy, so it falls short of fully copy-paste-ready guidance. | 4 / 5 |
Workflow Clarity | Five clearly sequenced steps with an explicit decision checkpoint ("If none fit, ask the user"), but post-render validation is implicit — no step verifies the PNG was produced or the data is sane — so it does not meet the 5 anchor's explicit validate/fix/retry loop. | 4 / 5 |
Progressive Disclosure | A single self-contained file of appropriate length with well-organized sections (Steps, Anti-patterns, When to delegate) and no bundle files; nothing inlined that belongs in a separate reference. Per the simple-skill guidance this earns full marks. | 5 / 5 |
Total | 18 / 20 Passed |