thesmokedev/geo-skills/geo

Claude Code and agent skill by thesmokedev/geo-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

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.

Install

npx vskill@latest install thesmokedev/geo-skills/geo

SKILL.md

The same SKILL.md was published earlier as thesmokedev/geo-skills/geo.

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

CommandWhat 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)

MetricValueSource
GEO services market (2025)$850M-$886MYahoo 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 organic4.4x higherIndustry data
Google AI Overviews reach1.5B users/month, 200+ countriesGoogle
ChatGPT weekly active users900M+OpenAI
Perplexity monthly queries500M+Perplexity
Gartner: search traffic drop by 2028-50%Gartner
Marketers investing in GEOOnly 23%Industry surveys
Brand mentions vs backlinks for AIBranded 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)

  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:

SubagentFileResponsibility
geo-ai-visibilityagents/geo-ai-visibility.mdGEO audit, citability, AI crawlers, llms.txt, brand mentions
geo-platform-analysisagents/geo-platform-analysis.mdPlatform-specific optimization (ChatGPT, Perplexity, Google AIO)
geo-technicalagents/geo-technical.mdTechnical SEO, Core Web Vitals, crawlability, indexability
geo-contentagents/geo-content.mdContent quality, E-E-A-T, readability, AI content detection
geo-schemaagents/geo-schema.mdSchema 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
CategoryWeightMeasured By
AI Citability & Visibility25%Passage scoring, answer block quality, AI crawler access
Brand Authority Signals20%Mentions on Reddit, YouTube, Wikipedia, LinkedIn; entity presence
Content Quality & E-E-A-T20%Expertise signals, original data, author credentials
Technical Foundations15%SSR, Core Web Vitals, crawlability, mobile, security
Structured Data10%Schema completeness, JSON-LD validation, rich result eligibility
Platform Optimization10%Platform-specific readiness (Google AIO, ChatGPT, Perplexity)

Business Type Detection

Analyze homepage for patterns:

TypeSignals
SaaSPricing page, "Sign up", "Free trial", "/app", "/dashboard", API docs
Local ServicePhone number, address, "Near me", Google Maps embed, service area
E-commerceProduct pages, cart, "Add to cart", price elements, product schema
PublisherBlog, articles, bylines, publication dates, article schema
AgencyPortfolio, case studies, "Our services", client logos, testimonials
OtherDefault — 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)

#SkillDirectoryPurpose
1geo-auditskills/geo-audit/Full audit orchestration and scoring
2geo-citabilityskills/geo-citability/Passage-level AI citation readiness
3geo-crawlersskills/geo-crawlers/AI crawler access and robots.txt
4geo-llmstxtskills/geo-llmstxt/llms.txt facts-hedge analysis and generation (anti-hallucination hygiene, not a visibility lever)
5geo-brand-mentionsskills/geo-brand-mentions/Brand presence on AI-cited platforms
6geo-platform-optimizerskills/geo-platform-optimizer/Platform-specific AI search optimization
7geo-schemaskills/geo-schema/Structured data for rich results and entity clarity
8geo-technicalskills/geo-technical/Technical SEO foundations
9geo-contentskills/geo-content/Content quality and E-E-A-T
10geo-reportskills/geo-report/Client-ready deliverable generation
11geo-prospectskills/geo-prospect/CRM-lite prospect and client pipeline management
12geo-proposalskills/geo-proposal/Auto-generate client proposals from audit data
13geo-compareskills/geo-compare/Monthly delta tracking and progress reports

Subagents (5 Parallel Workers)

AgentFileSkills Used
geo-ai-visibilityagents/geo-ai-visibility.mdgeo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions
geo-platform-analysisagents/geo-platform-analysis.mdgeo-platform-optimizer
geo-technicalagents/geo-technical.mdgeo-technical
geo-contentagents/geo-content.mdgeo-content
geo-schemaagents/geo-schema.mdgeo-schema

Output Files

All commands generate structured output:

CommandOutput File
/geo auditGEO-AUDIT-REPORT.md
/geo pageGEO-PAGE-ANALYSIS.md
/geo citabilityGEO-CITABILITY-SCORE.md
/geo crawlersGEO-CRAWLER-ACCESS.md
/geo llmstxtllms.txt (ready to deploy)
/geo brandsGEO-BRAND-MENTIONS.md
/geo platformsGEO-PLATFORM-OPTIMIZATION.md
/geo schemaGEO-SCHEMA-REPORT.md + generated JSON-LD
/geo technicalGEO-TECHNICAL-AUDIT.md
/geo contentGEO-CONTENT-ANALYSIS.md
/geo reportGEO-CLIENT-REPORT.md (presentation-ready)
/geo report-pdfGEO-REPORT.pdf (professional PDF with charts)
/geo quickInline summary (no file)
/geo prospectUpdates ~/.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
  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/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
  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

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
25
Repository forks
6
7-day trend score
16

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/thesmokedev/geo-skills/geo/badge)](https://verified-skill.com/skills/thesmokedev/geo-skills/geo)

Something wrong with this skill or its page? Tell us.