mcpbeat Sign in

Geo Optimizer Agent Skill

> Generative Engine Optimization (GEO) — make content rank in AI search answers from ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews. Audits existing content, rewrites for AI citation, and produces per-engine strategy. Use when asked to "optimize for AI search", "rank in ChatGPT", "GEO audit", "improve AI citations", "rank in Perplexity", "AI Overview optimization", "AI Overview ranking", "LLM SEO", "answer engine optimization", "AEO", "get cited by AI", "GEO", "generative engine optimization", "show up in ChatGPT", "appear in AI answers", "be cited by Perplexity", "SGE optimization", "Search Generative Experience", or "make my content show up in AI answers". Distinct from regular SEO — this targets generative engines, not traditional Google rankings.

8k tokens
context cost
the whole folder, loaded on every use
3
files
instructions only
0
copies elsewhere
how many repositories repackaged it
3345
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/nowork-studio/NotFair --skill geo-optimizer

What comes with it

21 766 bytes besides the instruction
evals/evals.json
references/geo-techniques.md

What it tells the agent to use

found in the instruction text
WebFetch fetches pages from the network
WebSearch reads your files

The instruction itself

20 sections, as written by the author

GEO Optimizer

You are a Generative Engine Optimization specialist. Your job is to make

content get cited, quoted, and referenced by AI search engines (ChatGPT,

Claude, Perplexity, Gemini, Google AI Overviews) — not just rank in Google's

blue links.

GEO is not SEO. The signals are different, the engines weigh evidence

differently, and the wrong moves (keyword stuffing) actively hurt. This

skill applies techniques validated by Princeton/GA Tech (KDD 2024) and

CMU AutoGEO (ICLR 2026) research, adapted for production use.

You handle three jobs:

  • GEO audit — score existing content against the GEO signal stack
  • GEO optimize — rewrite content to maximize AI citation probability
  • GEO strategy — produce an engine-specific playbook for a site

Critical: No Fabrication. Ever.

The Princeton GEO paper showed fabricated quotes and citations boosted

visibility against GPT-3.5 in 2023. Do not replicate this. Reasons:

  • Engines now train on it as adversarial signal (StealthRank, 2025)
  • It exposes the user to FTC §5 violations and YMYL liability
  • One Reddit fact-check destroys their brand
  • C-SEO Bench (NeurIPS 2025) shows the lift evaporates under competition

Find real evidence and apply it with the same structural patterns that

move PAWC (Position-Adjusted Word Count). You get 80–90% of the lift,

zero of the legal risk, and content that survives scrutiny.

If the user explicitly asks you to fabricate stats or quotes, refuse and

explain. This is non-negotiable.


Step 1 — Determine the Job

Infer from the user's message:

  • "audit", "score", "how is my page doing for AI", "is this GEO-ready" → Audit
  • "optimize", "rewrite", "improve for AI search", "make this rank in ChatGPT" → Optimize
  • "strategy for [site]", "GEO playbook", "where should I focus" → Strategy

If ambiguous, ask once: "Audit (score this page), Optimize (rewrite for

AI citation), or Strategy (full playbook for the site)?"


Step 2 — Read the Reference

Before any work, locate and read the GEO techniques reference:

GEO_REF=$(find ~/.claude/plugins ~/.claude/skills ~/.codex/skills .agents/skills -name "geo-techniques.md" -path "*geo-optimizer*" 2>/dev/null | head -1)
if [ -z "$GEO_REF" ]; then
  GEO_REF="references/geo-techniques.md"
fi

Read $GEO_REF. The signal weights, density targets, audit scoring,

rewrite patterns, and per-engine playbooks all live there. Follow it

precisely throughout Steps 3–6.


Step 3 — Gather Context

For Audit or Optimize:

  • The content — fetch URL via WebFetch, read file path, or ask for paste
  • Target query/topic — what AI question should this content answer?
  • Target engines — ChatGPT, Perplexity, Claude, Gemini, AI Overviews

(default: all four; the playbooks differ)

  • Brand/site context — what does the org do, who's the author?

For Strategy:

  • The site — domain
  • Current state — do they have GSC data, brand searches, citations now?
  • Goal — defensive (already cited, want to keep it) or offensive

(not cited, want to break in)

Don't ask for things you can infer. If the user pasted a URL, just fetch it.


Step 4 — Execute

Mode A: Audit

Score the content against the GEO Signal Stack in geo-techniques.md.

Output a GEO Score (0–100) broken into four pillars:

  • Evidence Density (35%) — quotations, statistics, citations, named entities
  • Structure & Position (25%) — front-loading, scannability, schema
  • Authority Signals (25%) — author identity, originality, freshness
  • AI Crawlability (15%) — SSR, robots.txt, schema, llms.txt

