geo-content
zubair-trabzada/geo-seo-claude · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por zubair-trabzada/geo-seo-claude no skills.sh. Instale com: npx skills add zubair-trabzada/geo-seo-claude@geo-content
Details
- Kind
- Agent skills
- Topic
- Marketing & analytics
- Publisher
- zubair-trabzada
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 10,941
- Forks
- 1,661
- Open pull requests
- 1
- Last push
- 2026-10-05T21:00:14Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-10-06 04:44:52
- Updated
- 2026-10-06 04:44:52
- Origin id
zubair-trabzada/geo-seo-claude/geo-content
README
<p align="center">
<img src="https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/HEAD/assets/banner.svg" alt="GEO-SEO Claude Code Skill" width="900"/>
</p>
<p align="center">
<strong>GEO-first, SEO-supported.</strong> Optimize websites for AI-powered search engines<br/>
(ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.
</p>
<p align="center">
AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.
</p>
---
## Star History
<a href="https://www.star-history.com/?type=date&repos=zubair-trabzada%2Fgeo-seo-claude">
<picture>
<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" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&legend=top-left" />
</picture>
</a>
---
## Why GEO Matters (2026)
| Metric | Value |
|--------|-------|
| GEO services market | $850M+ (projected $7.3B by 2031) |
| AI-referred traffic growth | +527% year-over-year |
| AI traffic conversion rate vs organic | 4.4x higher |
| Gartner: search traffic drop by 2028 | -50% |
| Brand mentions vs backlinks for AI | 3x stronger correlation |
| Marketers investing in GEO | Only 23% |
---
## Quick Start
### One-Command Install (macOS/Linux)
```bash
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
```
### Manual Install
```bash
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.
```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`.
---
## Commands
Open Claude Code and use these commands:
| Command | What It Does |
|---------|-------------|
| `/geo audit <url>` | Full GEO + SEO audit with parallel subagents |
| `/geo quick <url>` | 60-second GEO visibility snapshot |
| `/geo citability <url>` | Score content for AI citation readiness |
| `/geo crawlers <url>` | Check AI crawler access (robots.txt) |
| `/geo llmstxt <url>` | Analyze or generate llms.txt |
| `/geo brands <url>` | Scan brand mentions across AI-cited platforms |
| `/geo platforms <url>` | Platform-specific optimization |
| `/geo schema <url>` | Structured data analysis & generation |
| `/geo technical <url>` | Technical SEO audit |
| `/geo content <url>` | Content quality & E-E-A-T assessment |
| `/geo report <url>` | Generate client-ready GEO report |
| `/geo report-pdf` | Generate professional PDF report with charts & visualizations |
---
## Architecture
```
geo-seo-claude/
├── geo/ # Main skill orchestrator
│ └── SKILL.md # Primary skill file with commands & routing
├── skills/ # 13 specialized sub-skills
│ ├── geo-audit/ # Full audit orchestration & scoring
│ ├── geo-citability/ # AI citation readiness scoring
│ ├── geo-crawlers/ # AI crawler access analysis
│ ├── geo-llmstxt/ # llms.txt standard analysis & generation
│ ├── geo-brand-mentions/ # Brand presence on AI-cited platforms
│ ├── geo-platform-optimizer/ # Platform-specific AI search optimization
│ ├── geo-schema/ # Structured data for AI discoverability
│ ├── geo-technical/ # Technical SEO foundations
│ ├── geo-content/ # Content quality & E-E-A-T
│ ├── geo-report/ # Client-ready markdown report generation
│ ├── geo-report-pdf/ # Professional PDF report with charts
│ ├── geo-prospect/ # CRM-lite prospect pipeline management
│ ├── geo-proposal/ # Auto-generate client proposals
│ └── geo-compare/ # Monthly delta tracking & progress reports
├── agents/ # 5 parallel subagents
│ ├── geo-ai-visibility.md # GEO audit, citability, crawlers, brands
│ ├── geo-platform-analysis.md # Platform-specific optimization
│ ├── geo-technical.md # Technical SEO analysis
│ ├── geo-content.md # Content & E-E-A-T analysis
│ └── geo-schema.md # Schema markup analysis
├── scripts/ # Python utilities
│ ├── fetch_page.py # Page fetching & parsing
│ ├── citability_scorer.py # AI citability scoring engine
│ ├── brand_scanner.py # Brand mention detection
│ ├── llmstxt_generator.py # llms.txt validation & generation
│ └── generate_pdf_report.py # PDF report generator (ReportLab)
├── schema/ # JSON-LD templates
│ ├── organization.json # Organization schema (with sameAs)
│ ├── local-business.json # LocalBusiness schema
│ ├── article-author.json # Article + Person schema (E-E-A-T)
│ ├── software-saas.json # SoftwareApplication schema
│ ├── product-ecommerce.json # Product schema with offers
│ └── website-searchaction.json # WebSite + SearchAction schema
├── install.sh # One-command installer
├── uninstall.sh # Uninstaller
├── requirements.txt # Python dependencies
└── README.md # This file
```
---
## Data Storage
The CRM and reporting skills (`/geo prospect`, `/geo proposal`, `/geo compare`) store runtime data outside the Claude Code directory:
```
~/.geo-prospects/
├── prospects.json # Client/prospect pipeline data
├── proposals/ # Generated proposal documents
│ └── <domain>-proposal-<date>.md
└── reports/ # Monthly delta reports
└── <domain>-monthly-<YYYY-MM>.md
```
This directory is **not removed** by the uninstaller — delete it manually if you no longer need your prospect data.
---
## How It Works
### Full Audit Flow
When you run `/geo audit https://example.com`:
1. **Discovery** — Fetches homepage, detects business type, crawls sitemap
2. **Parallel Analysis** — Launches 5 subagents simultaneously:
- AI Visibility (citability, crawlers, llms.txt, brand mentions)
- Platform Analysis (ChatGPT, Perplexity, Google AIO readiness)
- Technical SEO (Core Web Vitals, SSR, security, mobile)
- Content Quality (E-E-A-T, readability, freshness)
- Schema Markup (detection, validation, generation)
3. **Synthesis** — Aggregates scores, generates composite GEO Score (0-100)
4. **Report** — Outputs prioritized action plan with quick wins
### Scoring Methodology
| Category | Weight |
|----------|--------|
| AI Citability & Visibility | 25% |
| Brand Authority Signals | 20% |
| Content Quality & E-E-A-T | 20% |
| Technical Foundations | 15% |
| Structured Data | 10% |
| Platform Optimization | 10% |
---
## Key Features
### Citability Scoring
Analyzes content blocks for AI citation readiness. Optimal AI-cited passages are 134-167 words, self-contained, fact-rich, and directly answer questions.
### AI Crawler Analysis
Checks robots.txt for 14+ AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) and provides specific allow/block recommendations.
### Brand Mention Scanning
Brand mentions correlate 3x more strongly with AI visibility than backlinks. Scans YouTube, Reddit, Wikipedia, LinkedIn, and 7+ other platforms.
### Platform-Specific Optimization
Only 11% of domains are cited by both ChatGPT and Google AI Overviews for the same query. Provides tailored recommendations per platform.
### llms.txt Generation
Generates the emerging llms.txt standard file that helps AI crawlers understand your site structure.
### Client-Ready Reports
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.
---
## Use Cases
- **GEO Agencies** — Run client audits and generate deliverables
- **Marketing Teams** — Monitor and improve AI search visibility
- **Content Creators** — Optimize content for AI citations
- **Local Businesses** — Get found by AI assistants
- **SaaS Companies** — Improve entity recognition across AI platforms
- **E-commerce** — Optimize product pages for AI shopping recommendations
---
## Uninstall
```bash
./uninstall.sh
```
Or manually:
```bash
rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md
```
---
## Want to Turn This Into a Business?
The tool is free. Learning how to monetize it is where the community comes in.
**[Join the AI Workshop Community →](https://skool.com/aiworkshop)**
Inside you'll get:
- **Video walkthroughs** — Step-by-step setup, running audits, reading results
- **Client acquisition playbook** — How to find prospects, pitch GEO services, and close deals
- **Live office hours** — Bring your audit results, get direct help
- **GEO agency pricing & templates** — Proposal docs, cold outreach scripts, onboarding workflows
GEO agencies charge $2K–$12K/month. This tool does the audit. The community teaches you how to sell it.
---
## License
MIT License
---
## Contributing
Contributions welcome!
---
Built for the AI search era.