Back to Skills

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".

9,655stars1,390forksUpdated 6/24/2026

Security Assessment

Low Risk(80/100)

Detected risks:

Privilege Escalation([references/post-processing.md] sudo)
Security Score80/100

About seo-image-gen

An AI image-generation skill focused on SEO assets such as OG/social preview images, blog hero images, schema images, product photography, and infographics. It is powered by Gemini through the nanobanana MCP server and is built on the standalone Claude Banana image-generation skill, mapping SEO needs to optimized domain modes, aspect ratios, and resolution defaults. It triggers on phrases like "generate image", "OG image", "social preview", "hero image", "product photo", "infographic", "favicon", "pinterest pin", "banner", and "thumbnail".

The skill has two components: the SKILL.md handles interactive `/seo image-gen` commands for generating images, while a separate audit-only agent is spawned during `/seo audit` to assess existing OG/social images and produce a generation plan without auto-generating. It requires the banana extension to be installed and instructs the agent to verify the MCP server is connected (checking for tools like `gemini_generate_image` or `set_aspect_ratio`) before generating, informing the user with install instructions if it is not. Commands cover og, hero, product, infographic, custom, and batch modes, each mapping to preset parameters such as aspect ratio, resolution, and domain mode (for example OG/social at 16:9 1K, blog hero at 16:9 2K, infographic at 2:3 4K, favicon at 1:1 512).

For each request the pipeline identifies the use case, applies SEO defaults, sets the aspect ratio via `set_aspect_ratio`, constructs a Reasoning Brief using the banana Creative Director pipeline (loading references/prompt-engineering.md for the six-component system), and generates via `gemini_generate_image`. A post-generation SEO checklist guides writing keyword-rich alt text, SEO-friendly file naming, WebP conversion with ImageMagick, file-size targets, ImageObject schema markup, and OG meta tags. The skill is cost-aware, showing estimated cost before generating and logging usage with a cost tracker, and it includes model routing guidance and an error-handling table for cases like missing MCP configuration, invalid API keys, rate limiting, and safety blocks, with reference docs loaded on demand rather than all at startup.

FAQ

What does this skill require to run?

It requires the banana extension to be installed (via `./extensions/banana/install.sh`) and the nanobanana MCP server connected. Before generating, it verifies tools like `gemini_generate_image` or `set_aspect_ratio` are available and otherwise tells the user how to install it.

What SEO image types can it generate?

It supports OG/social previews, blog hero images, schema (ImageObject) images, social squares, product photos, infographics, favicons/icons, and Pinterest pins, each mapped to preset aspect ratios, resolutions, and domain modes.

Is image generation cost-aware?

Yes. The skill shows an estimated cost before generating (especially for batches), logs each generation with a cost tracker script, and can produce a usage summary on request, with approximate per-image costs listed by resolution.

What happens after an image is generated?

A post-generation SEO checklist guides keyword-rich alt text, SEO-friendly file naming, WebP conversion via ImageMagick, file-size targets, suggested ImageObject schema markup, and OG meta tags for social previews.

How does the audit agent differ from the command skill?

The SKILL.md handles interactive `/seo image-gen` commands that generate images, while a separate audit-only agent is spawned during `/seo audit` to assess existing OG/social images and produce a generation plan; the agent never auto-generates.

All Files

9 files
references/gemini-models.md7.4 KB
View
LICENSE.txt0.1 KB
View
references/mcp-tools.md3.7 KB
View
references/prompt-engineering.md20.9 KB
View
references/cost-tracking.md1.4 KB
View
references/post-processing.md5.1 KB
View
references/seo-image-presets.md3.9 KB
View
references/presets.md2.2 KB
View
SKILL.md8.0 KB
View

Install seo-image-gen

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill