geo

Audits websites for AI search engine visibility and generates GEO optimization reports.

1|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill geo-marshal-nguyen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geo
Source: https://github.com/Marshal-Nguyen/Skill_Claude_Agent/tree/main/claude/skills/geo
Command: npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill geo-marshal-nguyen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beautifulsoup4, requests, lxml, playwright, Pillow, urllib3, validators, reportlab, flask, rich, and includes scripts (resource) components.

What problem does it solve? Traditional SEO no longer guarantees visibility as users shift to AI search engines like ChatGPT, Perplexity, and Google AI Overviews. This Skill audits websites for Generative Engine Optimization (GEO), measuring whether AI crawlers can access the site, whether content is citable by AI models, and whether brand signals exist on platforms AI systems reference. ## Core Features & Use Cases - Full GEO Audits: Runs parallel subagent analysis across citability, AI crawler access, llms.txt, schema markup, technical SEO, and E-E-A-T content quality, producing a weighted 0-100 GEO score. - Citability Scoring: Scores individual content passages (optimal 134-167 words) for AI citation readiness based on answer-block quality, self-containment, and statistical density. - Client Deliverables: Generates client-ready Markdown reports and branded PDF reports with score gauges, bar charts, and prioritized action plans, plus a CRM-lite pipeline for prospects, proposals, and monthly delta comparisons. - Use Case: An agency runs /geo audit https://client-site.com to get a full GEO score, then /geo report-pdf to deliver a professional PDF, and /geo proposal to auto-generate a sales proposal from the audit data. ## Quick Start Ask the AI to run a full GEO audit on a URL, for example: run /geo audit https://example.com and show me the GEO score and top recommendations.

Frequently Asked Questions about geo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a website for AI search visibility?▼

Run the full audit command with a target URL, such as /geo audit https://example.com. The tool fetches the homepage, detects the business type, crawls up to 50 pages from the sitemap, and runs parallel analyses across citability, crawlers, schema, technical SEO, and content quality to produce a weighted GEO score.

What is a good content length for AI citation?▼

Research behind the citability scorer shows optimal AI-cited passages are 134-167 words long. Passages should be self-contained, fact-rich with specific statistics, use definition patterns, and minimize pronouns so AI models can extract them without surrounding context.

How do I check if AI crawlers like GPTBot can access my site?▼

Use the crawler analysis command, which fetches your robots.txt and evaluates rules for GPTBot, ClaudeBot, PerplexityBot, CCBot, Google-Extended, and other AI user agents. It reports each crawler as ALLOWED, BLOCKED, PARTIALLY_BLOCKED, or NOT_MENTIONED.

Does the GEO audit generate a PDF report for clients?▼

Yes. After running a full audit, the report-pdf command compiles the audit data into JSON and calls generate_pdf_report.py, which uses reportlab to build a branded PDF with a score gauge, bar charts, crawler access tables, findings by severity, and a prioritized action plan.

What Python packages are required to run the GEO scripts?▼

The scripts require requests, beautifulsoup4, lxml, and reportlab as core dependencies, with playwright, Pillow, validators, flask, and rich also listed in requirements.txt. Install them with pip install -r requirements.txt before running any script.

What are the limitations of the automated GEO audit?▼

Audits are capped at 50 pages with a 30-second timeout per page and a 1-second delay between requests. Brand mention checks on YouTube, Reddit, and LinkedIn provide search URLs and instructions rather than full API verification, so some manual confirmation is needed.