seo-image-gen

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". argument-hint [og|hero|product|infographic|custom|batch] <description> user-invocable true license MIT compatibility Requires nanobanana MCP server metadata {"author":"AgriciDaniel","version":"2.2.5","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: ./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: Use ${CLAUDE_SKILL_DIR} as the installed skill root Load ${CLAUDE_SKILL_DIR}/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: claude-seo run --extension banana presets.py list Load matching preset and apply as defaults. Also check ${CLAUDE_SKILL_DIR}/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: claude-seo run --extension banana cost_tracker.py log --model MODEL --resolution RES --prompt "brief" Run cost_tracker.py summary if user asks about usage Pricing is not hard-coded. Check current Google pricing at https://ai.google.dev/gemini-api/docs/pricing , store dated values in ~/.banana/pricing.json , and treat estimates as approximate. Model Routing Scenario Model Why OG images, social previews Verified NANOBANANA_MODEL @ 1K Fast, cost-aware Hero images, product photos Verified NANOBANANA_MODEL @ 2K if supported Quality + detail Infographics with text Verified NANOBANANA_MODEL @ 2K if supported, thinking: high Better text rendering Quick drafts Verified NANOBANANA_MODEL @ 512 if supported Rapid iteration Error Handling Error Resolution MCP not configured Run ./extensions/banana/install.sh or claude-seo run --extension banana setup_mcp.py --key YOUR_KEY API key invalid New key at https://aistudio.google.com/apikey Rate limited (429) Wait 60s, retry. Check current free-tier limits before batch operations IMAGE_SAFETY Rephrase prompt - see references/prompt-engineering.md Safety section MCP unavailable Fall back: claude-seo run --extension banana generate.py --prompt "..." --aspect-ratio "16:9" --model "$NANOBANANA_MODEL" CSV batch input Plan first: claude-seo run --extension banana batch.py --csv requests.csv --model "$NANOBANANA_MODEL" 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: ${CLAUDE_SKILL_DIR}/references/prompt-engineering.md :6-component system, domain modes, templates ${CLAUDE_SKILL_DIR}/references/gemini-models.md :Model specs, rate limits, capabilities ${CLAUDE_SKILL_DIR}/references/mcp-tools.md :MCP tool parameters and responses ${CLAUDE_SKILL_DIR}/references/post-processing.md :ImageMagick/FFmpeg pipeline recipes ${CLAUDE_SKILL_DIR}/references/cost-tracking.md :Pricing, usage tracking ${CLAUDE_SKILL_DIR}/references/presets.md :Brand preset management ${CLAUDE_SKILL_DIR}/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