Agent skill

SEO Image Generator

by AgriciDaniel in AgriciDaniel/claude-seo

Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

MITAuto-check passedMedia & Creative

Install SEO Image Generator

skills CLI
$ npx skills add AgriciDaniel/claude-seo --skill seo-image-gen -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-seo seo-image-gen --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-image-gen .claude/skills/seo-image-gen && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-image-gen
GitHub stars
19k
Used in
2 other repos
Token cost
~2.1k tokens
SKILL.md length
793 words
Files
11 (incl. references)
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

  • Works in 6 steps: Identify use case from command or… → Apply SEO defaults from the use cases… → Set aspect ratio via set_aspect_ratio… → …
  • Creating an Open Graph or social preview image for a page
  • SKILL.md covers Architecture Note, Prerequisites, Quick Reference and SEO Image Use Cases, plus 8 more sections
  • Calls magick

What it does

Each /seo image-gen subcommand (og, hero, product, infographic, custom and batch) maps an SEO need to preset image settings: a 16:9 image at 1K for social previews, 16:9 at 2K for blog heroes, 4:3 at 2K for studio-style product shots and 4:3 at 1K for schema images. A 1:1 square is listed for social platforms.

Generation runs through Gemini via the nanobanana MCP server, which comes from the banana extension and must be installed first with ./extensions/banana/install.sh. Before generating, the skill checks that tools such as gemini_generate_image are present and, if they are not, tells you how to install the extension. The batch command makes N variations, three by default.

A separate audit-only agent can review existing OG and social images during a full SEO audit and propose a generation plan, but it never generates anything on its own. Reference files cover cost tracking, Gemini models, MCP tools, post-processing, presets, prompt engineering and templates.

When your agent uses it

  • Creating an Open Graph or social preview image for a page
  • Making a hero image for a new blog post
  • Producing a clean white-background product photo for a listing
  • Generating several variations of a banner or thumbnail to compare

Example prompts

  • “Generate an OG image for our pricing page with a clean, dark blue look.”
  • “Make a blog hero image about container security, widescreen and dramatic.”
  • “Create three variations of a product photo for a ceramic coffee mug on white.”
  • “Make a vertical infographic about the steps of a site migration.”

Requirements

  • The banana extension installed with ./extensions/banana/install.sh
  • The nanobanana MCP server connected
  • Access to Gemini image generation
  • Compatibility (from SKILL.md): Requires nanobanana MCP server

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Identify use case from command or context (og, hero, product, etc.)
  2. Apply SEO defaults from the use cases table above
  3. Set aspect ratio via set_aspect_ratio MCP tool
  4. Construct Reasoning Brief using the banana Creative Director pipeline
  5. Generate via gemini_generate_image MCP tool
  6. Post-generation SEO checklist (see below)

What it can do on your machine

Read from SKILL.md and the folder at commit 4b99de2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • magick

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • aistudio.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires nanobanana MCP server

    From compatibility in the SKILL.md frontmatter.

Context cost

SEO Image Generator loads about 2.1k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 119 tokens; SKILL.md has 793 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-seo at commit 4b99de2, republished under its MIT licence (© AgriciDaniel). 793 words, ~2,105 tokens.

Download SKILL.mdSave it as .claude/skills/seo-image-gen/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
seo-image-gen
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".
compatibility
Requires nanobanana MCP server
argument-hint
[og|hero|product|infographic|custom|batch] <description>
user-invocable
true
license
MIT
metadata.author
AgriciDaniel
metadata.version
2.4.2
metadata.category
seo

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:

bash
./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

CommandWhat 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 CaseAspect RatioResolutionDomain ModeNotes
OG/Social Preview16:91KProduct or UI/WebClean, professional, text-friendly
Blog Hero16:92KCinema or EditorialDramatic, atmospheric, editorial quality
Schema Image4:31KProductClean, descriptive, schema ImageObject
Social Square1:11KUI/WebPlatform-optimized square
Product Photo4:32KProductWhite background, studio lighting
Infographic2:34KInfographicData-heavy, vertical layout
Favicon/Icon1:1512LogoMinimal, scalable, recognizable
Pinterest Pin2:32KEditorialTall vertical card

