version: "1.0.0" name: geo description: "Master GEO and SEO skill that routes a website question to the right specialist: full audits, single-page analysis, quick snapshots, citability, AI crawler access, llms.txt, brand mentions, platform optimization, schema, technical SEO, E-E-A-T content, and Markdown or PDF reports. Use when the user asks about AI search visibility, GEO, SEO, llms.txt, schema, or brand mentions, or shares a URL to analyze without naming a specific check." 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

Market Context (Why GEO Matters)

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:

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

Business Type Detection

Analyze homepage for patterns:

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 (10 Specialized Components)

Subagents (5 Parallel Workers)

Output Files

All commands generate structured output:

PDF Report Generation

The /geo report-pdf <url> command generates a professional, branded PDF report:

How It Works

1. Run the full audit or individual analyses first
2. Collect all scores and findings into a JSON structure
3. Execute the PDF generator: python3 "${CLAUDE_SKILL_DIR}/scripts/generate_pdf_report.py" data.json GEO-REPORT.pdf

What the PDF Includes

• Cover page with GEO score gauge visualization
• Score breakdown with color-coded bar charts
• AI Platform Readiness dashboard with horizontal bar chart
• Crawler Access status table with color-coded Allow/Block
• Key Findings categorized by severity (Critical/High/Medium/Low)
• Prioritized Action Plan (Quick Wins, Medium-Term, Strategic)
• Methodology & Glossary appendix

Workflow

1. First run /geo audit <url> to collect all data
2. Then run /geo report-pdf <url> to generate the PDF
3. The tool will compile audit data into JSON, then generate the PDF
4. 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