geo-audit
starsforks
How to install geo-audit?
zubair-trabzada/geo-seo-claude/geo-audit
$npx -y skills add zubair-trabzada/geo-seo-claude --skill geo-auditFull 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 prior
SKILL.md
| 1 | # GEO Audit Orchestration Skill |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | This skill performs a comprehensive Generative Engine Optimization (GEO) audit of any website. GEO is the practice of optimizing web content so that AI systems (ChatGPT, Claude, Perplexity, Gemini, etc.) can discover, understand, cite, and recommend it. This audit measures how well a site performs across all GEO dimensions and produces an actionable improvement plan. |
| 6 | |
| 7 | ## Key Insight |
| 8 | |
| 9 | Traditional SEO optimizes for search engine rankings. GEO optimizes for AI citation and recommendation. Sites that score high on GEO metrics see 30-115% more visibility in AI-generated responses (Georgia Tech / Princeton / IIT Delhi 2024 study). The two disciplines overlap but have distinct requirements. |
| 10 | |
| 11 | --- |
| 12 | |
| 13 | ## Audit Workflow |
| 14 | |
| 15 | ### Phase 1: Discovery and Reconnaissance |
| 16 | |
| 17 | **Step 1: Fetch Homepage and Detect Business Type** |
| 18 | |
| 19 | 1. Use WebFetch to retrieve the homepage at the provided URL. |
| 20 | 2. Extract the following signals: |
| 21 | - Page title, meta description, H1 heading |
| 22 | - Navigation menu items (reveals site structure) |
| 23 | - Footer content (reveals business info, location, legal pages) |
| 24 | - Schema.org markup on homepage (Organization, LocalBusiness, etc.) |
| 25 | - Pricing page link (SaaS indicator) |
| 26 | - Product listing patterns (E-commerce indicator) |
| 27 | - Blog/resource section (Publisher indicator) |
| 28 | - Service pages (Agency indicator) |
| 29 | - Address/phone/Google Maps embed (Local business indicator) |
| 30 | |
| 31 | 3. Classify the business type using these patterns: |
| 32 | |
| 33 | | Business Type | Detection Signals | |
| 34 | |---|---| |
| 35 | | **SaaS** | Pricing page, "Sign up" / "Free trial" CTAs, app.domain.com subdomain, feature comparison tables, integration pages | |
| 36 | | **Local Business** | Physical address on homepage, Google Maps embed, "Near me" content, LocalBusiness schema, service area pages | |
| 37 | | **E-commerce** | Product listings, shopping cart, product schema, category pages, price displays, "Add to cart" buttons | |
| 38 | | **Publisher** | Blog-heavy navigation, article schema, author pages, date-based archives, RSS feeds, high content volume | |
| 39 | | **Agency/Services** | Case studies, portfolio, "Our Work" section, team page, client logos, service descriptions | |
| 40 | | **Hybrid** | Combination of above signals -- classify by dominant pattern | |
| 41 | |
| 42 | **Step 2: Crawl Sitemap and Internal Links** |
| 43 | |
| 44 | 1. Attempt to fetch `/sitemap.xml` and `/sitemap_index.xml`. |
| 45 | 2. If sitemap exists, extract up to 50 unique page URLs prioritized by: |
| 46 | - Homepage (always include) |
| 47 | - Top-level navigation pages |
| 48 | - High-value pages (pricing, about, contact, key service/product pages) |
| 49 | - Blog posts (sample 5-10 most recent) |
| 50 | - Category/landing pages |
| 51 | 3. If no sitemap exists, crawl internal links from the homepage: |
| 52 | - Extract all `<a href>` links pointing to the same domain |
| 53 | - Follow up to 2 levels deep |
| 54 | - Prioritize pages linked from main navigation |
| 55 | 4. Respect `robots.txt` directives -- do not fetch disallowed paths. |
| 56 | 5. Enforce a maximum of 50 pages and a 30-second timeout per fetch. |
| 57 | |
| 58 | **Step 3: Collect Page-Level Data** |
| 59 | |
| 60 | For each page in the crawl set, record: |
| 61 | - URL, title, meta description, canonical URL |
| 62 | - H1-H6 heading structure |
| 63 | - Word count of main content |
| 64 | - Schema.org types present |
| 65 | - Internal/external link counts |
| 66 | - Images with/without alt text |
| 67 | - Open Graph and Twitter Card meta tags |
| 68 | - Response status code |
| 69 | - Whether the page has structured data |
| 70 | |
| 71 | --- |
| 72 | |
| 73 | ### Phase 2: Parallel Subagent Delegation |
| 74 | |
| 75 | Delegate analysis to 5 specialized subagents. Each subagent operates on the collected page data and produces a category score (0-100) plus findings. |
| 76 | |
| 77 | **Subagent 1: AI Visibility Analysis (geo-ai-visibility)** |
| 78 | - Analyze content blocks for quotability by AI systems (citability scoring) |
| 79 | - Check AI crawler access via robots.txt and llms.txt presence |
| 80 | - Scan brand presence across YouTube, Reddit, Wikipedia, LinkedIn |
| 81 | - Score brand authority signals that AI models use for entity recognition |
| 82 | |
| 83 | **Subagent 2: Platform Optimization (geo-platform-analysis)** |
| 84 | - Assess readiness for Google AI Overviews, ChatGPT, Perplexity, Gemini, Bing Copilot |
| 85 | - Check platform-specific ranking factors and optimization opportunities |
| 86 | |
| 87 | **Subagent 3: Technical GEO Infrastructure (geo-technical)** |
| 88 | - Analyze robots.txt for AI crawler access |
| 89 | - Verify meta tags, headers, and technical accessibility for AI systems |
| 90 | - Check page speed, server-side rendering, and Core Web Vitals |
| 91 | - Assess security headers and mobile optimization |
| 92 | |
| 93 | **Subagent 4: Content E-E-A-T Quality (geo-content)** |
| 94 | - Evaluate Experience, Expertise, Authoritativeness, Trustworthiness signals |
| 95 | - Check author bios, credentials, source citations |
| 96 | - Ass |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