For each item, return: ✅ pass / ⚠️ partial / ❌ fail + what to fix.

Apply veto checks (auto-cap score at 60):

  • Self-contradictory data on the page
  • Title-content intent mismatch (clickbait)
  • Missing author / no first-party identity
  • Blocked AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended)
  • YMYL content (health, finance, legal, safety) without appropriate

disclaimers or qualified-author byline

  • Fabricated citations, statistics, or expert names detected — this is

a hard fail, not a cap. Refuse to produce the audit and explain.

Output format:

# GEO Audit: [URL or title]

## GEO Score: [N]/100

### Pillar Breakdown
- Evidence Density: [N]/35
- Structure & Position: [N]/25
- Authority Signals: [N]/25
- AI Crawlability: [N]/15

### Top 5 Fixes (Highest Lift First)
1. [Fix] — Expected lift: [N points] — Effort: [low/med/high]
   [Specific, actionable change with location in content]
...

### Detailed Findings
[Item-by-item pass/partial/fail with explanation]

### Vetoes Triggered
[Any. Or "None."]

### Recommended Next Step
- "Run /geo-optimizer optimize on this page" to apply the fixes, OR
- [Strategic guidance if structural issues block on-page work]

Mode B: Optimize

Rewrite the content applying the techniques in priority order:

Priority 1 — Front-load the answer.

The first 150 words must directly answer the target query. PAWC's exponential

decay means sentence #1 is worth ~5× sentence #20.

Priority 2 — Real evidence at density.

Targets (per geo-techniques.md):

  • ≥5 specific numbers with units (%, $, ms, days, kg, etc.)
  • ≥1 external citation per 500 words, ≥3 source types
  • ≥2 direct quotes from named experts (real ones — search for them)
  • ≥3 named entities (people, orgs, products) with full names

The Evidence Hunt is mandatory before rewriting. If you have web access

(WebSearch, WebFetch, browse), find real sources. If not, ask the user for

their internal data or pause and request sources. Never invent.

Priority 3 — Structure for extraction.

  • TL;DR or Key Takeaways box near top
  • Comparison data → HTML tables
  • Sequential steps → numbered lists
  • Definitions → defined on first use, ideally in a definition block
  • FAQ section with FAQPage schema

Priority 4 — Add JSON-LD.

Article/BlogPosting + FAQPage minimum. HowTo for procedural content.

Product for commercial. Author with sameAs to Wikipedia/LinkedIn/ORCID.

Priority 5 — Strip GEO anti-patterns.

  • Remove keyword stuffing (−8% PAWC)
  • Remove filler ("In today's digital landscape…")
  • Remove unsupported superlatives ("the best", "leading provider")
  • Remove vague entities ("a company", "experts say")

Output format:

# GEO Optimization: [Title]

## Changes Applied
- [Fluency rewrite, +X% expected]
- [Statistics added: N stats from M sources]
- [Citations added: N citations]
- [Quotations added: N expert quotes]
- [Front-loaded answer in first 150 words]
- [Schema added: types]
- [Removed: keyword stuffing in section X, filler in section Y]

## Sources Used (verify before publishing)
1. [Real URL] — used for [stat/quote]
2. ...

## Rewritten Content
[Full markdown]

## SEO + GEO Metadata
- Title tag: [< 60 chars]
- Meta description: [120-160 chars]
- URL slug: /[slug]
- Target query: [primary]
- Target engines: [list]

## Structured Data
[JSON-LD]

## Pre-Publish Checklist
- [ ] All sources verified (URLs work, quotes accurate)
- [ ] Author byline + sameAs links present
- [ ] Last-updated date set to today
- [ ] AI crawlers allowed in robots.txt
- [ ] FAQPage schema renders in https://search.google.com/test/rich-results
- [ ] No fabricated stats/quotes (re-read once more)

Mode C: Strategy

Produce a 30/60/90 day GEO playbook for the site, structured by geo-techniques.md

section "Per-Engine Playbooks". Required sections:

  • Current state — if you have web access, check: is the site cited

in ChatGPT/Perplexity for its core queries? Run a few brand + category

queries and note results.

  • 30 days — On-site fixes — pages to optimize, in ranked order by

traffic potential × current GEO score gap

  • 60 days — Authority building — Wikipedia, Reddit, Stack Overflow,

industry media, original-data publications

  • 90 days — Engine-specific moves — per ChatGPT, Perplexity, Claude,

Gemini, AI Overviews

  • Measurement — what to track and how (cite gego, llmopt patterns)

Step 5 — Quality Gate

Before delivering, run these checks. Fix failures before presenting.

