Skip to main content
affpapa.org
RU EN
skill CX Codex

geo — Claude Code skill: what it does, how to install

Audits websites for AI search engines like ChatGPT and Perplexity. It evaluates citability, generates llms.txt, and balances GEO with traditional technical SEO.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add zubair-trabzada/geo-seo-claude --skill geo -a claude-code
Open on GitHub

What geo does

This skill optimizes sites for AI answers across ChatGPT, Claude, Perplexity, and Google AI Overviews. It reviews crawler permissions in robots.txt, scans brand mentions across platforms, validates schema markup, and measures citation readiness. It also outputs an llms.txt file and runs standard technical SEO checks.

The audit runs in three phases. First, it inspects the homepage to detect whether the business is SaaS, local, e-commerce, or publishing. Then it launches five subagents in parallel to inspect content quality, schema, technical SEO, and platform readiness. Finally, it compiles a composite GEO score from 0 to 100.

The tool requires WebFetch, Bash, and Write permissions to operate. If your target domain blocks automated fetches from curl, the entire discovery phase stops immediately.

What it helps with

  • score content citability across AI search engines
  • generate and validate an llms.txt standard file
  • audit AI crawler access in robots.txt
  • compile client proposals and monthly delta reports

Example prompts for the agent

  • /geo audit <url>
  • /geo citability <url>
  • /geo llmstxt <url>

How to install geo

1Skills CLI (Vercel)

npx skills add zubair-trabzada/geo-seo-claude --skill geo -a claude-code

2Manually: put the files in place

~/.claude/skills/geo/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/geo/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about geo

How to install geo in Claude Code?

Run npx skills add zubair-trabzada/geo-seo-claude --skill geo -a claude-code in your terminal.

What does the geo skill do?

It runs a GEO and SEO audit to prepare websites for citations in AI engines like ChatGPT and Perplexity. It scores content citability, inspects schema markup, and generates actionable reports.

Which subagents run during the full audit?

The full audit dispatches five parallel subagents: geo-ai-visibility, geo-platform-analysis, geo-technical, geo-content, and geo-schema. They analyze their respective areas before calculating the final GEO Score.

Source text

