GEO-first SEO analysis tool

GEO-SEO Analysis Tool — Claude Code Skill (February 2026)

by zubair-trabzada · MIT license · ★ 10,775 on GitHub · updated Sep 21

GEO-first SEO analysis tool. Optimizes websites for AI-powered search engines (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.

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

Overview

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)

Example prompts

/geo update/geo citability/geo crawlers/geo llmstxt

Manual install (npx, ZIP)

Claude Codenpx skills add zubair-trabzada/geo-seo-claude --skill geo -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/zubair-trabzada/geo-seo-claude/tar.gz/383829485f86 \
  | tar -xz -C ~/.claude/skills --strip-components=1 geo-seo-claude-383829485f86/geo

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/fae73e3066201faaa6ae/geo.zip" -OutFile "$env:TEMP\geo.zip"; Expand-Archive "$env:TEMP\geo.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md10.9 KB

Read the files here

zubair-trabzada/38382941 file

SKILL.md10.9 KB

Shared references6SKILL.md reads these from elsewhere in the repo. Not in the ZIP.

Get them on GitHub ↗

SKILL.md

Show the full text252 lines

geo/SKILL.md252 lines · 10.9 KB

PreviewCode

Outline

RawView on GitHub

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/100 values 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 produce GEO-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.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

1	---
2	name: geo
3	description: >
4	GEO-first SEO analysis tool. Optimizes websites for AI-powered search engines
5	(ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining
6	traditional SEO foundations. Performs full GEO audits, citability scoring,
7	AI crawler analysis, llms.txt generation, brand mention scanning, platform-specific
8	optimization, schema markup, technical SEO, content quality (E-E-A-T), and
9	client-ready GEO report generation. Use when user says "geo", "seo", "audit",
10	"AI search", "AI visibility", "optimize", "citability", "llms.txt", "schema",
11	"brand mentions", "GEO report", or any URL for analysis.
12	allowed-tools: Read, Grep, Glob, Bash, WebFetch, Write
13	---
14
15	# GEO-SEO Analysis Tool — Claude Code Skill (February 2026)
16
17	> Philosophy: GEO-first, SEO-supported. AI search is eating traditional search.
18	> This tool optimizes for where traffic is going, not where it was.
19
20	---
21
22	## Quick Reference
23
24	\| Command \| What It Does \|
25	\|---------\|-------------\|
26	\| `/geo audit <url>` \| Full GEO + SEO audit with parallel subagents \|
27	\| `/geo page <url>` \| Deep single-page GEO analysis \|
28	\| `/geo citability <url>` \| Score content for AI citation readiness \|
29	\| `/geo crawlers <url>` \| Check AI crawler access (robots.txt analysis) \|
30	\| `/geo llmstxt <url>` \| Analyze or generate llms.txt file \|
31	\| `/geo brands <url>` \| Scan brand mentions across AI-cited platforms \|
32	\| `/geo platforms <url>` \| Platform-specific optimization (ChatGPT, Perplexity, Google AIO) \|
33	\| `/geo schema <url>` \| Detect, validate, and generate structured data \|
34	\| `/geo technical <url>` \| Traditional technical SEO audit \|
35	\| `/geo content <url>` \| Content quality and E-E-A-T assessment \|
36	\| `/geo report <url>` \| Generate client-ready GEO deliverable \|
37	\| `/geo report-pdf <url>` \| Generate professional PDF report with charts and scores \|
38	\| `/geo quick <url>` \| 60-second GEO visibility snapshot \|
39	\| `/geo prospect <cmd>` \| CRM-lite: manage prospects through the sales pipeline \|
40	\| `/geo proposal <domain>` \| Auto-generate client proposal from audit data \|
41	\| `/geo compare <domain>` \| Monthly delta report: show score improvements to client \|
42	\| `/geo update` \| Pull latest GEO skill updates from upstream \|
43
44	---
45
46	## Market Context (Why GEO Matters)
47
48	\| Metric \| Value \| Source \|
49	\|--------\|-------\|--------\|
50	\| GEO services market (2025) \| $850M-$886M \| Yahoo Finance / Superlines \|
51	\| Projected GEO market (2031) \| $7.3B (34% CAGR) \| Industry analysts \|
52	\| AI-referred sessions growth \| +527% (Jan-May 2025) \| SparkToro \|
53	\| AI traffic conversion vs organic \| 4.4x higher \| Industry data \|
54	\| Google AI Overviews reach \| 1.5B users/month, 200+ countries \| Google \|
55	\| ChatGPT weekly active users \| 900M+ \| OpenAI \|
56	\| Perplexity monthly queries \| 500M+ \| Perplexity \|
57	\| Gartner: search traffic drop by 2028 \| -50% \| Gartner \|
58	\| Marketers investing in GEO \| Only 23% \| Industry surveys \|
59	\| Brand mentions vs backlinks for AI \| 3x stronger correlation \| Ahrefs (Dec 2025) \|
60
61	---
62
63	## Orchestration Logic
64
65	### Full Audit (`/geo audit <url>`)
66
67	Phase 1: Discovery (Sequential)
68	1. Fetch homepage HTML (curl or WebFetch)
69	2. Detect business type (SaaS, Local, E-commerce, Publisher, Agency, Other)
70	3. Extract key pages from sitemap.xml or internal links (up to 50 pages)
71
72	Phase 2: Parallel Analysis (Delegate to Subagents)
73	Launch these 5 subagents simultaneously:
74
75	\| Subagent \| File \| Responsibility \|
76	\|----------\|------\|---------------\|
77	\| geo-ai-visibility \| `agents/geo-ai-visibility.md` \| GEO audit, citability, AI crawlers, llms.txt, brand mentions \|
78	\| geo-platform-analysis \| `agents/geo-platform-analysis.md` \| Platform-specific optimization (ChatGPT, Perplexity, Google AIO) \|
79	\| geo-technical \| `agents/geo-technical.md` \| Technical SEO, Core Web Vitals, crawlability, indexability \|
80	\| geo-content \| `agents/geo-content.md` \| Content quality, E-E-A-T, readability, AI content detection \|
81	\| geo-schema \| `agents/geo-schema.md` \| Schema markup detection, validation, generation \|
82
83	Phase 3: Synthesis (Sequential)
84	1. Collect all subagent reports
85	2. Calculate composite GEO Score (0-100)
86	3. Generate prioritized action plan
87	4. Output client-ready report
88
89	### Scoring Methodology
90
91	\| Category \| Weight \| Measured By \|
92	\|----------\|--------\|-------------\|
93	\| AI Citability & Visibility \| 25% \| Passage scoring, answer block quality, AI crawler access \|
94	\| Brand Authority Signals \| 20% \| Mentions on Reddit, YouTube, Wikipedia, LinkedIn; entity presence \|
95	\| Content Quality & E-E-A-T \| 20% \| Expertise signals, original data, author credentials \|
96	\| Technical Foundations \| 15% \| SSR, Core Web Vitals, crawlability, mobile, security \|
97	\| Structured Data \| 10% \| Schema completeness, JSON-LD validation, rich result eligibility \|
98	\| Platform Optimization \| 10% \| Platform-specific readiness (Google AIO, ChatGPT, Perplexity) \|
99
100	---
101
102	## Business Type Detection
103
104	Analyze homepage for patterns:
105
106	\| Type \| Signals \|
107	\|------\|---------\|
108	\| SaaS \| Pricing page, "Sign up", "Free trial", "/app", "/dashboard", API docs \|
109	\| Local Service \| Phone number, address, "Near me", Google Maps embed, service area \|
110	\| E-commerce \| Product pages, cart, "Add to cart", price elements, product schema \|
111	\| Publisher \| Blog, articles, bylines, publication dates, article schema \|
112	\| Agency \| Portfolio, case studies, "Our services", client logos, testimonials \|
113	\| Other \| Default — apply general GEO best practices \|
114
115	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.
116
117	---
118
119	## Sub-Skills (14 Specialized Components)
120
121	\| # \| Skill \| Directory \| Purpose \|
122	\|---\|-------\|-----------\|---------\|
123	\| 1 \| geo-audit \| `skills/geo-audit/` \| Full audit orchestration and scoring \|
124	\| 2 \| geo-citability \| `skills/geo-citability/` \| Passage-level AI citation readiness \|
125	\| 3 \| geo-crawlers \| `skills/geo-crawlers/` \| AI crawler access and robots.txt \|
126	\| 4 \| geo-llmstxt \| `skills/geo-llmstxt/` \| llms.txt standard analysis and generation \|
127	\| 5 \| geo-brand-mentions \| `skills/geo-brand-mentions/` \| Brand presence on AI-cited platforms \|
128	\| 6 \| geo-platform-optimizer \| `skills/geo-platform-optimizer/` \| Platform-specific AI search optimization \|
129	\| 7 \| geo-schema \| `skills/geo-schema/` \| Structured data for AI discoverability \|
130	\| 8 \| geo-technical \| `skills/geo-technical/` \| Technical SEO foundations \|
131	\| 9 \| geo-content \| `skills/geo-content/` \| Content quality and E-E-A-T \|
132	\| 10 \| geo-report \| `skills/geo-report/` \| Client-ready deliverable generation \|
133	\| 11 \| geo-prospect \| `skills/geo-prospect/` \| CRM-lite prospect and client pipeline management \|
134	\| 12 \| geo-proposal \| `skills/geo-proposal/` \| Auto-generate client proposals from audit data \|
135	\| 13 \| geo-compare \| `skills/geo-compare/` \| Monthly delta tracking and progress reports \|
136	\| 14 \| geo-update \| `skills/geo-update/` \| Pull latest updates from upstream repository \|
137
138	---
139
140	## Subagents (5 Parallel Workers)
141
142	\| Agent \| File \| Skills Used \|
143	\|-------\|------\|-------------\|
144	\| geo-ai-visibility \| `agents/geo-ai-visibility.md` \| geo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions \|
145	\| geo-platform-analysis \| `agents/geo-platform-analysis.md` \| geo-platform-optimizer \|
146	\| geo-technical \| `agents/geo-technical.md` \| geo-technical \|
147	\| geo-content \| `agents/geo-content.md` \| geo-content \|
148	\| geo-schema \| `agents/geo-schema.md` \| geo-schema \|
149
150	---
151
152	## Output Files
153
154	All commands generate structured output:
155
156	\| Command \| Output File \|
157	\|---------\|------------\|
158	\| `/geo audit` \| `GEO-AUDIT-REPORT.md` \|
159	\| `/geo page` \| `GEO-PAGE-ANALYSIS.md` \|
160	\| `/geo citability` \| `GEO-CITABILITY-SCORE.md` \|
161	\| `/geo crawlers` \| `GEO-CRAWLER-ACCESS.md` \|
162	\| `/geo llmstxt` \| `llms.txt` (ready to deploy) \|
163	\| `/geo brands` \| `GEO-BRAND-MENTIONS.md` \|
164	\| `/geo platforms` \| `GEO-PLATFORM-OPTIMIZATION.md` \|
165	\| `/geo schema` \| `GEO-SCHEMA-REPORT.md` + generated JSON-LD \|
166	\| `/geo technical` \| `GEO-TECHNICAL-AUDIT.md` \|
167	\| `/geo content` \| `GEO-CONTENT-ANALYSIS.md` \|
168	\| `/geo report` \| `GEO-CLIENT-REPORT.md` (presentation-ready) \|
169	\| `/geo report-pdf` \| `GEO-REPORT.pdf` (professional PDF with charts) \|
170	\| `/geo quick` \| Inline summary (no file) \|
171	\| `/geo prospect` \| Updates `~/.geo-prospects/prospects.json` \|
172	\| `/geo proposal` \| `~/.geo-prospects/proposals/<domain>-proposal-<date>.md` \|
173	\| `/geo compare` \| `~/.geo-prospects/reports/<domain>-monthly-<YYYY-MM>.md` \|
174
175	---
176
177	## PDF Report Generation
178
179	The `/geo report-pdf <url>` command converts `GEO-AUDIT-REPORT.md` into a styled, client-ready PDF.
180
181	### Requirements
182	- pandoc — `brew install pandoc`
183	- Google Chrome — `/Applications/Google Chrome.app/` (standard Mac install)
184
185	No Python dependencies required for PDF generation.
186
187	### What the PDF Includes
188	- Cover page — dark navy gradient, GEO score badge, brand/domain/date/location metadata
189	- Color-coded score tables — cells with `XX/100` values are automatically colored green/blue/amber/orange/red
190	- Severity-tagged findings — Critical/High/Medium/Low sections get colored left-border callout blocks
191	- Section page breaks — major sections break to new pages automatically
192	- Styled code blocks — JSON schema templates render with dark monospace theme
193
194	### Templates
195	Bundled at `~/.claude/skills/geo/templates/`:
196	- `geo-report-style.css` — stylesheet (edit colors, fonts, layout here)
197	- `geo-report-template.html` — pandoc HTML template (edit cover fields here)
198
199	### Workflow
200	1. Run `/geo audit <url>` to produce `GEO-AUDIT-REPORT.md`
201	2. Run `/geo report-pdf` — extracts metadata from the report and runs:
202	```bash
203	pandoc GEO-AUDIT-REPORT.md \
204	--to html5 --standalone --embed-resources \
205	--template ~/.claude/skills/geo/templates/geo-report-template.html \
206	--css ~/.claude/skills/geo/templates/geo-report-style.css \
207	--metadata brand_name="..." --metadata geo_score="..." \
208	-o GEO-REPORT.html
209
210	"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
211	--headless=new --disable-gpu --no-sandbox \
212	--print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
213	--print-to-pdf-no-header --no-pdf-header-footer \
214	--virtual-time-budget=5000 \
215	"file://$(pwd)/GEO-REPORT.html"
216	```
217	3. Output: `GEO-REPORT.pdf` in the current directory
218
219	---
220
221	## Quality Gates
222
223	- Crawl limit: Max 50 pages per audit (focus on quality over quantity)
224	- Timeout: 30 seconds per page fetch
225	- Rate limiting: 1-second delay between requests, max 5 concurrent
226	- Robots.txt: Always respect, always check
227	- Duplicate detection: Skip pages with >80% content similarity
228
229	---
230
231	## Quick Start Examples
232
233	```
234	# Full GEO audit of a website
235	/geo audit https://example.com
236
237	# Check if AI bots can see your site
238	/geo crawlers https://example.com
239
240	# Score a specific page for AI citability
241	/geo citability https://example.com/blog/best-article
242
243	# Generate an llms.txt file for your site
244	/geo llmstxt https://example.com
245
246	# Get a 60-second visibility snapshot
247	/geo quick https://example.com
248
249	# Generate a client-ready report
250	/geo report https://example.com
251	```
252