Automated summary
A GEO-first SEO analysis tool that evaluates and optimizes a website for AI-powered search engines (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while keeping traditional SEO foundations intact.
Strengths
- Full audit orchestrated through five parallel subagents covering AI visibility, platforms, technical SEO, content and schema
- Covers GEO-specific work: citability scoring, AI crawler access via robots.txt, llms.txt generation and brand mention scanning
- Produces client deliverables: GEO reports, charted PDFs, proposals and monthly delta comparison reports
Limitations
- Requires network access (curl/WebFetch) to the target site and relies on its public data
- Citability and AI visibility scores are internal heuristics, not actual measurements of citations in AI engines
- Includes sales-oriented features (CRM-lite, proposals) that go beyond a plain SEO audit
Use it when you need to assess or improve a site's visibility in AI search answers and hand over a client-ready deliverable.
Avoid it for pure technical SEO or deep editorial rewriting, or when the site cannot be reached over the network.
Security analysis
CautionThe skill is a legitimate SEO/GEO auditing workflow. It uses powerful tools (bash, curl/WebFetch, file writes, subagents) but for plausible purposes: crawling pages, analyzing robots.txt/schema, and writing client reports. There is no obfuscation, no curl|sh piping, no credential/token exfiltration, and no destructive commands. The only notable concerns are the unspecified 'update from upstream' mechanism and local storage of prospect data, which warrant caution but not a risky rating.
- •Declared tools include Bash, WebFetch, and Write — the skill fetches arbitrary user-supplied URLs and writes report files to disk
- •The `/geo update` command 'pulls latest GEO skill updates from upstream' without specifying a pinned/verified source, a mild supply-chain/integrity concern
- •The `/geo prospect` CRM-lite workflow implies storing client/business data locally, though no handling of secrets or credentials is described
- •Parallel subagents inherit broad tool access; no sandboxing or output-scope limits are stated
Examples
Run a full GEO audit of https://example.com and generate a client-ready report.Check whether GPTBot and ClaudeBot can crawl https://example.com and whether the site has an llms.txt file.Score this page for AI citation readiness and tell me what to fix: https://example.com/blog/postname: 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)
- 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 (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/100values 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
- Run
/geo audit <url>to produceGEO-AUDIT-REPORT.md - Run
/geo report-pdf— extracts metadata from the report and runs: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" - 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
From the file to a first result
The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.
View the source and supporting filesThis download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.
1. Download the file
Download SKILL.mdFrom the root of a test project, save the file as .skill-downloads/geo-seo-analysis-tool-mrwakav7/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.
Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.
mkdir -p '.skill-downloads/geo-seo-analysis-tool-mrwakav7' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/geo-seo-analysis-tool-mrwakav7/download' --output '.skill-downloads/geo-seo-analysis-tool-mrwakav7/SKILL.md.part' && mv '.skill-downloads/geo-seo-analysis-tool-mrwakav7/SKILL.md.part' '.skill-downloads/geo-seo-analysis-tool-mrwakav7/SKILL.md'2. Check prerequisites
Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.
Tools declared by the author (check availability in your agent): Read, Grep, Glob, Bash, WebFetch, Write
Original excerpt: 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 |
The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.
3. Load the skill
After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.
Claude Code
test -f '.skill-downloads/geo-seo-analysis-tool-mrwakav7/SKILL.md' && test -s '.skill-downloads/geo-seo-analysis-tool-mrwakav7/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/geo' && cp -R '.skill-downloads/geo-seo-analysis-tool-mrwakav7' '.claude/skills/geo'OpenSkills
OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.
Official OpenSkills installationopenskills install './.skill-downloads/geo-seo-analysis-tool-mrwakav7'openskills read 'geo-seo-analysis-tool-mrwakav7'Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.
For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.
openskills syncManual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.
4. Try a first task
Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:
Read .skill-downloads/geo-seo-analysis-tool-mrwakav7/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.
Writing Fragments
Content
Mine raw writing fragments through a relentless interview, without imposing structure. Capture ideas, quotes, and leading words for later use.
UI Copywriting & Auditing
Content
Write or audit user-facing UI copy including buttons, errors, empty states, and tooltips across the monorepo, following the design system source of truth.
Music MIDI Extraction
Content
Extracts the MIDI or score from an existing music production via the CogMusic MCP tool and confirms availability.