Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill body is an actionable, well-sequenced orchestration guide with strong workflow gates and excellent progressive disclosure into a real reference bundle. Its main weakness is length and some repetition in the backend-selection material, which keeps conciseness below the top anchor.
Suggestions
Consolidate the image-backend selection logic into one place and have Step 4 reference it once, rather than restating the rule in both '## Image Generation Tools' and Step 4.
Move the detailed Codex/Cursor runtime caveats (aspect-ratio and output-path workarounds) into references/codex-imagegen.md or a runtime-compat reference, keeping only the routing decision inline.
Trim the repeated ⛔ prohibition paragraphs ('Never substitute SVG...', 'Never repair rendered text...') to a single concise rule set, since the same constraints reappear under 'Image Modification'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is thorough and mostly efficient, but at ~280 lines it could be tightened: the backend-resolution rule is stated in '## Image Generation Tools' and re-referenced in Step 4, and lengthy Codex/Cursor caveats sit inline where they might live in references. It does not waste tokens explaining concepts Claude already knows, so it clears score 2 but not the 'every token earns its place' bar. | 2 / 3 |
Actionability | Guidance is highly concrete and executable for an instruction-only skill: exact option names (--type, --palette, etc.) with their value sets, file paths, naming conventions (NN-{type}-[slug].md), a verification command ('test -f refs/ref-NN-{slug}.{ext}'), and specific backend tool names. No pseudocode vagueness is present. | 3 / 3 |
Workflow Clarity | A clear Steps 0–5 sequence is given with a progress checklist, a flow diagram, explicit blocking gates (Step 0 '⛔ BLOCKING', Step 2 hard gate), validation checkpoints ('Before writing → Verify: test -f ...'), backup-before-regenerate, and an 'On failure: auto-retry once' feedback loop—matching the score-3 anchor. | 3 / 3 |
Progressive Disclosure | The body is an overview that links one-level-deep into a real, well-organized bundle (dimensions/, palettes/, renderings/, workflow/, config/), with all cited paths verified to exist and a consolidated '## References' section for navigation. Content is appropriately split across files rather than inlined. | 3 / 3 |
Total | 11 / 12 Passed |