Writing & Content

GEO-SEO AI Search Optimization Audit Skill

A GEO-first SEO audit skill for the AI search era: scores how citable your site is to ChatGPT, Perplexity, and Google AI Overviews, and produces client-ready reports.

43/ 100
Not recommended

Current benefit does not outweigh risk or uncertainty.

See how it was scored ↓
Works as-is in
Claude Code
Stars
★ 11k
Last updated
20d ago
License
MIT
geoseo-auditllms-txtschema-markup
+4citability-scoringbrand-mentionspdf-reportinge-e-a-t

What does this skill do, and when should you use it?

This is a GEO (Generative Engine Optimization) audit skill that runs inside Claude Code, with a stated philosophy of GEO-first, SEO-supported. It performs full audits of any website covering AI visibility, citability scoring, AI crawler robots.txt analysis, llms.txt generation, brand mention scanning, schema markup, technical SEO, and content E-E-A-T assessment. During an audit it orchestrates 5 parallel subagents and synthesizes a composite 0-100 GEO Score with a prioritized action plan. It also bundles a lightweight CRM for GEO agencies (prospects, proposals, monthly delta reports) and can export chart-bearing PDF client reports.

Fetches pages via curl/WebFetch, detects business type (SaaS, local, e-commerce, publisher, agency), and crawls up to 50 pages; runs 5 parallel subagents analyzing AI visibility (citability, crawler access, llms.txt, brand mentions), platform readiness (ChatGPT/Perplexity/Google AIO), technical SEO, content quality and E-E-A-T, and schema markup; computes a weighted composite score (citability 25%, brand authority 20%, content 20%, technical 15%, structured data 10%, platform 10%); emits Markdown reports or PDFs converted via pandoc plus headless Chrome; /geo prospect, /geo proposal, and /geo compare manage pipeline data under ~/.geo-prospects/; Python scripts under scripts/ handle fetching, scoring, brand scanning, llms.txt generation, and PDF report building.

Good fit
  • GEO/SEO agencies: run client audits and deliver branded PDF reports and auto-generated proposals
  • Marketing teams: track AI search visibility month over month with /geo quick or /geo compare
  • Content teams: check whether article passages are structured for AI citation via /geo citability (self-contained 134-167-word passages)
  • Local businesses: find out if AI crawlers are blocked in robots.txt and get LocalBusiness schema and Google Business Profile recommendations
  • SaaS companies: receive SoftwareApplication schema and comparison-page strategies to improve entity recognition across AI platforms
  • E-commerce operators: optimize product pages for AI shopping recommendations (Product schema, review aggregation)

How do you install this skill?

Before you use it
  • Static review only; no commands were executed. All capability conclusions come from source reading, with low confidence.
  • PDF reporting depends on a macOS-specific Chrome path plus pandoc; Windows/Linux users may not be able to use it directly, and an uncoordinated ReportLab alternative exists in the repo.
  • /geo update pulls updates from upstream — review upstream changes before use to avoid supply-chain risk.
  • CRM data is written to ~/.geo-prospects and is NOT removed by the uninstaller; delete manually if it contains prospect data.
  • Trigger words are overly broad (e.g. "optimize", any URL), risking false invocation; most market metrics are untraceable "industry data" — verify independently before citing.
  • Publisher is unverified and identity unknown; no version numbers or changelog, so upgrade behavior is unpredictable.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Claude Code CLI
  • Python 3.8+
  • Git
  • pandoc
  • Google Chrome (headless, for PDF export, macOS path shown)

One-command install (macOS/Linux): curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash. Or manually: git clone https://github.com/zubair-trabzada/geo-seo-claude.git && cd geo-seo-claude && ./install.sh. On Windows, run install-win.sh from Git Bash. Prerequisites: Python 3.8+ (plus python3-venv on Debian/Ubuntu), Claude Code CLI, Git; optionally uv and Playwright. Python dependencies are isolated in ~/.claude/skills/geo/.venv/. PDF export additionally requires pandoc (brew install pandoc) and Google Chrome.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/geo" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

After installing, open a Claude Code session and issue slash commands with a URL, e.g. /geo audit https://example.com for a full audit, /geo quick https://example.com for a 60-second snapshot, /geo crawlers https://example.com to check AI crawler access, or /geo llmstxt https://example.com to generate llms.txt. Trigger words like "geo", "seo", or "AI visibility" also work. Output files land in the current directory (GEO-AUDIT-REPORT.md, GEO-REPORT.pdf, etc.); the PDF flow is to run audit first, then /geo report-pdf.

What are this skill's strengths and limitations?

