Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.
82
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/.curated/imagegen/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines its scope with specific capabilities, abundant natural trigger terms, explicit 'Use when' and 'Do not use when' clauses, and strong boundary-setting to avoid conflicts with related skills. It uses proper third-person voice throughout and avoids vague language or buzzwords. One of the strongest descriptions possible, covering all rubric dimensions thoroughly.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and output types: 'generate or edit raster images', 'photos, illustrations, textures, sprites, mockups, transparent-background cutouts', 'create a brand-new image, transform an existing image, derive visual variants from references'. Very detailed enumeration of capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (generate/edit raster images including photos, illustrations, textures, sprites, mockups, cutouts) and 'when' (explicit 'Use when' clause for creation, transformation, and variant derivation, plus a 'Do not use when' clause that further clarifies boundaries). Exemplary completeness. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'photos', 'illustrations', 'textures', 'sprites', 'mockups', 'cutouts', 'bitmap', 'raster images', 'image', 'transparent-background'. These are terms users would naturally use when requesting image generation or editing tasks. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with explicit boundary-setting: specifies 'bitmap asset rather than repo-native code or vector' and includes a 'Do not use when' clause that distinguishes it from SVG/vector editing, icon systems, and HTML/CSS/canvas work. This makes it very unlikely to conflict with code-based or vector-based visual skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
54%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is well-structured with excellent progressive disclosure and a thorough workflow, but suffers significantly from verbosity and repetition. The same rules about built-in vs CLI mode, save-path policy, and fallback disclaimers are restated numerous times throughout the document, wasting substantial token budget. Actionability is moderate—the prompt schema and examples are helpful, but the skill lacks concrete tool invocation examples for the primary (built-in) mode.
Suggestions
Consolidate the repeated 'built-in by default, CLI only if explicit' rule into a single authoritative statement at the top, and remove the 6+ redundant restatements throughout the document to cut token usage significantly.
Add a concrete example of an actual `image_gen` built-in tool call (showing the tool invocation syntax Claude would use) rather than only describing the workflow abstractly.
Remove or drastically shorten the 'Fallback CLI mode only' section since it already defers to reference files—a single paragraph pointing to references/cli.md would suffice.
Eliminate redundant save-path policy restatements (appears in rules, workflow steps 14-15, and built-in save-path policy section) by consolidating into one concise block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~250+ lines. It repeatedly restates the same rules (e.g., 'built-in by default, CLI only if explicit' is stated 8+ times; save-path policy is reiterated multiple times). Many sections explain things Claude already knows or could infer, and the constant 'fallback-only' disclaimers add significant redundancy. | 1 / 3 |
Actionability | The skill provides a structured prompt schema, taxonomy slugs, and two concrete prompt examples, which are useful. However, it lacks executable code examples for the built-in tool usage (no actual `image_gen` tool call syntax shown), and the workflow steps are procedural descriptions rather than copy-paste-ready commands. The CLI section defers most concrete details to reference files. | 2 / 3 |
Workflow Clarity | The 17-step workflow is clearly sequenced with explicit decision points (mode selection, intent classification, execution strategy), validation steps (step 12: inspect outputs), iteration guidance (step 13), and clear save-path handling with non-destructive defaults. The decision tree for generate vs edit is well-structured with explicit criteria. | 3 / 3 |
Progressive Disclosure | The skill has a clear reference map at the bottom with well-signaled one-level-deep references. Shared resources vs fallback-only resources are clearly separated. Content is appropriately split between the main skill file and reference documents (prompting.md, cli.md, image-api.md, sample-prompts.md). | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
0ed2046
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.