Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-architected, highly actionable skill body with a clear gated workflow and clean progressive disclosure into real reference files. Its only weakness is mild verbosity in the backend-resolution and policy prose.
Suggestions
Dedupe the 'Concrete tool names ... are examples — substitute the local equivalents' note (it appears in both User Input Tools and Image Generation Tools) into a single stated-once rule.
Trim the justificatory prose in the Image Generation Tools section (e.g., the quoted Codex imagegen description and the lengthy ⛔ rationale blocks) — keep the hard rule and one short reason, moving detail into references/codex-imagegen.md.
Consider relocating the large Auto-Selection and Style × Layout Matrix tables to a reference file, keeping only the pointer inline, to reduce the body's token footprint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's competence (no basic-concept padding), but the ~485-line body repeats the 'substitute the local equivalent' disclaimer twice and includes lengthy justification prose (e.g., the quoted Codex imagegen description, extended backend-resolution caveats) that could be tightened or moved to references. | 2 / 3 |
Actionability | Provides concrete, copy-paste-ready guidance: exact CLI flags, file-naming conventions (NN-{type}-{slug}.md), a directory tree, YAML frontmatter examples, and a linked executable invocation contract in references/codex-imagegen.md. | 3 / 3 |
Workflow Clarity | A clearly sequenced Step 0–4 workflow with an explicit BLOCKING gate, validation checkpoints (verify prompt files exist before batching, backup-before-overwrite), and a retry-once feedback loop for failures — matching the highest anchor. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview with one-level-deep, well-signaled references (verified present: presets/, palettes/, elements/, workflows/, config/), a navigation table mapping each file to its content, and content appropriately split across bundle files. | 3 / 3 |
Total | 11 / 12 Passed |