Skip to content
Back to search

geo-seo-claude

SkillWorks with Claude CodeGitHub

GEO-first SEO skill for Claude Code. Comprehensive AI search optimization for any website — citability scoring, AI crawler analysis, brand authority, schema markup, platform-specific optimization, and PDF reports. If you want learn how to sell this to real businesses, check out the skool community

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/zubair-trabzada/geo-seo-claude with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/zubair-trabzada/geo-seo-claude'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zubair-trabzada-geo-seo-claude/badge.svg)](/listings/zubair-trabzada-geo-seo-claude)

HTML

<a href="/listings/zubair-trabzada-geo-seo-claude"><img src="/api/listings/zubair-trabzada-geo-seo-claude/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

One-Command Install (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash

Manual Install

git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh

Windows (Git Bash)

Requires [Git for Windows](https://git-scm.com/downloads) which includes Git Bash.

# Option 1: One-command install (run from Git Bash, not PowerShell/CMD)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash

# Option 2: Manual install
git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install-win.sh

> **Note:** Right-click the folder and select "Open Git Bash here", or open Git Bash and navigate to the directory. Do not use PowerShell or Command Prompt.

Requirements

- Python 3.10+ (on Debian/Ubuntu also `python3-venv`) - Claude Code CLI - Git - Optional: [`uv`](https://docs.astral.sh/uv/) — if present, the installer uses it for a faster dependency install - Optional: Playwright (for screenshots)

Isolated install

Python dependencies are installed into a dedicated virtual environment at `~/.claude/skills/geo/.venv/`. Your system Python is **not** touched, and uninstalling the skill removes the venv together with the rest of the files.

Skill and agent files reference that venv directly, so the tool works regardless of what `python3` resolves to on your `PATH`.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 285 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/banner.svg" alt="GEO-SEO Claude Code Skill" width="900"/>
  3. </p>
  4. <p align="center">
  5. <strong>GEO-first, SEO-supported.</strong> Optimize websites for AI-powered search engines<br/>
  6. (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.
  7. </p>
  8. <p align="center">
  9. AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.
  10. </p>
  11. ---
  12. ## Star History
  13. <a href="https://www.star-history.com/?type=date&repos=zubair-trabzada%2Fgeo-seo-claude">
  14. <picture>
  15. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&theme=dark&legend=top-left" />
  16. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&legend=top-left" />
  17. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&legend=top-left" />
  18. </picture>
  19. </a>
  20. ---
  21. ## Why GEO Matters (2026)
  22. | Metric | Value |
  23. |--------|-------|
  24. | GEO services market | $850M+ (projected $7.3B by 2031) |
  25. | AI-referred traffic growth | +527% year-over-year |
  26. | AI traffic conversion rate vs organic | 4.4x higher |
  27. | Gartner: search traffic drop by 2028 | -50% |
  28. | Brand mentions vs backlinks for AI | 3x stronger correlation |
  29. | Marketers investing in GEO | Only 23% |
  30. ---
  31. ## Quick Start
  32. ### One-Command Install (macOS/Linux)
  33. ```bash
  34. curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 46 on GitHub
  35. ```
  36. ### Manual Install
  37. ```bash
  38. git clone https://github.com/zubair-trabzada/geo-seo-claude.git
  39. cd geo-seo-claude
  40. ./install.sh
  41. ```
  42. ### Windows (Git Bash)
  43. Requires [Git for Windows](https://git-scm.com/downloads) which includes Git Bash.
  44. ```bash
  45. # Option 1: One-command install (run from Git Bash, not PowerShell/CMD)
  46. curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 63 on GitHub
  47. # Option 2: Manual install
  48. git clone https://github.com/zubair-trabzada/geo-seo-claude.git
  49. cd geo-seo-claude
  50. ./install-win.sh
  51. ```
  52. > **Note:** Right-click the folder and select "Open Git Bash here", or open Git Bash and navigate to the directory. Do not use PowerShell or Command Prompt.
  53. ### Requirements
  54. - Python 3.10+ (on Debian/Ubuntu also `python3-venv`)
  55. - Claude Code CLI
  56. - Git
  57. - Optional: [`uv`](https://docs.astral.sh/uv/) — if present, the installer uses it for a faster dependency install
  58. - Optional: Playwright (for screenshots)
  59. ### Isolated install
  60. Python dependencies are installed into a dedicated virtual environment at
  61. `~/.claude/skills/geo/.venv/`. Your system Python is **not** touched, and
  62. uninstalling the skill removes the venv together with the rest of the files.
  63. Skill and agent files reference that venv directly, so the tool works
  64. regardless of what `python3` resolves to on your `PATH`.
  65. ---
  66. ## Commands
  67. Open Claude Code and use these commands:
  68. | Command | What It Does |
  69. |---------|-------------|
  70. | `/geo audit <url>` | Full GEO + SEO audit with parallel subagents |
  71. | `/geo quick <url>` | 60-second GEO visibility snapshot |
  72. | `/geo citability <url>` | Score content for AI citation readiness |
  73. | `/geo crawlers <url>` | Check AI crawler access (robots.txt) |
  74. | `/geo llmstxt <url>` | Analyze or generate llms.txt |
  75. | `/geo brands <url>` | Scan brand mentions across AI-cited platforms |
  76. | `/geo platforms <url>` | Platform-specific optimization |
  77. | `/geo schema <url>` | Structured data analysis & generation |
  78. | `/geo technical <url>` | Technical SEO audit |
  79. | `/geo content <url>` | Content quality & E-E-A-T assessment |
  80. | `/geo report <url>` | Generate client-ready GEO report |
  81. | `/geo report-pdf` | Generate professional PDF report with charts & visualizations |
  82. ---
  83. ## Architecture
  84. ```
  85. geo-seo-claude/
  86. ├── geo/ # Main skill orchestrator
  87. │ └── SKILL.md # Primary skill file with commands & routing
  88. ├── skills/ # 13 specialized sub-skills
  89. │ ├── geo-audit/ # Full audit orchestration & scoring
  90. │ ├── geo-citability/ # AI citation readiness scoring
  91. │ ├── geo-crawlers/ # AI crawler access analysis
  92. │ ├── geo-llmstxt/ # llms.txt standard analysis & generation
  93. │ ├── geo-brand-mentions/ # Brand presence on AI-cited platforms
  94. │ ├── geo-platform-optimizer/ # Platform-specific AI search optimization
  95. │ ├── geo-schema/ # Structured data for AI discoverability
  96. │ ├── geo-technical/ # Technical SEO foundations
  97. │ ├── geo-content/ # Content quality & E-E-A-T
  98. │ ├── geo-report/ # Client-ready markdown report generation
  99. │ ├── geo-report-pdf/ # Professional PDF report with charts
  100. │ ├── geo-prospect/ # CRM-lite prospect pipeline management
  101. │ ├── geo-proposal/ # Auto-generate client proposals
  102. │ └── geo-compare/ # Monthly delta tracking & progress reports
  103. ├── agents/ # 5 parallel subagents
  104. │ ├── geo-ai-visibility.md # GEO audit, citability, crawlers, brands
  105. │ ├── geo-platform-analysis.md # Platform-specific optimization
  106. │ ├── geo-technical.md # Technical SEO analysis
  107. │ ├── geo-content.md # Content & E-E-A-T analysis
  108. │ └── geo-schema.md # Schema markup analysis
  109. ├── scripts/ # Python utilities
  110. │ ├── fetch_page.py # Page fetching & parsing
  111. │ ├── citability_scorer.py # AI citability scoring engine
  112. │ ├── brand_scanner.py # Brand mention detection
  113. │ ├── llmstxt_generator.py # llms.txt validation & generation
  114. │ └── generate_pdf_report.py # PDF report generator (ReportLab)
  115. ├── schema/ # JSON-LD templates
  116. │ ├── organization.json # Organization schema (with sameAs)
  117. │ ├── local-business.json # LocalBusiness schema
  118. │ ├── article-author.json # Article + Person schema (E-E-A-T)
  119. │ ├── software-saas.json # SoftwareApplication schema
  120. │ ├── product-ecommerce.json # Product schema with offers
  121. │ └── website-searchaction.json # WebSite + SearchAction schema
  122. ├── install.sh # One-command installer
  123. ├── uninstall.sh # Uninstaller
  124. ├── requirements.txt # Python dependencies
  125. └── README.md # This file
  126. ```
  127. ---
  128. ## Data Storage
  129. The CRM and reporting skills (`/geo prospect`, `/geo proposal`, `/geo compare`) store runtime data outside the Claude Code directory:
  130. ```
  131. ~/.geo-prospects/
  132. ├── prospects.json # Client/prospect pipeline data
  133. ├── proposals/ # Generated proposal documents
  134. │ └── <domain>-proposal-<date>.md
  135. └── reports/ # Monthly delta reports
  136. └── <domain>-monthly-<YYYY-MM>.md
  137. ```
  138. This directory is **not removed** by the uninstaller — delete it manually if you no longer need your prospect data.
  139. ---
  140. ## How It Works
  141. ### Full Audit Flow
  142. When you run `/geo audit https://example.com`:
  143. 1. **Discovery** — Fetches homepage, detects business type, crawls sitemap
  144. 2. **Parallel Analysis** — Launches 5 subagents simultaneously:
  145. - AI Visibility (citability, crawlers, llms.txt, brand mentions)
  146. - Platform Analysis (ChatGPT, Perplexity, Google AIO readiness)
  147. - Technical SEO (Core Web Vitals, SSR, security, mobile)
  148. - Content Quality (E-E-A-T, readability, freshness)
  149. - Schema Markup (detection, validation, generation)
  150. 3. **Synthesis** — Aggregates scores, generates composite GEO Score (0-100)
  151. 4. **Report** — Outputs prioritized action plan with quick wins
  152. ### Scoring Methodology
  153. | Category | Weight |
  154. |----------|--------|
  155. | AI Citability & Visibility | 25% |
  156. | Brand Authority Signals | 20% |
  157. | Content Quality & E-E-A-T | 20% |
  158. | Technical Foundations | 15% |
  159. | Structured Data | 10% |
  160. | Platform Optimization | 10% |
  161. ---
  162. ## Key Features
  163. ### Citability Scoring
  164. Analyzes content blocks for AI citation readiness. Optimal AI-cited passages are 134-167 words, self-contained, fact-rich, and directly answer questions.
  165. ### AI Crawler Analysis
  166. Checks robots.txt for 14+ AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) and provides specific allow/block recommendations.
  167. ### Brand Mention Scanning
  168. Brand mentions correlate 3x more strongly with AI visibility than backlinks. Scans YouTube, Reddit, Wikipedia, LinkedIn, and 7+ other platforms.
  169. ### Platform-Specific Optimization
  170. Only 11% of domains are cited by both ChatGPT and Google AI Overviews for the same query. Provides tailored recommendations per platform.
  171. ### llms.txt Generation
  172. Generates the emerging llms.txt standard file that helps AI crawlers understand your site structure.
  173. ### Client-Ready Reports
  174. Generates professional GEO reports in markdown or PDF format. PDF reports include score gauges, bar charts, platform readiness visualizations, color-coded tables, and prioritized action plans — ready to deliver to clients.
  175. ---
  176. ## Use Cases
  177. - **GEO Agencies** — Run client audits and generate deliverables
  178. - **Marketing Teams** — Monitor and improve AI search visibility
  179. - **Content Creators** — Optimize content for AI citations
  180. - **Local Businesses** — Get found by AI assistants
  181. - **SaaS Companies** — Improve entity recognition across AI platforms
  182. - **E-commerce** — Optimize product pages for AI shopping recommendations
  183. ---
  184. ## Uninstall
  185. ```bash
  186. ./uninstall.sh
  187. ```
  188. Or manually:
  189. ```bash
  190. rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md
  191. ```
  192. ---
  193. ## Want to Turn This Into a Business?
  194. The tool is free. Learning how to monetize it is where the community comes in.
  195. **[Join the AI Workshop Community →](https://skool.com/aiworkshop)**
  196. Inside you'll get:
  197. - **Video walkthroughs** — Step-by-step setup, running audits, reading results
  198. - **Client acquisition playbook** — How to find prospects, pitch GEO services, and close deals
  199. - **Live office hours** — Bring your audit results, get direct help
  200. - **GEO agency pricing & templates** — Proposal docs, cold outreach scripts, onboarding workflows
  201. GEO agencies charge $2K–$12K/month. This tool does the audit. The community teaches you how to sell it.
  202. ---
  203. ## License
  204. MIT License
  205. ---
  206. ## Contributing
  207. Contributions welcome!
  208. ---
  209. Built for the AI search era.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.