Geo-seo-claude geo

install

source · Clone the upstream repo

git clone https://github.com/zubair-trabzada/geo-seo-claude

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/zubair-trabzada/geo-seo-claude "$T" && mkdir -p ~/.claude/skills && cp -r "$T/geo" ~/.claude/skills/zubair-trabzada-geo-seo-claude-geo && rm -rf "$T"

manifest: geo/SKILL.md

source content

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


skills/geo-audit/
skills/geo-citability/
skills/geo-crawlers/
skills/geo-llmstxt/
skills/geo-brand-mentions/
skills/geo-platform-optimizer/
skills/geo-schema/
skills/geo-technical/
skills/geo-content/
skills/geo-report/
skills/geo-prospect/
skills/geo-proposal/
skills/geo-compare/

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.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

#	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