Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, mostly actionable instruction-only skill with good SVG-style guidance and a parse-error recovery loop. Its weakness is the somewhat tangled, redundant "Show the result" section, which muddies the workflow and adds avoidable tokens.
Suggestions
Tighten the "Show the result" section by collapsing the overlapping caveats ("not the final validate and open step", the "do not wait for ..." list, and "do not call surface_open after every write") into a single concise rule so the workflow reads cleanly.
Reformat the new-SVG presentation flow as a short numbered sequence (write first frame → surface_open → refine) with the parse-error recovery step inline, making the checkpoints explicit instead of scattering them across conditional bullets.
Move the repeated "already mounted / do not reopen" and board/deck ownership rules into one clearly labeled bullet to remove cross-bullet redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude knows SVG, but the "Show the result" section repeats overlapping caveats ("not the final validate and open step", "do not wait for ... exhaustive validation", "do not call surface_open after every write") that could be tightened. | 2 / 3 |
Actionability | Gives concrete, executable guidance — "Keep `xmlns=...` on the root element", "Preserve existing `viewBox`, `width`, `height`", "call `surface_open` immediately with its workspace-rooted path (for example, `/poster.svg`)" — including a specific example path. | 3 / 3 |
Workflow Clarity | A parse-error feedback loop exists ("On `edit_file` reason=\"parse_error\" ... Re-read and fix"), but the "Show the result" sequence is presented as tangled conditional bullets rather than an ordered workflow, leaving checkpoints implicit. | 2 / 3 |
Progressive Disclosure | Under 50 lines with no external references, organized into clear sections ("## Show the result", "## SVG style") — well-organized enough to score 3 per the simple-skills note. | 3 / 3 |
Total | 10 / 12 Passed |