PluginBench
Skill
Review
Audit score 70

geo-content-optimizer

aaron-he-zhu/aaron-marketing-skills

Optimize content for AI citations across ChatGPT, Perplexity, AI Overviews, Gemini, and Claude.

What is geo-content-optimizer?

Improves content structure, authority signals, factual density, and quotability to increase citation readiness on generative AI engines. Use this when optimizing for AI-generated answers and citation surfaces, not for structural on-page SEO or net-new content drafting.

  • Adds standalone definitions, sourced quotable statements, and expert authority signals
  • Structures content with Q&A, tables, and lists for AI retrieval
  • Increases factual density and source attribution for higher citability
  • Scores content against CORE-EEAT GEO targets (C02, O03, O05, E01)
  • Measures AI Query Coverage and before/after GEO readiness scores
  • Provides AI Overview recovery playbook for click-loss scenarios

How to install geo-content-optimizer

npx skills add https://github.com/aaron-he-zhu/aaron-marketing-skills --skill geo-content-optimizer
Claude Code
Cursor
Windsurf
Cline

How to use geo-content-optimizer

  1. 1.Provide the content URL or text and specify target AI engine (ChatGPT, Perplexity, Gemini, Claude, AI Overviews)
  2. 2.Run the 5-step workflow: load CORE-EEAT targets, analyze current content, apply GEO techniques, generate output with before/after scores
  3. 3.Review the CORE-EEAT GEO self-check results and address any Fail items
  4. 4.Use the Tavily keyless probe (if available) to test citability against live AI answer engines
  5. 5.Save approved results to memory/content/ with handoff summary for future reference

Use cases

Good for
  • Recover traffic lost to AI Overviews by rewriting content for citability
  • Optimize existing articles to appear in ChatGPT Search and Perplexity answers
  • Audit content for GEO readiness and implement citation-friendly formatting
  • Build recovery plans when AI engines cite competitors instead of your content
  • Improve quotable statement density in technical or reference content
Who it's for
  • Content strategists optimizing for generative AI visibility
  • SEO professionals managing AI Overview and GEO impact
  • Marketing teams recovering traffic from AI-generated answer surfaces
  • Technical writers improving content citability for AI systems

geo-content-optimizer FAQ

How is GEO different from traditional SEO?

GEO (Generative Engine Optimization) targets AI-generated answer surfaces (ChatGPT, Perplexity, AI Overviews) rather than organic search rankings. It prioritizes quotable, factually dense, standalone answer blocks over keyword density and backlinks.

How quickly will my content get cited by AI engines?

Citability (whether your content is extractable and quotable) is testable in minutes using the Tavily probe. Unprompted surfacing in AI answers depends on the engine's crawl/index refresh cycle (week-scale) and is not guaranteed; do not conflate the two.

What if my entity profile is missing or outdated?

The skill will declare DONE_WITH_CONCERNS and recommend using the entity-registry skill to create or refresh the profile. This ensures accurate display names, descriptions, and disambiguation boilerplate in AI-cited content.

Can this skill help with AI Overview recovery?

Yes. See the AI Overview Recovery reference for a 4-phase playbook (measure → diagnose → rewrite → monitor) tailored to recovering clicks lost to AI-generated answers.

What metrics does this skill report?

Before/after GEO score, AI Query Coverage per target engine, CORE-EEAT self-check results (C02, O03, O05, E01, etc.), and citability proxy via Tavily. All metrics are labeled Measured, User-provided, or Estimated.

Full instructions (SKILL.md)

Source of truth, from aaron-he-zhu/aaron-marketing-skills.


name: geo-content-optimizer slug: geo-content-optimizer displayName: "GEO Content Optimizer · AI引用优化" summary: "AI引用优化/GEO优化/AI搜索" description: 'Use when the user asks to "optimize for AI citations"; improves citation readiness for ChatGPT, Perplexity, AI Overviews, Gemini, and Claude. Not for structural on-page SEO — use on-page-seo-checker; not for net-new drafting — use content-writer. AI引用优化/GEO优化/AI搜索' version: "20.1.0" license: Apache-2.0 compatibility: "Claude Code and compatible agent-skill hosts" homepage: "https://github.com/aaron-he-zhu/aaron-marketing-skills" when_to_use: "Use when optimizing content for AI engines like ChatGPT, Perplexity, AI Overviews, Gemini, Claude, or Copilot. Also for AI citation optimization, generative engine visibility, AI引用优化, AI搜索优化, GEO优化, or 让AI引用我." argument-hint: "<content URL or text> [target AI engine]" metadata: {"author": "aaron-he-zhu", "version": "20.1.0", "discipline": "seo-geo", "phase": "implement", "geo-relevance": "high", "hermes": {"tags": ["marketing", "seo-geo", "implement"], "category": "seo-geo"}, "openclaw": {"emoji": "🔍", "homepage": "https://github.com/aaron-he-zhu/aaron-marketing-skills"}}

GEO Content Optimizer

Optimizes content for AI-generated answers and citation surfaces such as ChatGPT, Perplexity, Gemini, Claude, and AI Overviews.

What This Skill Does

Improves structure, authority signals, factual density, quotable statements, source attribution, and overall GEO readiness.

Quick Start

Optimize this content for GEO/AI citations: [content or URL]
Make this article more likely to be cited by AI systems
Write content about [topic] optimized for both SEO and GEO
Audit this content for GEO readiness and suggest improvements
AI Overview is eating clicks on 12 head queries — build a recovery plan

See AI Overview Recovery for the 4-phase playbook (measure → diagnose → rewrite → monitor) tailored to recovery scenarios (as opposed to generic GEO optimization).

