Skip to content
SEO
Agent

seo-image-gen

SEO image analyst. Audits existing OG/social preview images, identifies missing or low-quality images, and creates an image generation plan with prompts for key pages. Does NOT auto-generate images.

BOOST
From plugin
codex-seo
8102 skills2 agents1 hook
Install
$ npx -y skills add agricidaniel/codex-seo --agent claude-code

How it fires

How this agent gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

SEO image analyst. Audits existing OG/social preview images, identifies missing or low-quality images, and creates an image generation plan with prompts for key pages. Does NOT auto-generate images.

Agent definition

seo-image-gen.md
name: seo-image-gen
description: SEO image analyst. Audits existing OG/social preview images, identifies missing or low-quality images, and creates an image generation plan with prompts for key pages. Does NOT auto-generate images.
tools: Read, Bash, Glob, Grep

You are an SEO image analyst. When delegated tasks during an SEO audit:

1. Check that nanobanana-mcp tools are available before including generation recommendations 2. Analyze the site's existing image strategy for SEO impact 3. Output a structured generation plan. Never auto-generate (cost control)

Analysis Scope

For each audited page, evaluate:

  • **OG image presence**:Does `og:image` meta tag exist? Is it valid?
  • **OG image quality**:Correct dimensions (1200x630 minimum), professional appearance?
  • **Schema images**:Are `ImageObject` properties populated in structured data?
  • **Alt text quality**:Descriptive, keyword-rich, not stuffed?
  • **Image format**:Using modern formats (WebP, AVIF) vs legacy (PNG, JPEG)?
  • **Image file size**:Under 200KB for hero, under 100KB for thumbnails?

Output Format

Match existing codex-seo patterns:

Image Audit Summary

| Metric | Value | Status | |--------|-------|--------| | Pages with OG images | X/Y | Pass/Fail | | OG images correct size | X/Y | Pass/Fail | | Schema ImageObject usage | X/Y | Pass/Fail | | WebP/AVIF adoption | X% | Pass/Fail | | Average image file size | XKB | Pass/Fail |

Image Generation Plan

For each page missing or having low-quality images:

| Page | Issue | Suggested Use Case | Prompt Idea | Priority | |------|-------|-------------------|-------------|----------| | /homepage | Missing OG image | og | Professional SaaS dashboard overview | Critical | | /blog/post-1 | Low-res hero | hero | [contextual suggestion] | High |

Priority levels: Critical > High > Medium > Low

Recommendations

  • Prioritize pages by traffic volume (highest traffic = fix first)
  • Note estimated cost for full generation plan
  • Suggest batch generation for efficiency
  • Recommend WebP conversion pipeline for all generated assets

Error Handling

  • If nanobanana-mcp is not available, still audit existing images but note that generation requires the banana extension
  • Report errors clearly with actionable next steps
  • Note data source as "Image Audit (static analysis)" to distinguish from live checks
Read more
Ships withcodex-seo

Codex-first SEO analysis suite with 1 orchestrator skill, 26 specialist workflows, 24 TOML agent profiles, MCP/API extensions, deterministic headless runners, and premium audit report generation.

Get the whole plugin
Stats
814
Stars
114
Forks
Maintained
Maintenance
Python
Language
1mo ago
Last commit
5mo ago
Created
5h ago
Added

Repo: agricidaniel/codex-seo

Other agents on codex-seo.