Content
77%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 thorough, well-structured skill body with strong workflow gating, recovery loops, and clean one-level-deep progressive disclosure. Its weakness is conciseness: backend-resolution rules and the Notes section repeat content already covered elsewhere.
Suggestions
Consolidate the image-backend resolution logic into the 'Image Generation Tools' section and have 'Step 7' reference it once instead of restating the rules and the codex-imagegen contract.
Trim or remove the 'Notes' section, which largely restates earlier policy (retry-once, character-sheet guidance, --ref fallback); keep only items not already stated in context.
Add one concrete inline example of a complete image-generation invocation (or a minimal prompt-file frontmatter + backend call) so the core render step is executable without loading a reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational and dense, but the image-backend resolution rules are stated in 'Image Generation Tools', restated in 'Step 7', and the codex-imagegen contract is pointed to multiple times; the 'Notes' section rehashes earlier points — several sections could be tightened. | 3 / 5 |
Actionability | Concrete file-naming conventions (NN-{type}-[slug].md), explicit paths, an options table with real values, and runnable commands (sips, pngquant, bun, npx); the core image invocation is deferred to references rather than spelled out inline, leaving minor gaps. | 4 / 5 |
Workflow Clarity | A progress checklist, flow diagram, step-summary table, blocking gates (⛔ BLOCKING), file-existence verification, a backup-before-regenerate rule, and a compress→retry→drop-ref recovery loop provide explicit validation checkpoints and feedback loops for batch/destructive operations. | 5 / 5 |
Progressive Disclosure | The body is a well-signaled overview pointing one level deep to real files (codex-imagegen.md, partial-workflows.md, auto-selection.md, workflow.md, art-styles/*, tones/*, presets/*, config/*) with load-on-demand cues like 'load that file only when this branch is selected'. | 5 / 5 |
Total | 17 / 20 Passed |