Skill Contract

Expected output: a ready-to-use asset or implementation-ready transformation plus a short handoff summary ready for memory/content/.

  • Reads: the brief, target keywords, entity inputs, and quality constraints. Canonical entity profiles: if the content mentions a brand / person / product, this skill MUST consult memory/entities/<slug>.md (per the entity-geo handoff schema) to populate display_name, description_short, ai_resolution_status and decide whether disambiguation boilerplate is needed. If the profile is missing or stale (>90 days), declare DONE_WITH_CONCERNS and recommend entity-registry as an open loop.
  • Writes: a user-facing content, metadata, or schema deliverable plus a reusable summary that can be stored under memory/content/.
  • Promotes: approved angles, messaging choices, missing evidence, and publish blockers to memory/hot-cache.md and memory/open-loops.md; propose durable decisions as pending-decision items.
  • Done when: each target AI query has a standalone, quotable answer block; a before/after GEO score and AI Query Coverage are reported; and the CORE-EEAT GEO self-check (C02, O03, O05, E01) has no unaddressed Fail.
  • Primary next skill: use the Next Best Skill below when the asset is ready for review or deployment.

Handoff Summary

Emit the standard shape from skill-contract.md §Handoff Summary Format.

Data Sources

Use ~~AI monitor and ~~SEO tool when connected; otherwise ask for target queries, content, engines, competitor examples, and known AI-citation gaps. See CONNECTORS.md.

Measuring whether GEO work paid off: the changes this skill makes (extractable, quotable, answer-shaped content) move citability — testable in minutes by handing a live-fetch engine the URL and asking the target query. That is a proxy. Whether an engine then cites you unprompted (surfacing) is gated by its crawl/index refresh — week-scale and confounded, not minute-level. Do not conflate the two or promise fast surfacing. The latency of each signal, and why outcome deltas need a control group, are defined in references/measurement-protocol.md.

Keyless AI-citation probe (Tavily): python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/tavily.py" search "<target query>" --answer --limit 10 runs that citability test against a real AI answer engine, no key needed — check whether the synthesized answer cites your URL/domain and where the page ranks among the scored sources. This is Measured for Tavily's own layer and an Estimated proxy for ChatGPT/Perplexity/Google AI Overviews (different indexes, different retrieval). Re-run after shipping changes for a minutes-scale citability read; unprompted surfacing stays week-scale per the paragraph above. See scripts/connectors/README.md.

Instructions

When a user requests GEO optimization, run these five steps:

  1. Load CORE-EEAT GEO-First Targets — prioritize C02, C09, O03, O05, E01, O02 plus engine-specific preferences.
  2. Analyze Current Content — score clear definitions, quotable statements, factual density, source citations, Q&A format, authority signals, freshness, and structure clarity.
  3. Apply GEO Techniques — add standalone 25-50 word definitions, sourced quotable statements, expert/source signals, Q&A/tables/lists, specific data, and visible-content-matching FAQ schema.
  4. Generate GEO Output — report Changes Made, before/after GEO score, and AI Query Coverage.
  5. CORE-EEAT GEO Self-Check — verify C02, C04, C09, O02, O03, O05, O06, R01, R02, R04, R07, E01, Exp10, Ept08 with Pass/Warn/Fail. Then run the slop self-check to strip AI-tell phrasing before the asset ships.

Label every metric Measured (tool/export), User-provided, or Estimated (model inference); never present an estimate as measured; if a required metric is unavailable, mark it N/A — do not invent it.

Reference: See Instructions Detail for the full CORE-EEAT GEO target tables, AI engine preferences, analysis templates, optimization report template, self-check matrix, and examples.

Example

User: "Optimize this paragraph for GEO: 'Email marketing is a good way to reach customers. It's been around for a while and many businesses use it.'"

Output adds a clear definition, dated/source-backed facts, structured list, quotable statements, and a before/after GEO score. See the full pattern in Instructions Detail — Example.

GEO Optimization Checklist

Reference: See the GEO Readiness Checklist in GEO Optimization Techniques for the full checklist covering definitions, quotable content, authority, structure, and technical elements.

Save Results

On user confirmation, save to memory/content/YYYY-MM-DD-<topic>.md — see Skill Contract §Save Results Template.

Reference Materials

  • Instructions Detail - Full 5-step workflow, CORE-EEAT GEO targets, self-check matrix, worked example, tips
  • GEO Optimization Techniques - Detailed before/after examples, templates, and checklists for each technique
  • AI Citation Patterns - Evidence-bounded discovery, retrieval, and citation controls for Google AI features, ChatGPT Search, Perplexity, Claude, Gemini grounding, Copilot Studio, and Brave Search
  • Quotable Content Examples - Before/after examples of content optimized for AI citation
  • Medium / GitHub AI-Citation Surfaces - Off-site surfaces engines cite (Medium articles, GitHub repos/READMEs)
  • Slop Self-Check - Pre-publish pass to strip AI-tell phrasing before content ships
  • Agent-Readable File Stack (llms.txt / OKF) - Machine-readable files so agents and engines can parse your site
  • Grokipedia Tactics - AI-citation tactics for Grok / Grokipedia
  • GEO distribution surfaces — platform refs engines pull from: X, LinkedIn, YouTube, Reddit

Next Best Skill

  • Primary: content-quality-auditor — verify the optimized content is strong enough to ship and cite.

Termination note: keep a visited-set this session; if the recommended skill was already invoked, stop and report the chain complete rather than re-running it. Honor a max handoff depth of 3 to avoid loops (per skill-contract.md §Termination rules).