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 well-structured, highly actionable skill body with an exemplary multi-step workflow (checklist, hard gates, feedback loops) and clean progressive disclosure into real bundle files. Its main weakness is moderate verbosity in the runtime/backend-branching sections.
Suggestions
Collapse the repeated "Concrete tool names are examples — substitute the local equivalent" caveat into a single early note to remove redundancy.
Tighten the multi-runtime backend branching (Codex/Cursor/Hermes) into a compact table or a single resolution rule, moving per-runtime detail into references/codex-imagegen.md-style files.
Consider trimming the 17-row auto-selection table to the highest-signal rows and letting references/dimensions/presets.md carry the rest.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and skill-specific (presets, options, paths), but includes trimming opportunities such as the "Concrete tool names ... are examples" caveat repeated twice and verbose per-runtime branching for Codex/Cursor/Hermes. It is not a 4 because several sections could be tightened without losing clarity. | 3 / 5 |
Actionability | Provides concrete commands (exact ${BUN_X} script invocations), file paths, naming conventions, and a copy-paste YAML frontmatter example. It is not a 5 because the image-generation step itself is intentionally abstract (delegated to a runtime-dependent backend rule) rather than a single copy-paste command. | 4 / 5 |
Workflow Clarity | A 9-step workflow with a copyable checklist, numbered sub-steps, explicit hard gates ("REQUIRED before Step 2", prompt-file existence as a hard requirement), and feedback loops in the conditional review steps (edit/regenerate). Batch and overwrite operations carry explicit validation and retry rules, satisfying the destructive/batch cap. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview pointing to one-level-deep references that all exist on disk (styles/<preset>.md, dimensions/*.md, confirmation.md, codex-imagegen.md, scripts/*), with a References table and well-signaled in-text pointers. Content is appropriately split with no reference-ception nesting. | 5 / 5 |
Total | 17 / 20 Passed |