Pros
  • Unusually complete coverage: an end-to-end GEO workflow from citability scoring and crawler detection to llms.txt and schema generation
  • Parallel subagents with a weighted 0-100 scoring model make audits structured, reproducible, and comparable across months
  • Built for commercial delivery: charted PDF client reports, proposal generation, monthly delta reports, and a prospect pipeline in one package
  • Explicit operating discipline: 50-page cap, 30-second timeout, 1-second request delay, and always respects robots.txt
  • MIT-licensed with one-command install/uninstall and dependency isolation in a dedicated venv
Limitations
  • Deeply bound to Claude Code mechanisms (slash commands, subagent orchestration, allowed-tools); porting elsewhere requires rework
  • PDF export depends on pandoc and a local Chrome; the documented Chrome path is macOS-only (/Applications/Google Chrome.app) with no documented Linux/Windows equivalent
  • Market statistics ($850M market, +527% traffic growth) are third-party citations without verifiable primary research in the source
  • The README mentions no automated test suite, and the scoring methodology's exact algorithms cannot be verified from the source material
  • Brand mention scanning across 11+ platforms is subject to each platform's anti-scraping measures; success rates are not guaranteed

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
GEO-SEO AI Search Optimization Audit Skill this page 43 · Not recommended ★ 11k 20d ago MIT
GEO Full-Site Audit 48 · Use with care ★ 11k 20d ago MIT
SEO Content Audit Skill 48 · Use with care ★ 2.8k 7mo ago MIT
llms.txt Analysis & Generation Skill 46 · Use with care ★ 11k 20d ago MIT
GEO Platform Optimizer 44 · Not recommended ★ 11k 20d ago MIT

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Not recommended
43/ 100 5-point scale 2.2 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust12 / 25 · 2.4/5

The declared tool surface is broad (Read/Grep/Glob/Bash/WebFetch/Write) without least-privilege refinement, pre-run confirmation, or rollback guidance; data flows are mostly disclosed (writes to cwd and ~/.geo-prospects, with README noting uninstall preserves that directory), and quality gates like robots.txt respect and rate limiting are visible. However, /geo update pulls updates from upstream (supply-chain surface) and external effects of fetching arbitrary URLs are unconstrained. Deducted for: over-broad permissions, no confirmation mechanism, no rollback design.

2Reliability9 / 20 · 2.3/5

