Image Validator

Quality gate for tacosdedatos illustrations.

Reference: agents/shared/illustration-style-guide.md for authoritative mode definitions and color palette.

Validation Process

Step 1: Identify the Mode

First, determine which of the 7 modes the image fits (or should fit):

If no mode fits: Flag as potentially off-brand.

Step 2: Run the Checklist

Check each criterion:

Core Requirements

Color Validation

Check against palette:

Tolerance: Colors don't need to be exact hex matches, but should be recognizably from the palette family. Flag if:

• Bright/saturated colors outside palette
• Pastel tones
• Neon colors
• Pure white backgrounds

Human Figure Check (if present)

Step 3: Score and Verdict

Scoring:

• Each core criterion: 1 point
• Total possible: 7 points

Verdicts:

Output Format

Provide structured feedback:

## Image Validation Report

### Verdict: [PASS / PASS WITH NOTES / NEEDS REVISION / FAIL]

**Score**: X/7

### Mode Identified
[Mode name] - [Confidence: High/Medium/Low]

### Checklist Results

| Criterion | Result | Notes |
|-----------|--------|-------|
| Mode fit | ✓/✗ | |
| Color palette | ✓/✗ | |
| Texture | ✓/✗ | |
| No text | ✓/✗ | |
| Metaphor clarity | ✓/✗ | |
| Negative space | ✓/✗ | |
| Aspect ratio | ✓/✗ | |

### Issues Found
1. [Specific issue]
2. [Specific issue]

### Recommended Fixes
1. [Actionable fix]
2. [Actionable fix]

### Prompt Adjustment (if regenerating)
[Specific prompt changes to make]

Common Issues & Fixes

Issue: Unwanted Text

Detection: Any letters, numbers, words, labels visible

Fix: Add to negative prompt:

Absolutely no text, no letters, no words, no writing, no labels, no numbers, no watermarks

Issue: Wrong Colors

Detection: Colors outside palette (bright, pastel, neon)

Fix: Add explicit hex codes:

Colors MUST use only: #121212, #F1FAEE, #E63946, #A8DADC, #F4A261, #4E937A

Issue: Too Cluttered

Detection: No clear focal point, busy composition

Fix: Simplify prompt:

Single focal element. Generous negative space. Minimal composition. Clean and simple.

Issue: Missing Texture

Detection: Flat, plastic, or glossy appearance

Fix: Add texture cues:

Subtle risograph grain texture throughout. Matte finish. No glossy surfaces.

Issue: Photorealistic Style

Detection: Looks like a photo or 3D render

Fix: Emphasize style:

Flat digital illustration. No photorealism. No 3D render. No realistic textures.

Issue: Generic/Stock Style

Detection: Looks like corporate clip art or stock illustration

Fix: Be more specific about style:

In the style of modern editorial illustration. Sophisticated and unique. Not corporate clip art.

Issue: Wrong Aspect Ratio

Detection: Square or portrait orientation

Fix: Specify in generation settings:

aspect_ratio="16:9" or aspect_ratio="3:2"

Quick Validation (for simple checks)

For fast validation without full report:

## Quick Check: [Title]

**Verdict**: [PASS/FAIL]

**Key Issues** (if any):
- [Issue 1]
- [Issue 2]

**Fix**: [One-line recommendation]

Validation Examples

Example 1: PASS

Image: Abstract geometric shapes flowing into brain network

## Image Validation Report

### Verdict: PASS

**Score**: 7/7

### Mode Identified
Abstract/Geometric - Confidence: High

### Checklist Results

| Criterion | Result | Notes |
|-----------|--------|-------|
| Mode fit | ✓ | Clear geometric/abstract style |
| Color palette | ✓ | Uses #121212, #F1FAEE, #E63946, #A8DADC |
| Texture | ✓ | Subtle grain visible |
| No text | ✓ | Clean, no text |
| Metaphor clarity | ✓ | Clear AI/processing metaphor |
| Negative space | ✓ | Good breathing room |
| Aspect ratio | ✓ | Landscape 16:9 |

### Issues Found
None

### Recommended Fixes
None - ready for publication

Example 2: NEEDS REVISION

Image: Cartoon character but with text label

## Image Validation Report

### Verdict: NEEDS REVISION

**Score**: 5/7

### Mode Identified
Playful Cartoon - Confidence: High

### Checklist Results

| Criterion | Result | Notes |
|-----------|--------|-------|
| Mode fit | ✓ | Matches playful cartoon style |
| Color palette | ✓ | On-brand colors |
| Texture | ✗ | Too smooth, needs grain |
| No text | ✗ | Text label visible on character |
| Metaphor clarity | ✓ | Clear concept |
| Negative space | ✓ | Good composition |
| Aspect ratio | ✓ | Correct landscape |

### Issues Found
1. Text label "AI" visible on character's shirt
2. Missing subtle texture/grain

### Recommended Fixes
1. Regenerate with stronger "no text" negative
2. Add "subtle risograph grain texture" to prompt

### Prompt Adjustment
Add: "Absolutely no text, no letters, no writing. Subtle risograph grain texture throughout."

Integration Notes

This skill can be called:

• By tacosdedatos-illustrator: After generation, before delivery
• Standalone: When reviewing uploaded images
• By other agents: Editor-in-Chief reviewing visual assets

The validator does not generate images—it only evaluates them.