Generation Pipeline

For every generation request:

  1. Identify use case from command or context (og, hero, product, etc.)
  2. Apply SEO defaults from the use cases table above
  3. Set aspect ratio via set_aspect_ratio MCP tool
  4. 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
  5. Generate via gemini_generate_image MCP tool
  6. Post-generation SEO checklist (see below)
Check for Presets

If the user mentions a brand or has SEO presets configured:

bash
# 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:

  1. Alt text:Write descriptive, keyword-rich alt text for the generated image
  2. File naming:Rename to SEO-friendly format: keyword-description-widthxheight.webp
  3. WebP conversion:Convert to WebP for optimal page speed:
    bash
    magick output.png -quality 85 output.webp
  4. File size:Target under 200KB for hero images, under 100KB for thumbnails
  5. Schema markup:Suggest ImageObject schema for the generated image:
    json
    {
      "@type": "ImageObject",
      "url": "https://example.com/images/keyword-description.webp",
      "width": 1200,
      "height": 630,
      "caption": "Descriptive caption with target keyword"
    }
  6. OG meta tags:For social preview images, remind about:
    html
    <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" />
Show full SKILL.md (316 more words)Show less

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

ScenarioModelWhy
OG images, social previewsInstalled MCP/tool default @ 1KFast, cost-effective
Hero images, product photosInstalled MCP/tool quality model @ 2KQuality + detail
Infographics with textInstalled MCP/tool text-capable model @ 2K, thinking: high if supportedBetter text rendering
Quick draftsInstalled MCP/tool draft model @ 512Rapid iteration

Error Handling

ErrorResolution
MCP not configuredRun ./extensions/banana/install.sh
API key invalidNew key at https://aistudio.google.com/apikey
Rate limited (429)Wait 60s, retry. Free tier: ~10 RPM / ~500 RPD
IMAGE_SAFETYRephrase prompt - see references/prompt-adaptation-safety.md
MCP unavailableConfigure MCP with ./extensions/banana/install.sh; claude-seo does not vendor a local generation fallback script
Extension not installedShow 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, advanced techniques
  • references/prompt-templates.md: ready-to-use templates by use case
  • references/prompt-adaptation-safety.md: model adaptation rules, common mistakes, safety-filter rephrasing
  • 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:

  1. Image path:where it was saved
  2. Crafted prompt:show what was sent to the API (educational)
  3. Settings:model, aspect ratio, resolution
  4. SEO checklist:alt text suggestion, file naming, WebP conversion
  5. Schema snippet:ImageObject or og:image markup if applicable

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 10 other files (references) in skills/seo-image-gen of AgriciDaniel/claude-seo.

  • SKILL.md
  • LICENSE.txt
  • references/cost-tracking.md
  • references/gemini-models.md
  • references/mcp-tools.md
  • references/post-processing.md
  • references/presets.md
  • references/prompt-adaptation-safety.md
  • references/prompt-engineering.md
  • references/prompt-templates.md
  • references/seo-image-presets.md

Open the folder on GitHubat commit 4b99de2

Used in 4 other repositories

We found 10 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AgriciDaniel/claude-seo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

SEO Image Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Image Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Image Generator this skillAgriciDaniel/claude-seo19k2 repos~2.1kAutomated safety check: PassMIT
Blog ImageAgriciDaniel/claude-blog2.3k—~3.4kAutomated safety check: PassMIT
Canvasocial-media-skills/skills134—~2.1kAutomated safety check: PassMIT
Design Masterminhnv0807/ai-business-skills609—~4.6kAutomated safety check: PassMIT
Canva Designerasgeirtj/system_prompts_leaks69k—~2.1kAutomated safety check: PassCC0-1.0
Thumbnail Creatormohitagw15856/pm-claude-skills1.4k—~6.3kAutomated safety check: PassMIT

