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 a well-structured, actionable overview with a clear gated workflow and properly organized one-level-deep references to a real bundle. Its main weakness is moderate verbosity in the backend-selection prose and repeated hard-stop warnings that could be condensed.
Suggestions
Condense the image-generation backend-resolution section and collapse the repeated ⛔ hard-stop warnings into a single concise "Hard rules" block to improve token efficiency (conciseness).
Move the detailed Codex/Cursor runtime-discovery logic, which is runtime-specific, fully into references/codex-imagegen.md and keep only the resolution order in SKILL.md to reduce inline prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and procedural, but the image-generation backend-resolution prose and the repeated ⛔ hard-stop warnings (e.g., the elaborated "Never substitute SVG" and "Never repair rendered text" paragraphs) could be tightened; it is above level 1 because it avoids explaining concepts Claude already knows and is not padded with generic background. | 2 / 3 |
Actionability | Provides concrete, executable guidance throughout — exact file-naming conventions (NN-{type}-{slug}.md), EXTEND.md path tables, an AskUserQuestion question/option matrix, and an output-directory mapping table — which per the scoring notes satisfies actionability for an instruction-only skill without requiring code. | 3 / 3 |
Workflow Clarity | A clear 6-step sequenced workflow with explicit validation gates ("⛔ BLOCKING: Prompt files MUST be saved before ANY image generation", confirm-before-generate, retry-once-on-failure) provides the feedback loops the rubric requires for batch operations; it is not level 2 because checkpoints are explicit rather than implicit. | 3 / 3 |
Progressive Disclosure | The SKILL.md is a well-signaled overview with one-level-deep references — all referenced files (workflow.md, styles.md, style-presets.md, prompt-construction.md, codex-imagegen.md, usage.md, config/first-time-setup.md) exist as real bundle files — and content is appropriately split across them rather than nested multiple levels. | 3 / 3 |
Total | 11 / 12 Passed |