geo
Skill0 starsChanged 6 months agoMITView on GitHub
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.
24 other projects use a version of this, 6 of them edited.
Adopted by
Most recently taken up by
- dotaclover/clover-skillstheir own version, first seen Nov 16, 2026
- flavien-ia/hypervibe-harnesstheir own version, first seen Nov 15, 2026
- alpit-patel/seo-aeo-geo-kitedited, first seen Nov 8, 2026
- cihantopac/searvextheir own version, first seen Nov 8, 2026
- Ghanyte/geo-seo-audittheir own version, first seen Nov 8, 2026
- sneakers-the-rat/muse-skillstheir own version, first seen Nov 1, 2026
Other versions24 projects use a version of this.
Word for word · 0
None found.
Edited · 6
- zubair-trabzada/geo-seo-claude★ 11k81% same
- techhorizonlabs/thl-open★ 1663% same
- alpit-patel/seo-aeo-geo-kit★ 278% same
- HermeticOrmus/LibreGEO-Claude-Code★ 192% same
- Ormus-Solutions/LibreGEO-Claude-Code★ 192% same
- RonManatee/geo-seo★ 097% same
Wrote their own version · 18
- liangdabiao/GEO-Content-Optimizer-Skill★ 183same name
- Hainrixz/claude-seo-ai★ 81same name
- flavien-ia/hypervibe-craft★ 52same name
- flavien-ia/hypervibe-harness★ 52same name
- rainday/smart-blog-skills★ 35same name
- sneakers-the-rat/muse-skills★ 25same name
- yuanhao667/Skills★ 10same name
- Ghanyte/geo-seo-audit★ 9same name
- melgarafael/youtube-growth★ 8same name
- cihantopac/searvex★ 5same name
8 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository14 other files it gives its agents.
- geo-auditSkill
- geo-brand-mentionsSkill
- geo-citabilitySkill
- geo-compareSkill
- geo-contentSkill
- geo-crawlersSkill
- geo-llmstxtSkill
- geo-platform-optimizerSkill
- geo-proposalSkill
- geo-prospectSkill
- geo-report-pdfSkill
- geo-reportSkill
- geo-schemaSkill
- geo-technicalSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 18 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 152
All commands generate structured output:
- Distinctive: line 180
Run the full audit or individual analyses first
- Distinctive: line 206
Robots.txt: Always respect, always check
“Common” is measured: kept by at least 6 in 10 of the 18 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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 | 3x stronger correlation | Ahrefs (Dec 2025) |
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 (13 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 |
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.comDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