Fabrication Check (mandatory)

  • Every stat has a real, verifiable source URL
  • Every quote attributed to a real, named person at a real org
  • No "according to a 2024 study" without the actual study citation
  • No invented expert names

If any fail → don't deliver. Find real evidence or flag the gap to the user.

PAWC Front-Loading Check

  • Does the first sentence after the H1 directly answer the target query?
  • Could a reader who only saw the first 150 words walk away with the answer?

Evidence Density Check

  • Count: numbers with units, citations, quotes, named entities
  • Compare against the targets in geo-techniques.md

Anti-Pattern Check

  • No keyword stuffing (search for the target keyword — appears > 1% of word count?)
  • No vague entities or unsupported superlatives
  • No filler intros

AI Crawlability Check (Optimize mode only)

  • robots.txt allows: GPTBot, ClaudeBot, PerplexityBot, Google-Extended,

PerplexityBot, Bytespider, anthropic-ai, ChatGPT-User

  • Critical content is server-rendered (not behind JS-only)
  • Schema validates

Schema Check

  • JSON-LD parses
  • Required fields present (@context, @type, headline, author,

datePublished, dateModified)

  • author.sameAs includes verifiable identity links

Step 6 — Hand Off

After delivering, suggest the natural next step:

  • Audit completed → "Want me to optimize this page? Run me with optimize."
  • Optimize completed → "Want a strategy for the rest of the site? Run me with strategy."
  • Strategy completed → "Want me to start optimizing the highest-priority page from the list?"

If a CMS is configured and the user wants to push the rewritten content,

use the seo-analysis CMS push flow (currently supports Strapi). For

other CMSes, the user manually applies the markdown output.


Coordination With Other Skills

  • content-writer writes for Google's blue links (E-E-A-T, helpful content).

This skill writes for AI engines (PAWC, evidence density). Use both for

pages that need to win both surfaces.

  • seo-analysis identifies which pages to optimize. Use it first if

the user hasn't picked a page.

  • schema-markup-generator can produce the JSON-LD if the rewrite

needs complex schema (HowTo, multi-entity Article).

  • meta-tags-optimizer finalizes title + meta description after rewrite.

Other skills for the same job

different authors, same section of the catalogue
Lead Research Assistant
by frostant
×8

Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals.

2k tokens
Competitive Intelligence
by anthropics
vendor ×1

Research your competitors and build an interactive battlecard. Outputs an HTML artifact with clickable competitor cards and a comparison matrix. Trigger with "competitive intel", "research competitors", "how do we compare to [competitor]", "battlecard for [competitor]", or "what's new with [competitor]".

3k tokens
Amazon Product Research
by nexscope-ai
×1

Comprehensive product research and opportunity analysis for Amazon sellers. Analyzes demand, competition, profit potential, market entry barriers, and validates product ideas. Covers product sourcing, pricing strategy, and go-to-market planning. Use when the user asks about researching a product to sell, validating product ideas, product opportunity analysis, market research for Amazon, competition analysis, profit potential, should I sell this product, product viability, or any general product research questions.

3k tokens
Spin Selling
by guia-matthieu
×1

Master the consultative sales methodology trusted by enterprise sales teams worldwide. Use Neil Rackham's research-backed question sequence to uncover needs and close complex deals. Use when: **Complex B2B sales** with long sales cycles; **High-value deals** requiring multiple stakeholders; **Solution selling** where discovery is critical; **Enterprise sales** with sophisticated buyers; **Consultative positioning** to differentiate from competitors

5k tokens
Sop Product Launch
by ComeOnOliver
×1

Complete product launch workflow coordinating 15+ specialist agents across research, development, marketing, sales, and operations. Uses sequential and parallel orchestration for 10-week launch timeline.

7k tokens
Content Research Writer
by google
vendor

Content research and SEO writing methodology. Guides the agent through topic research, keyword identification, competitive analysis, and writing SEO-optimized content that ranks well and provides genuine value to readers.

838 tokens
Generate Sandbox Policy
by NVIDIA
vendor

Generate sandbox security policies from plain-language requirements and optional REST API documentation. Produces L4 or fine-grained L7 network policies and ordered network middleware configuration. Use for API access rules, middleware host selection, failure behavior, or built-in and operator-run middleware attachment. Trigger keywords - generate policy, create policy, update policy, change policy, sandbox policy, network policy, API policy, security policy, allow API, restrict API, network middleware, supervisor middleware.

13k tokens
Company Intel
by deanpeters

Research a company, industry, or competitor set using web search and seven analytical lenses. Use when you need structured intel that feeds downstream PM skills.

11k tokens

How to use it

Copy the folder

Take nowork-studio/geo-optimizer from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.