Similar skills

  • Blog Image

    AgriciDaniel/claude-blog

    AI image generation and editing for blog content powered by Gemini via MCP.

    2.3k GitHub stars~3.4k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Canva

    social-media-skills/skills

    The Canva craft skill — produce on-brand social graphics, carousels, quote cards, infographics, and thumbnails at scale without a designer, and escape the "Canva look." Use when someone wants to…

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Design Master

    minhnv0807/ai-business-skills

    Handles eight kinds of marketing visual requests, from logos and campaign key visuals to infographics and quote graphics, by generating images or writing paste-ready prompts.

    609 GitHub stars~4.6k tokensUpdated 29 days ago
    Media & CreativeAuto-check passed
  • Canva Designer

    asgeirtj/system_prompts_leaks

    Creates and edits Canva designs, generates images and works with brand kits through the canva CLI and Canva's official MCP server, from decks to social posts.

    69k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Thumbnail Creator

    mohitagw15856/pm-claude-skills

    Generate article or newsletter thumbnail candidates using the Gemini API from inside Claude Code.

    1.4k GitHub stars~6.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Smart Illustrator

    axtonliu/smart-illustrator

    Generates article illustrations, batch slide infographics and cover images from your text, using Gemini, Mermaid or Excalidraw engines and a prompt-only mode.

    564 GitHub stars~1.8k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed

More from AgriciDaniel/claude-seo

All 33 skills in this repo
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Auto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Auto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • SEO Drift Monitor

    AgriciDaniel/claude-seo

    Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.

    19k GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed

Questions about SEO Image Generator

What does SEO Image Generator do?

Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension. Each /seo image-gen subcommand (og, hero, product, infographic, custom and batch) maps an SEO need to preset image settings: a 16:9 image at 1K for social previews, 16:9 at 2K for blog heroes, 4:3 at 2K for studio-style product shots and 4:3 at 1K for schema images. A 1:1 square is listed for social platforms.

When should I use SEO Image Generator?

SEO Image Generator fits situations like: creating an Open Graph or social preview image for a page; making a hero image for a new blog post; producing a clean white-background product photo for a listing; generating several variations of a banner or thumbnail to compare.

How do I install SEO Image Generator in Claude Code?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-image-gen -a claude-code`. Or copy the skill folder (skills/seo-image-gen in AgriciDaniel/claude-seo) into .claude/skills/seo-image-gen in your project. Claude Code loads it when a task matches its description.

How do I install SEO Image Generator in Codex?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-image-gen -a codex`. Or copy the skill folder (skills/seo-image-gen in AgriciDaniel/claude-seo) into .agents/skills/seo-image-gen in your project. Codex loads it when a task matches its description.

Can I use SEO Image Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-seo --skill seo-image-gen -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-image-gen, .gemini/skills/seo-image-gen, .github/skills/seo-image-gen and .opencode/skills/seo-image-gen in your project.

What does SEO Image Generator need to run?

Going by SKILL.md and its folder, SEO Image Generator needs the command-line tools its instructions call (magick). Our summary lists: The banana extension installed with ./extensions/banana/install.sh; The nanobanana MCP server connected; Access to Gemini image generation. Compatibility (from SKILL.md): Requires nanobanana MCP server.

Does SEO Image Generator access the network?

SKILL.md names 2 domains. As links in the text: github.com and aistudio.google.com. This is read from the text; nothing was executed.

Is SEO Image Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Image Generator use?

SEO Image Generator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Image Generator use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to SEO Image Generator?

Skills that share tags, products or a category with SEO Image Generator: Blog Image (AgriciDaniel/claude-blog, 2.3k stars), Canva (social-media-skills/skills, 134 stars), Design Master (minhnv0807/ai-business-skills, 609 stars) and Canva Designer (asgeirtj/system_prompts_leaks, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Image Generator?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,627 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 4, 2026.

Source: AgriciDaniel/claude-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.