TheSmokeDev 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 |
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 | |
| 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 | Branded web mentions r=0.664, YouTube mentions r=0.737; raw backlink counts far weaker (directional only — precise figure has no locatable primary source) | Ahrefs 75K brands (Jul 2026) |
Orchestration Logic
Full Audit (/geo audit <url>)
Phase 1: Discovery (Sequential)
- Fetch homepage HTML (curl or WebFetch)
- Detect business type (SaaS, Local, E-commerce, Publisher, Agency, Other)
- 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)
- Collect all subagent reports
- Calculate composite GEO Score (0-100)
- Generate prioritized action plan
- 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 (10 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 facts-hedge analysis and generation (anti-hallucination hygiene, not a visibility lever) |
| 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 rich results and entity clarity |
| 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 |
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 generates a professional, branded PDF report:
How It Works
- Run the full audit or individual analyses first
- Collect all scores and findings into a JSON structure
- Execute the PDF generator:
python3 ~/.claude/skills/geo/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
- First run
/geo audit <url>to collect all data - Then run
/geo report-pdf <url>to generate the PDF - The tool will compile audit data into JSON, then generate the PDF
- Output:
GEO-REPORT.pdfin 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