Instruction self-consistency has gaps: PDF generation requires pandoc + a macOS-only Chrome path in SKILL.md, while the repo tree also contains a ReportLab-based generate_pdf_report.py, with the two paths uncoordinated; sub-skill count is 14 in SKILL.md but 13 in README. Quality gates (50-page cap, timeouts, rate limiting) are sensibly designed. The repo includes a real test suite for fetch_page.py SSR heuristics (covering Issue #19), but it covers only the fetching step, not the audit/scoring/report key paths; failure feedback on abnormal input is not demonstrably explicit. Deducted for: contradictory paths, untested key paths.

3Adaptability7 / 15 · 2.3/5

Audience and scenarios are clear (six use cases), and business-type detection plus output-file mapping are concrete. But trigger conditions are overly broad ("optimize", "any URL" both trigger — false-invocation risk); PDF depends on a macOS-specific Chrome path, so cross-platform fit is incomplete; no Chinese-language support is declared; reachability depends on the user's network with no boundary disclosure. Deducted for: coarse trigger semantics, insufficient environment-boundary (platform/language) disclosure.

4Convention7 / 15 · 2.3/5

MIT license is explicit; directory structure, output files, and data storage location (~/.geo-prospects) are well documented; progressive disclosure (main SKILL.md → sub-skills → subagents) is architecturally clear. But there is no version number or changelog, the "February 2026" date and sub-skill counts are inconsistent, the maintenance/update path relies solely on the geo-update command without review process, and the description ends with Skool community marketing. Deducted for: missing version governance, inconsistent counts, marketing mixed into technical docs.

5Effectiveness5 / 15 · 1.7/5

The core task (GEO audit, citability scoring, llms.txt generation, report output) is described completely at the documentation level with clear output formats and a clear marginal-value proposition (agency deliverables). But all outputs are static claims with no sample reports or tested artifacts; the PDF path's pandoc/Chrome vs ReportLab contradiction may push debugging cost onto users; scoring is heuristic weighting whose correctness cannot be verified statically. Deducted for: no evidence of usable output, PDF inconsistency weakening direct usability.

6Verifiability3 / 10 · 1.5/5

The market-data table cites vague sources ("Industry data", "Industry analysts"), with only a few (Yahoo Finance/SparkToro/Gartner) named but no verifiable links; key capability claims (134–167-word optimal passages, 14+ AI crawlers, 11% dual-platform citation rate) lack primary material. The repo does contain a reproducible test suite for fetch_page — limited reproduction evidence but narrow coverage. Deducted for: untraceable marketing metrics, mismatch between test coverage and capability claims.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Sep 09, 2026 Reviewed revision 43c98eccc9bb Review evidence[1][2][3][4][5][6]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

What does it cost?
The tool itself is free and MIT-licensed. The author monetizes a paid Skool community (skool.com/aiworkshop) that teaches how to sell GEO services built on it.
Does it work outside Claude Code?
Not out of the box. Command routing and the 5 parallel subagents rely on Claude Code mechanisms; other Agent Skills-compatible clients would need the orchestration and triggers rewritten.
Will audits stress the target website?
Built-in limits apply: max 50 pages per audit, 30-second per-page timeout, 1-second delay between requests, max 5 concurrent requests, and robots.txt is always checked.
Where is my data stored, and does uninstall remove it?
Prospect, proposal, and monthly report data live under ~/.geo-prospects/ and are NOT removed by the uninstaller — delete manually. The skill files and Python venv are removed on uninstall.

More skills from this repository

All from zubair-trabzada/geo-seo-claude

Writing & Content

GEO Full-Site Audit

A GEO+SEO audit skill for Claude Code that scores any website's citability and visibility in AI engines like ChatGPT and Perplexity on a 0-100 scale, with a prioritized action plan.

★ 11k FS 48 Use with care 20d ago
Writing & Content

llms.txt Analysis & Generation Skill

Validates or generates llms.txt files so AI search engines can understand your site's structure and key facts at a glance.

★ 11k FS 46 Use with care 20d ago
Writing & Content

GEO Platform Optimizer

Audits and scores a website against five AI search platforms — Google AI Overviews, ChatGPT, Perplexity, Gemini, and Bing Copilot — with per-platform checklists and a consolidated optimization report.

★ 11k FS 44 Not recommended 20d ago
Writing & Content

GEO Crawlers Access Analysis Skill

Checks robots.txt, meta tags, and HTTP headers to determine which of 14 major AI crawlers can reach your site — then tells you exactly how to maximize AI search visibility.

★ 11k FS 51 Use with care 20d ago
Writing & Content

GEO Citability Scoring Skill

Scores any web page 0-100 for how likely ChatGPT, Perplexity, Claude or Gemini will cite it, then hands you sentence-level rewrite suggestions.

★ 11k FS 48 Use with care 20d ago
Writing & Content

GEO Client Report Generator (geo-report)

Consolidates multiple GEO audit results into one client-facing report with scores, findings, and a prioritized action plan — ready to deliver as-is.

★ 11k FS 48 Use with care 20d ago
Dev & Engineering

GEO Schema Structured Data Audit Skill

Detect, validate, and generate Schema.org structured data optimized for AI discoverability, with JSON-LD output and a scored report.

★ 11k FS 50 Use with care 20d ago
Writing & Content

GEO Content Quality & E-E-A-T Assessment

Scores web content on E-E-A-T and AI citability, producing a structured GEO-CONTENT-ANALYSIS.md report.

★ 11k FS 47 Use with care 20d ago
Writing & Content

GEO Brand Mentions Scanner

Scans brand presence across AI-cited platforms (YouTube, Reddit, Wikipedia, LinkedIn) and produces a 0-100 Brand Authority Score with platform-specific recommendations.

★ 11k FS 45 Not recommended 20d ago
Productivity & Collaboration

GEO Monthly Delta Report Generator

Compares two GEO audits, calculates score improvements and action-item completion, and produces a "here's your progress" retention report for agency clients.

★ 11k FS 46 Use with care 20d ago
Productivity & Collaboration

GEO Proposal Generator

Turns GEO audit data into a client-ready service proposal with tiered pricing, ROI projections, and a delivery timeline — automatically.

★ 11k FS 44 Not recommended 20d ago
Productivity & Collaboration

GEO PDF Report Generator

Turns a GEO audit markdown report into a client-ready PDF with a cover page, color-coded score tables, and a 90-day roadmap.

★ 11k FS 50 Use with care 20d ago
Writing & Content

GEO Technical SEO Audit Skill (geo-technical)

Runs a technical SEO audit on any website with AI-search focus: server-side rendering, AI crawler access, Core Web Vitals, and security headers.

★ 11k FS 54 Use with care 20d ago
Automation & Ops

GEO-SEO Skill Updater

One command syncs your locally installed GEO-SEO skills, agents, scripts and schema templates to the latest upstream release, with a change summary before and after.

★ 11k FS 46 Use with care 20d ago
Productivity & Collaboration

GEO Prospect Manager (geo-prospect)

A CRM-lite for GEO agencies: track prospects through the full sales pipeline inside Claude Code, from first contact to signed contract.

★ 11k FS 45 Not recommended 20d ago

Related skills