seo-image-gen
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".
- License 许可
- MIT
- 所属仓库
- aeroalgo/dev-hub
- 最近更新
- 2026-10-30
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- seo-image-gen
- license
- MIT
- metadata
- { "author": "AgriciDaniel", "version": "2.0.0", "category": "seo" }
- description
- 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".
- argument-hint
- [og|hero|product|infographic|custom|batch] <description>
- compatibility
- Requires nanobanana MCP server
- user-invokable
- true
02 资源文件 8
- 许可证LICENSE.txt143 B
- 参考文档references/cost-tracking.md1.4 KB
- 参考文档references/gemini-models.md7.5 KB
- 参考文档references/mcp-tools.md3.7 KB
- 参考文档references/post-processing.md5.1 KB
- 参考文档references/presets.md2.2 KB
- 参考文档references/prompt-engineering.md20.9 KB
- 参考文档references/seo-image-presets.md3.9 KB
03 SKILL.md 正文
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-gencommands for generating images - Agent (
agents/seo-image-gen.md): Audit-only analyst spawned during/seo auditto 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_ratioMCP tool - Construct Reasoning Brief using the banana Creative Director pipeline:
- Load
references/prompt-engineering.mdfor the 6-component system - Apply domain mode emphasis (Subject 30%, Style 25%, Context 15%, etc.)
- Be SPECIFIC and VISCERAL: describe what the camera sees
- Load
- Generate via
gemini_generate_imageMCP tool - Post-generation SEO checklist (see below)
Check for Presets
If the user mentions a brand or has SEO presets configured:
python3 scripts/presets.py list
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
ImageObjectschema 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:
python3 scripts/cost_tracker.py log --model MODEL --resolution RES --prompt "brief" - Run
cost_tracker.py summaryif user asks about usage
Approximate costs (gemini-3.1-flash):
- 512: ~$0.02/image
- 1K resolution: ~$0.04/image
- 2K resolution: ~$0.08/image
- 4K resolution: ~$0.16/image
Model Routing
| Scenario | Model | Why |
|---|---|---|
| OG images, social previews | gemini-3.1-flash-image-preview @ 1K |
Fast, cost-effective |
| Hero images, product photos | gemini-3.1-flash-image-preview @ 2K |
Quality + detail |
| Infographics with text | gemini-3.1-flash-image-preview @ 2K, thinking: high |
Better text rendering |
| Quick drafts | gemini-2.5-flash-image @ 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 | Fall back: python3 scripts/generate.py --prompt "..." --aspect-ratio "16:9" |
| 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 imagesidentify missing or low-quality images; use those findings to drive/seo image-gencommands - 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
ImageObjectschema 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, templatesreferences/gemini-models.md:Model specs, rate limits, capabilitiesreferences/mcp-tools.md:MCP tool parameters and responsesreferences/post-processing.md:ImageMagick/FFmpeg pipeline recipesreferences/cost-tracking.md:Pricing, usage trackingreferences/presets.md:Brand preset managementreferences/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
04 同仓库更多 Skills
your-skill-name
Replace with a clear description of what this skill does. Use when <the situations that should trigger it>.
websocket-engineer
Use when building real-time communication systems with WebSockets or Socket.IO. Invoke for bidirectional messaging, horizontal scaling with Redis, presence tracking, room management.
web-security-review
Review web applications against the OWASP Top 10 for Web Applications (2021). Use when auditing web apps, reviewing server-side code, or assessing web frameworks for the classic OWASP Top 10 risks including injection, broken auth, and XSS.
vercel-react-view-transitions
Guide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, `startViewTransition`, `ViewTransition`, transition types, or asks about animating between UI states in React without third-party animation libraries.
vercel-react-native-skills
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.