SEO Image Gen: AI Image Generation for SEO Assets (Extension)
Generate production-ready images for SEO use cases using Gemini's image generation
via the banana Creative Director pipeline. Maps SEO needs to optimized domain modes,
aspect ratios, and resolution defaults.
Architecture Note
This extension is built on Claude Banana,
the standalone AI image generation skill for Claude Code.
This skill has two components with distinct roles:
- SKILL.md (this file): Handles interactive
/seo image-gen commands for generating images
- Agent (
agents/seo-image-gen.md): Audit-only analyst spawned during /seo audit to assess existing OG/social images and produce a generation plan (never auto-generates)
Prerequisites
This skill requires the banana extension to be installed:
./extensions/banana/install.sh
Check availability: Before using any image generation tool, verify the MCP server
is connected by checking if gemini_generate_image or set_aspect_ratio tools are
available. If tools are not available, inform the user the extension is not installed
and provide install instructions.
Quick Reference
| Command |
What it does |
/seo image-gen og <description> |
Generate OG/social preview image (1200x630 feel) |
/seo image-gen hero <description> |
Blog hero image (widescreen, dramatic) |
/seo image-gen product <description> |
Product photography (clean, white BG) |
/seo image-gen infographic <description> |
Infographic visual (vertical, data-heavy) |
/seo image-gen custom <description> |
Custom image with full Creative Director pipeline |
/seo image-gen batch <description> [N] |
Generate N variations (default: 3) |
SEO Image Use Cases
Each use case maps to pre-configured banana parameters:
| Use Case |
Aspect Ratio |
Resolution |
Domain Mode |
Notes |
| OG/Social Preview |
16:9 |
1K |
Product or UI/Web |
Clean, professional, text-friendly |
| Blog Hero |
16:9 |
2K |
Cinema or Editorial |
Dramatic, atmospheric, editorial quality |
| Schema Image |
4:3 |
1K |
Product |
Clean, descriptive, schema ImageObject |
| Social Square |
1:1 |
1K |
UI/Web |
Platform-optimized square |
| Product Photo |
4:3 |
2K |
Product |
White background, studio lighting |
| Infographic |
2:3 |
4K |
Infographic |
Data-heavy, vertical layout |
| Favicon/Icon |
1:1 |
512 |
Logo |
Minimal, scalable, recognizable |
| Pinterest Pin |
2:3 |
2K |
Editorial |
Tall vertical card |
Generation Pipeline
For every generation request:
- Identify use case from command or context (og, hero, product, etc.)
- Apply SEO defaults from the use cases table above
- Set aspect ratio via
set_aspect_ratio MCP tool
- Construct Reasoning Brief using the banana Creative Director pipeline:
- Load
references/prompt-engineering.md for the 6-component system
- Apply domain mode emphasis (Subject 30%, Style 25%, Context 15%, etc.)
- Be SPECIFIC and VISCERAL: describe what the camera sees
- Generate via
gemini_generate_image MCP tool
- Post-generation SEO checklist (see below)
Check for Presets
If the user mentions a brand or has SEO presets configured:
# Use the installed Banana MCP/tool configuration to list presets.
Load matching preset and apply as defaults. Also check references/seo-image-presets.md
for SEO-specific preset templates.
Post-Generation SEO Checklist
After every successful generation, guide the user on:
- Alt text:Write descriptive, keyword-rich alt text for the generated image
- File naming:Rename to SEO-friendly format:
keyword-description-widthxheight.webp
- WebP conversion:Convert to WebP for optimal page speed:
magick output.png -quality 85 output.webp
- File size:Target under 200KB for hero images, under 100KB for thumbnails
- Schema markup:Suggest
ImageObject schema for the generated image:{
"@type": "ImageObject",
"url": "https://example.com/images/keyword-description.webp",
"width": 1200,
"height": 630,
"caption": "Descriptive caption with target keyword"
}
- OG meta tags:For social preview images, remind about:
<meta property="og:image" content="https://example.com/images/og-image.webp" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:alt" content="Descriptive alt text" />
Cost Awareness
Image generation costs money. Be transparent:
- Show estimated cost before generating (especially for batch)
- Log every generation in the installed Banana MCP/tool ledger when available
- Use the installed Banana MCP/tool usage summary if user asks about usage
Approximate costs:
- Verify current pricing in the installed MCP/tool configuration before quoting
Model Routing
| Scenario |
Model |
Why |
| OG images, social previews |
Installed MCP/tool default @ 1K |
Fast, cost-effective |
| Hero images, product photos |
Installed MCP/tool quality model @ 2K |
Quality + detail |
| Infographics with text |
Installed MCP/tool text-capable model @ 2K, thinking: high if supported |
Better text rendering |
| Quick drafts |
Installed MCP/tool draft model @ 512 |
Rapid iteration |
Error Handling
| Error |
Resolution |
| MCP not configured |
Run ./extensions/banana/install.sh |
| API key invalid |
New key at https://aistudio.google.com/apikey |
| Rate limited (429) |
Wait 60s, retry. Free tier: ~10 RPM / ~500 RPD |
IMAGE_SAFETY |
Rephrase prompt - see references/prompt-engineering.md Safety section |
| MCP unavailable |
Configure MCP with ./extensions/banana/install.sh; claude-seo does not vendor a local generation fallback script |
| Extension not installed |
Show install instructions: ./extensions/banana/install.sh |
Cross-Skill Integration
- seo-images (analysis) feeds into seo-image-gen (generation): audit results from
/seo images identify missing or low-quality images; use those findings to drive /seo image-gen commands
- seo-audit spawns the seo-image-gen agent (not this skill) to analyze OG/social images across the site and produce a prioritized generation plan
- seo-schema can consume generated images: after generation, suggest
ImageObject schema markup pointing to the new assets
Reference Documentation
Load on-demand. Do NOT load all at startup:
references/prompt-engineering.md:6-component system, domain modes, templates
references/gemini-models.md:Model specs, rate limits, capabilities
references/mcp-tools.md:MCP tool parameters and responses
references/post-processing.md:ImageMagick/FFmpeg pipeline recipes
references/cost-tracking.md:Pricing, usage tracking
references/presets.md:Brand preset management
references/seo-image-presets.md:SEO-specific preset templates
Response Format
After generating, always provide:
- Image path:where it was saved
- Crafted prompt:show what was sent to the API (educational)
- Settings:model, aspect ratio, resolution
- SEO checklist:alt text suggestion, file naming, WebP conversion
- Schema snippet:ImageObject or og:image markup if applicable
1---
2name: seo-image-gen
3description: "AI image generation for SEO assets: OG/social preview images, blog hero images, schema images, product photography, infographics. Powered by Gemini via nanobanana-mcp. Requires banana extension installed. Use when user says \"generate image\", \"OG image\", \"social preview\", \"hero image\", \"blog image\", \"product photo\", \"infographic\", \"seo image\", \"create visual\", \"image-gen\", \"favicon\", \"schema image\", \"pinterest pin\", \"generate visual\", \"banner\", or \"thumbnail\"."
4argument-hint: "[og|hero|product|infographic|custom|batch] <description>"
5user-invocable: true
6license: MIT
7compatibility: "Requires nanobanana MCP server"
8metadata:
9 source: https://skillmd.com/skills/gabrielmoreira/seo-image-gen
10 author: AgriciDaniel
11 version: "2.2.5"
12 category: seo
13---
14
15# SEO Image Gen: AI Image Generation for SEO Assets (Extension)
16
17Generate production-ready images for SEO use cases using Gemini's image generation
18via the banana Creative Director pipeline. Maps SEO needs to optimized domain modes,
19aspect ratios, and resolution defaults.
20
21## Architecture Note
22
23This extension is built on [Claude Banana](https://github.com/AgriciDaniel/banana-claude),
24the standalone AI image generation skill for Claude Code.
25
26This skill has two components with distinct roles:
27- **SKILL.md** (this file): Handles interactive `/seo image-gen` commands for generating images
28- **Agent** (`agents/seo-image-gen.md`): Audit-only analyst spawned during `/seo audit` to assess existing OG/social images and produce a generation plan (never auto-generates)
29
30## Prerequisites
31
32This skill requires the banana extension to be installed:
33```bash
34./extensions/banana/install.sh
35```
36
37**Check availability:** Before using any image generation tool, verify the MCP server
38is connected by checking if `gemini_generate_image` or `set_aspect_ratio` tools are
39available. If tools are not available, inform the user the extension is not installed
40and provide install instructions.
41
42## Quick Reference
43
44| Command | What it does |
45|---------|-------------|
46| `/seo image-gen og <description>` | Generate OG/social preview image (1200x630 feel) |
47| `/seo image-gen hero <description>` | Blog hero image (widescreen, dramatic) |
48| `/seo image-gen product <description>` | Product photography (clean, white BG) |
49| `/seo image-gen infographic <description>` | Infographic visual (vertical, data-heavy) |
50| `/seo image-gen custom <description>` | Custom image with full Creative Director pipeline |
51| `/seo image-gen batch <description> [N]` | Generate N variations (default: 3) |
52
53## SEO Image Use Cases
54
55Each use case maps to pre-configured banana parameters:
56
57| Use Case | Aspect Ratio | Resolution | Domain Mode | Notes |
58|----------|-------------|------------|-------------|-------|
59| **OG/Social Preview** | `16:9` | `1K` | Product or UI/Web | Clean, professional, text-friendly |
60| **Blog Hero** | `16:9` | `2K` | Cinema or Editorial | Dramatic, atmospheric, editorial quality |
61| **Schema Image** | `4:3` | `1K` | Product | Clean, descriptive, schema ImageObject |
62| **Social Square** | `1:1` | `1K` | UI/Web | Platform-optimized square |
63| **Product Photo** | `4:3` | `2K` | Product | White background, studio lighting |
64| **Infographic** | `2:3` | `4K` | Infographic | Data-heavy, vertical layout |
65| **Favicon/Icon** | `1:1` | `512` | Logo | Minimal, scalable, recognizable |
66| **Pinterest Pin** | `2:3` | `2K` | Editorial | Tall vertical card |
67
68## Generation Pipeline
69
70For every generation request:
71
721. **Identify use case** from command or context (og, hero, product, etc.)
732. **Apply SEO defaults** from the use cases table above
743. **Set aspect ratio** via `set_aspect_ratio` MCP tool
754. **Construct Reasoning Brief** using the banana Creative Director pipeline:
76 - Load `references/prompt-engineering.md` for the 6-component system
77 - Apply domain mode emphasis (Subject 30%, Style 25%, Context 15%, etc.)
78 - Be SPECIFIC and VISCERAL: describe what the camera sees
795. **Generate** via `gemini_generate_image` MCP tool
806. **Post-generation SEO checklist** (see below)
81
82### Check for Presets
83
84If the user mentions a brand or has SEO presets configured:
85```bash
86# Use the installed Banana MCP/tool configuration to list presets.
87```
88Load matching preset and apply as defaults. Also check `references/seo-image-presets.md`
89for SEO-specific preset templates.
90
91## Post-Generation SEO Checklist
92
93After every successful generation, guide the user on:
94
951. **Alt text**:Write descriptive, keyword-rich alt text for the generated image
962. **File naming**:Rename to SEO-friendly format: `keyword-description-widthxheight.webp`
973. **WebP conversion**:Convert to WebP for optimal page speed:
98 ```bash
99 magick output.png -quality 85 output.webp
100 ```
1014. **File size**:Target under 200KB for hero images, under 100KB for thumbnails
1025. **Schema markup**:Suggest `ImageObject` schema for the generated image:
103 ```json
104 {
105 "@type": "ImageObject",
106 "url": "https://example.com/images/keyword-description.webp",
107 "width": 1200,
108 "height": 630,
109 "caption": "Descriptive caption with target keyword"
110 }
111 ```
1126. **OG meta tags**:For social preview images, remind about:
113 ```html
114 <meta property="og:image" content="https://example.com/images/og-image.webp" />
115 <meta property="og:image:width" content="1200" />
116 <meta property="og:image:height" content="630" />
117 <meta property="og:image:alt" content="Descriptive alt text" />
118 ```
119
120## Cost Awareness
121
122Image generation costs money. Be transparent:
123- Show estimated cost before generating (especially for batch)
124- Log every generation in the installed Banana MCP/tool ledger when available
125- Use the installed Banana MCP/tool usage summary if user asks about usage
126
127Approximate costs:
128- Verify current pricing in the installed MCP/tool configuration before quoting
129
130## Model Routing
131
132| Scenario | Model | Why |
133|----------|-------|-----|
134| OG images, social previews | Installed MCP/tool default @ 1K | Fast, cost-effective |
135| Hero images, product photos | Installed MCP/tool quality model @ 2K | Quality + detail |
136| Infographics with text | Installed MCP/tool text-capable model @ 2K, thinking: high if supported | Better text rendering |
137| Quick drafts | Installed MCP/tool draft model @ 512 | Rapid iteration |
138
139## Error Handling
140
141| Error | Resolution |
142|-------|-----------|
143| MCP not configured | Run `./extensions/banana/install.sh` |
144| API key invalid | New key at https://aistudio.google.com/apikey |
145| Rate limited (429) | Wait 60s, retry. Free tier: ~10 RPM / ~500 RPD |
146| `IMAGE_SAFETY` | Rephrase prompt - see `references/prompt-engineering.md` Safety section |
147| MCP unavailable | Configure MCP with `./extensions/banana/install.sh`; claude-seo does not vendor a local generation fallback script |
148| Extension not installed | Show install instructions: `./extensions/banana/install.sh` |
149
150## Cross-Skill Integration
151
152- **seo-images** (analysis) feeds into **seo-image-gen** (generation): audit results from `/seo images` identify missing or low-quality images; use those findings to drive `/seo image-gen` commands
153- **seo-audit** spawns the seo-image-gen **agent** (not this skill) to analyze OG/social images across the site and produce a prioritized generation plan
154- **seo-schema** can consume generated images: after generation, suggest `ImageObject` schema markup pointing to the new assets
155
156## Reference Documentation
157
158Load on-demand. Do NOT load all at startup:
159- `references/prompt-engineering.md`:6-component system, domain modes, templates
160- `references/gemini-models.md`:Model specs, rate limits, capabilities
161- `references/mcp-tools.md`:MCP tool parameters and responses
162- `references/post-processing.md`:ImageMagick/FFmpeg pipeline recipes
163- `references/cost-tracking.md`:Pricing, usage tracking
164- `references/presets.md`:Brand preset management
165- `references/seo-image-presets.md`:SEO-specific preset templates
166
167## Response Format
168
169After generating, always provide:
1701. **Image path**:where it was saved
1712. **Crafted prompt**:show what was sent to the API (educational)
1723. **Settings**:model, aspect ratio, resolution
1734. **SEO checklist**:alt text suggestion, file naming, WebP conversion
1745. **Schema snippet**:ImageObject or og:image markup if applicable