SKILL.md · MIT 
---
name: geo
description: >
  GEO-first SEO analysis tool. Optimizes websites for AI-powered search engines
  (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining
  traditional SEO foundations. Performs full GEO audits, citability scoring,
  AI crawler analysis, llms.txt generation, brand mention scanning, platform-specific
  optimization, schema markup, technical SEO, content quality (E-E-A-T), and
  client-ready GEO report generation. Use when user says "geo", "seo", "audit",
  "AI search", "AI visibility", "optimize", "citability", "llms.txt", "schema",
  "brand mentions", "GEO report", or any URL for analysis.
allowed-tools: Read, Grep, Glob, Bash, WebFetch, Write
---

# GEO-SEO Analysis Tool — Claude Code Skill (February 2026)

> **Philosophy:** GEO-first, SEO-supported. AI search is eating traditional search.
> This tool optimizes for where traffic is going, not where it was.

---

## Quick Reference

| Command | What It Does |
|---------|-------------|
| `/geo audit <url>` | Full GEO + SEO audit with parallel subagents |
| `/geo page <url>` | Deep single-page GEO analysis |
| `/geo citability <url>` | Score content for AI citation readiness |
| `/geo crawlers <url>` | Check AI crawler access (robots.txt analysis) |
| `/geo llmstxt <url>` | Analyze or generate llms.txt file |
| `/geo brands <url>` | Scan brand mentions across AI-cited platforms |
| `/geo platforms <url>` | Platform-specific optimization (ChatGPT, Perplexity, Google AIO) |
| `/geo schema <url>` | Detect, validate, and generate structured data |
| `/geo technical <url>` | Traditional technical SEO audit |
| `/geo content <url>` | Content quality and E-E-A-T assessment |
| `/geo report <url>` | Generate client-ready GEO deliverable |
| `/geo report-pdf <url>` | Generate professional PDF report with charts and scores |
| `/geo quick <url>` | 60-second GEO visibility snapshot |
| `/geo prospect <cmd>` | CRM-lite: manage prospects through the sales pipeline |
| `/geo proposal <domain>` | Auto-generate client proposal from audit data |
| `/geo compare <domain>` | Monthly delta report: show score improvements to client |
| `/geo update` | Pull latest GEO skill updates from upstream |

---

## Market Context (Why GEO Matters)

| Metric | Value | Source |
|--------|-------|--------|
| GEO services market (2025) | $850M-$886M | Yahoo Finance / Superlines |
| Projected GEO market (2031) | $7.3B (34% CAGR) | Industry analysts |
| AI-referred sessions growth | +527% (Jan-May 2025) | SparkToro |
| AI traffic conversion vs organic | 4.4x higher | Industry data |
| Google AI Overviews reach | 1.5B users/month, 200+ countries | Google |
| ChatGPT weekly active users | 900M+ | OpenAI |
| Perplexity monthly queries | 500M+ | Perplexity |
| Gartner: search traffic drop by 2028 | -50% | Gartner |
| Marketers investing in GEO | Only 23% | Industry surveys |
| Brand mentions vs backlinks for AI | 3x stronger correlation | Ahrefs (Dec 2025) |

---

## Orchestration Logic

### Full Audit (`/geo audit <url>`)

**Phase 1: Discovery (Sequential)**
1. Fetch homepage HTML (curl or WebFetch)
2. Detect business type (SaaS, Local, E-commerce, Publisher, Agency, Other)
3. Extract key pages from sitemap.xml or internal links (up to 50 pages)

**Phase 2: Parallel Analysis (Delegate to Subagents)**
Launch these 5 subagents simultaneously:

| Subagent | File | Responsibility |
|----------|------|---------------|
| geo-ai-visibility | `agents/geo-ai-visibility.md` | GEO audit, citability, AI crawlers, llms.txt, brand mentions |
| geo-platform-analysis | `agents/geo-platform-analysis.md` | Platform-specific optimization (ChatGPT, Perplexity, Google AIO) |
| geo-technical | `agents/geo-technical.md` | Technical SEO, Core Web Vitals, crawlability, indexability |
| geo-content | `agents/geo-content.md` | Content quality, E-E-A-T, readability, AI content detection |
| geo-schema | `agents/geo-schema.md` | Schema markup detection, validation, generation |

**Phase 3: Synthesis (Sequential)**
1. Collect all subagent reports
2. Calculate composite GEO Score (0-100)
3. Generate prioritized action plan
4. Output client-ready report

### Scoring Methodology

| Category | Weight | Measured By |
|----------|--------|-------------|
| AI Citability & Visibility | 25% | Passage scoring, answer block quality, AI crawler access |
| Brand Authority Signals | 20% | Mentions on Reddit, YouTube, Wikipedia, LinkedIn; entity presence |
| Content Quality & E-E-A-T | 20% | Expertise signals, original data, author credentials |
| Technical Foundations | 15% | SSR, Core Web Vitals, crawlability, mobile, security |
| Structured Data | 10% | Schema completeness, JSON-LD validation, rich result eligibility |
| Platform Optimization | 10% | Platform-specific readiness (Google AIO, ChatGPT, Perplexity) |

---

## Business Type Detection

Analyze homepage for patterns:

| Type | Signals |
|------|---------|
| **SaaS** | Pricing page, "Sign up", "Free trial", "/app", "/dashboard", API docs |
| **Local Service** | Phone number, address, "Near me", Google Maps embed, service area |
| **E-commerce** | Product pages, cart, "Add to cart", price elements, product schema |
| **Publisher** | Blog, articles, bylines, publication dates, article schema |
| **Agency** | Portfolio, case studies, "Our services", client logos, testimonials |
| **Other** | Default — apply general GEO best practices |

Adjust recommendations based on detected type. Local businesses need LocalBusiness schema and Google Business Profile optimization. SaaS needs SoftwareApplication schema and comparison page strategy. E-commerce needs Product schema and review aggregation.

---

## Sub-Skills (14 Specialized Components)

| # | Skill | Directory | Purpose |
|---|-------|-----------|---------|
| 1 | geo-audit | `skills/geo-audit/` | Full audit orchestration and scoring |
| 2 | geo-citability | `skills/geo-citability/` | Passage-level AI citation readiness |
| 3 | geo-crawlers | `skills/geo-crawlers/` | AI crawler access and robots.txt |
| 4 | geo-llmstxt | `skills/geo-llmstxt/` | llms.txt standard analysis and generation |
| 5 | geo-brand-mentions | `skills/geo-brand-mentions/` | Brand presence on AI-cited platforms |
| 6 | geo-platform-optimizer | `skills/geo-platform-optimizer/` | Platform-specific AI search optimization |
| 7 | geo-schema | `skills/geo-schema/` | Structured data for AI discoverability |
| 8 | geo-technical | `skills/geo-technical/` | Technical SEO foundations |
| 9 | geo-content | `skills/geo-content/` | Content quality and E-E-A-T |
| 10 | geo-report | `skills/geo-report/` | Client-ready deliverable generation |
| 11 | geo-prospect | `skills/geo-prospect/` | CRM-lite prospect and client pipeline management |
| 12 | geo-proposal | `skills/geo-proposal/` | Auto-generate client proposals from audit data |
| 13 | geo-compare | `skills/geo-compare/` | Monthly delta tracking and progress reports |
| 14 | geo-update | `skills/geo-update/` | Pull latest updates from upstream repository |

---

## Subagents (5 Parallel Workers)

| Agent | File | Skills Used |
|-------|------|-------------|
| geo-ai-visibility | `agents/geo-ai-visibility.md` | geo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions |
| geo-platform-analysis | `agents/geo-platform-analysis.md` | geo-platform-optimizer |
| geo-technical | `agents/geo-technical.md` | geo-technical |
| geo-content | `agents/geo-content.md` | geo-content |
| geo-schema | `agents/geo-schema.md` | geo-schema |

---

## Output Files

All commands generate structured output:

| Command | Output File |
|---------|------------|
| `/geo audit` | `GEO-AUDIT-REPORT.md` |
| `/geo page` | `GEO-PAGE-ANALYSIS.md` |
| `/geo citability` | `GEO-CITABILITY-SCORE.md` |
| `/geo crawlers` | `GEO-CRAWLER-ACCESS.md` |
| `/geo llmstxt` | `llms.txt` (ready to deploy) |
| `/geo brands` | `GEO-BRAND-MENTIONS.md` |
| `/geo platforms` | `GEO-PLATFORM-OPTIMIZATION.md` |
| `/geo schema` | `GEO-SCHEMA-REPORT.md` + generated JSON-LD |
| `/geo technical` | `GEO-TECHNICAL-AUDIT.md` |
| `/geo content` | `GEO-CONTENT-ANALYSIS.md` |
| `/geo report` | `GEO-CLIENT-REPORT.md` (presentation-ready) |
| `/geo report-pdf` | `GEO-REPORT.pdf` (professional PDF with charts) |
| `/geo quick` | Inline summary (no file) |
| `/geo prospect` | Updates `~/.geo-prospects/prospects.json` |
| `/geo proposal` | `~/.geo-prospects/proposals/<domain>-proposal-<date>.md` |
| `/geo compare` | `~/.geo-prospects/reports/<domain>-monthly-<YYYY-MM>.md` |

---

## PDF Report Generation

The `/geo report-pdf <url>` command converts `GEO-AUDIT-REPORT.md` into a styled, client-ready PDF.

### Requirements
- **pandoc** — `brew install pandoc`
- **Google Chrome** — `/Applications/Google Chrome.app/` (standard Mac install)

No Python dependencies required for PDF generation.

### What the PDF Includes
- **Cover page** — dark navy gradient, GEO score badge, brand/domain/date/location metadata
- **Color-coded score tables** — cells with `XX/100` values are automatically colored green/blue/amber/orange/red
- **Severity-tagged findings** — Critical/High/Medium/Low sections get colored left-border callout blocks
- **Section page breaks** — major sections break to new pages automatically
- **Styled code blocks** — JSON schema templates render with dark monospace theme

### Templates
Bundled at `~/.claude/skills/geo/templates/`:
- `geo-report-style.css` — stylesheet (edit colors, fonts, layout here)
- `geo-report-template.html` — pandoc HTML template (edit cover fields here)

### Workflow
1. Run `/geo audit <url>` to produce `GEO-AUDIT-REPORT.md`
2. Run `/geo report-pdf` — extracts metadata from the report and runs:
   ```bash
   pandoc GEO-AUDIT-REPORT.md \
     --to html5 --standalone --embed-resources \
     --template ~/.claude/skills/geo/templates/geo-report-template.html \
     --css ~/.claude/skills/geo/templates/geo-report-style.css \
     --metadata brand_name="..." --metadata geo_score="..." \
     -o GEO-REPORT.html

   "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
     --headless=new --disable-gpu --no-sandbox \
     --print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
     --print-to-pdf-no-header --no-pdf-header-footer \
     --virtual-time-budget=5000 \
     "file://$(pwd)/GEO-REPORT.html"
   ```
3. Output: `GEO-REPORT.pdf` in the current directory

---

## Quality Gates

- **Crawl limit:** Max 50 pages per audit (focus on quality over quantity)
- **Timeout:** 30 seconds per page fetch
- **Rate limiting:** 1-second delay between requests, max 5 concurrent
- **Robots.txt:** Always respect, always check
- **Duplicate detection:** Skip pages with >80% content similarity

---

## Quick Start Examples

```
# Full GEO audit of a website
/geo audit https://example.com

# Check if AI bots can see your site
/geo crawlers https://example.com

# Score a specific page for AI citability
/geo citability https://example.com/blog/best-article

# Generate an llms.txt file for your site
/geo llmstxt https://example.com

# Get a 60-second visibility snapshot
/geo quick https://example.com

# Generate a client-ready report
/geo report https://example.com
```

© zubair-trabzada · MIT · zubair-trabzada/geo-seo-claude

Similar skills

Everything for SEO and GEO →
seo-aeo-geo rampstackco A skill for tuning content and site structure for AI search: citations in model answers, llms.txt, extraction-friendly markup. CX Codex +1 317installs seo-geo ReScienceLab Audits technical SEO, researches keywords and generates JSON-LD markup so search engines and AI answers cite your pages. CX Codex +1 53,900installs geo-content-optimizer aaron-he-zhu A skill for tuning content for GEO and search. The working copy lives in the aaron-marketing-skills bundle; the old repo keeps a frozen one. CX Codex +1 5,300installs blog-geo AgriciDaniel Checks a single blog post file for AI-citation readiness and scores it on a 0-100 heuristic. Handy once the draft exists and you want to know what is missing. CX Codex +1 2,600installs seo AgriciDaniel Runs site audits, technical checks, Schema.org validation, and Generative Engine Optimization. Suitable for SaaS, e-commerce, and local business audits. CX Codex +1 9,000installs keyword-research aaron-he-zhu A keyword research skill for Claude and other AI coding agents. Installs with one command from the seo-geo-claude-skills repo. CX Codex +1 6,800installs

From the same set16

geo-llmstxt Checks an existing llms.txt against the format rules, or builds one by crawling the site, so models get a short map of your pages instead of guessing. CX Codex +1 1,200installs geo-audit A site audit for AI citation: it crawls the pages, splits the work across five subagents and returns a GEO Score from 0 to 100 with a fix list. CX Codex +1 916installs geo-schema Audits JSON-LD, Microdata, and RDFa structured data on web pages, checks validation rules, and generates clean markup for search and AI discovery. CX Codex +1 915installs geo-crawlers Inspects robots.txt rules, meta tags, and HTTP headers for AI crawler access. Helps unblock sites for AI search engines without exposing data blindly. CX Codex +1 870installs geo-citability Grades a page from 0 to 100 on how likely ChatGPT, Claude, Perplexity or Gemini is to quote a passage from it, then names the passages to rewrite. CX Codex +1 844installs geo-technical Audits technical SEO for indexing and AI crawler access. Use it before publishing or when investigating search visibility issues. CX Codex +1 841installs geo-report-pdf Turns a GEO audit markdown report into a PDF with a cover page, color-coded score tables, and a 90-day roadmap. Uses pandoc and Chrome headless. CX Codex +1 833installs geo-content Evaluates articles and landing pages against E-E-A-T criteria to gauge how likely AI search engines are to cite them. CX Codex +1 829installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor