Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clear, validated multi-step workflow and excellent progressive disclosure backed by a real, well-organized bundle. Its main weakness is length and redundancy between the backend-selection and image-generation sections.
Suggestions
Consolidate the overlapping backend-resolution rules in "Image Generation Tools" and "Step 7: Image Generation" into a single authoritative section referenced once, to reduce redundancy and tighten token use.
Tighten the two ⛔ prohibition rules (no SVG/code rendering, no text repair overlays) to concise one-line constraints with a brief rationale, moving extended justification to a reference file if needed.
Move the detailed EXTEND.md preference-edit examples and one-line backend-pin recipes (currently under "Changing Preferences") into references/config/preferences-schema.md, keeping only a pointer in the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and avoids explaining concepts Claude already knows, but it is long (~340 lines) with notable redundancy — backend resolution rules are restated across "Image Generation Tools" and "Step 7: Image Generation", and the two ⛔ prohibition rules are elaborated at length, so it could be tightened. | 2 / 3 |
Actionability | It provides concrete, copy-paste-ready guidance: specific commands (sips, pngquant, bun, npx), exact file naming and paths (prompts/NN-{cover|page}-[slug].md, characters/characters.png), flag options, and frontmatter YAML examples. | 3 / 3 |
Workflow Clarity | The 9-step process is clearly sequenced with a progress checklist, flow diagram, step summary table, and explicit validation/checkpoint gates (Step 1.1 BLOCKING, Step 2 REQUIRED, review gates at 4/6) plus feedback loops for batch/destructive operations (timestamped backup rule, retry-once policy, --ref failure recovery). | 3 / 3 |
Progressive Disclosure | SKILL.md is a clear overview with well-signaled, one-level-deep references (art-styles/, tones/, presets/, layouts/, config/, workflow.md, partial-workflows.md, codex-imagegen.md), all verified to exist, with content appropriately split per style/tone/preset rather than inlined. | 3 / 3 |
Total | 11 / 12 Passed |