geo
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.
- Installs
- 942
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/zubair-trabzada/geo-seo-claude --skill geo- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads geo automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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 | |
| 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
FAQ
What does the geo skill do?
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.
How do I install geo?
Run npx skills add https://github.com/zubair-trabzada/geo-seo-claude --skill geo in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/geo/ (personal) or .claude/skills/geo/ (project).
Which AI agents can use geo?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is geo safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains geo?
It is published by zubair-trabzada in zubair-trabzada/geo-seo-claude. It has 942 recorded installs.
More from zubair-trabzada/geo-seo-claude
geo-llmstxt
zubair-trabzada/geo-seo-claude
Analyzes and generates llms.txt files -- the emerging standard for helping AI systems understand website structure and content. Can validate existing llms.txt files or generate new ones from scratch by crawling the site.
geo-audit
zubair-trabzada/geo-seo-claude
Full website GEO+SEO audit with parallel subagent delegation. Orchestrates a comprehensive Generative Engine Optimization audit across AI citability, platform analysis, technical infrastructure, content quality, and schema markup. Produces a composite GEO Score (0-100) with prioritized action plan.
geo-schema
zubair-trabzada/geo-seo-claude
Schema.org structured data audit and generation optimized for AI discoverability — detect, validate, and generate JSON-LD markup
geo-crawlers
zubair-trabzada/geo-seo-claude
AI crawler access analysis. Checks robots.txt, meta tags, and HTTP headers to determine which AI crawlers can access the site. Provides a complete access map and recommendations for maximizing AI visibility while maintaining appropriate control.
geo-citability
zubair-trabzada/geo-seo-claude
AI citability scoring and optimization. Analyzes web page content to determine how likely AI systems (ChatGPT, Claude, Perplexity, Gemini) are to cite or quote passages from the page. Provides a citability score (0-100) with specific rewrite suggestions.
geo-technical
zubair-trabzada/geo-seo-claude
Technical SEO audit with GEO-specific checks — crawlability, indexability, security, performance, SSR, and AI crawler access
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet