### Setup and run scripts (fetch_page, citability_scorer, brand_scanner, llmstxt_generator, crm_dashboard, webapp)

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/CLAUDE.md

Setup commands and script invocations for the geo-seo-claude repository. Scripts print JSON to stdout for skills/agents to parse; requires Python with requirements.txt installed (beautifulsoup4, requests, lxml, playwright, Pillow, flask, rich, validators).

```bash
python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt
python3 -m playwright install chromium   # fetch_page.py uses Playwright for SSR/JS checks

python3 scripts/fetch_page.py <url>
python3 scripts/citability_scorer.py <url>
python3 scripts/brand_scanner.py "<brand name>"
python3 scripts/llmstxt_generator.py <url>
python3 scripts/crm_dashboard.py          # rich CLI over ~/.geo-prospects
python3 scripts/webapp/app.py             # CRM web UI at http://localhost:5050
```

--------------------------------

### Example brand.json configuration

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/white-label/README.md

Example configuration file. Copy brand.example.json to brand.json and edit. Omitted fields keep defaults; colors are merged key-by-key. Keys starting with underscore are ignored.

```json
{
  "name": "Your Agency Inc.",
  "website": "youragency.com",
  "phone": "555-123-4567",
  "contact_name": "Your Name",
  "colors": {
    "primary": "#19C3B2",
    "text_accent": "#19C3B2"
  }
}
```

--------------------------------

### Manual install for macOS/Linux

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Manual installation for macOS and Linux. Clones the repository, changes into the directory, and runs the install script.

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

--------------------------------

### Verify skill with /geo quick command

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Run this command in Claude Code to verify the skill is installed. A successful run starts a 60-second GEO visibility snapshot; otherwise, restart Claude Code.

```text
/geo quick https://example.com
```

--------------------------------

### One-liner install for macOS/Linux

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

One-liner installer for macOS and Linux. Downloads and runs the install script directly from the repository.

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

--------------------------------

### Install on Windows via Git Bash

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Installation for Windows using Git Bash. PowerShell and Command Prompt are not supported. Provides both one-liner and manual methods.

```bash
# One-liner (run from Git Bash)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash

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

--------------------------------

### Recommended JSON-LD Template Example (Schema Type 2)

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/agents/geo-schema.md

Second example JSON-LD template for a recommended schema type, with placeholder values.

```json
{
  [Complete template]
}
```

--------------------------------

### GEO Proposal Command Examples

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-proposal/SKILL.md

Example invocations of the /geo proposal command with different arguments.

```bash
/geo proposal electron-srl.com
```

```bash
/geo proposal electron-srl.com --tier standard --client-name "Electron Srl"
```

```bash
/geo proposal ~/.geo-prospects/audits/electron-srl.com-2026-03-12.md
```

--------------------------------

### Install Python dependencies manually

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Run this from the cloned repo or the skill directory if the installer reports failed Python dependencies.

```bash
python3 -m pip install --user -r requirements.txt
```

--------------------------------

### Recommended JSON-LD Template Example (Schema Type 1)

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/agents/geo-schema.md

Example JSON-LD template for a recommended schema type, with placeholder values. Implementation note: add to <head> inside a <script type="application/ld+json"> tag.

```json
{
  "@context": "https://schema.org",
  "@type": "[Type]",
  [Complete template with placeholder values]
}
```

--------------------------------

### GEO Audit Commands - Quick Start

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/geo/SKILL.md

Run a full GEO audit, check crawler visibility, score citability, generate llms.txt, get a quick snapshot, or create a report using the /geo commands. Each command targets a specific function and takes a website URL as an argument.

```bash
# Full GEO audit of a website
/geo audit https://example.com

# Check if AI bots can see your site
/geo crawlers https://example.com

# Score a specific page for AI citability
/geo citability https://example.com/blog/best-article

# Generate an llms.txt file for your site
/geo llmstxt https://example.com

# Get a 60-second visibility snapshot
/geo quick https://example.com

# Generate a client-ready report
/geo report https://example.com
```

--------------------------------

### Install Playwright chromium manually

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Use this command if Playwright was skipped during install, causing screenshot steps to fail.

```bash
python3 -m playwright install chromium
```

--------------------------------

### Prospect JSON Record Example

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-prospect/SKILL.md

Example JSON record for a single prospect, showing all fields including id, company, domain, contact info, status, geo_score, audit details, and notes.

```json
{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "info@electron-srl.com",
  "contact_name": "",
  "industry": "Educational Equipment Manufacturing",
  "country": "Italy",
  "status": "qualified",
  "geo_score": 32,
  "audit_date": "2026-03-12",
  "audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
  "proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
  "monthly_value": 0,
  "contract_start": null,
  "contract_months": 0,
  "notes": [
    {
      "date": "2026-03-12",
      "text": "Initial GEO quick scan. Score 32/100 - Critical tier. Strong candidate for GEO services."
    }
  ],
  "created_at": "2026-03-12",
  "updated_at": "2026-03-12"
}
```

--------------------------------

### Install Claude Code CLI

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Install the Claude Code CLI globally via npm. Required before the geo-seo-claude skills and agents can be loaded and invoked.

```bash
npm install -g @anthropic-ai/claude-code
```

--------------------------------

### GEO compare command examples

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-compare/SKILL.md

Shows the command syntax for comparing GEO audits, including domain-only and file-based comparisons with optional month flag.

```bash
/geo compare <domain>
/geo compare <baseline-file> <current-file>
/geo compare electron-srl.com --month march-2026
```

```bash
/geo compare electron-srl.com
/geo compare ~/.geo-prospects/audits/electron-srl.com-2026-01-15.md ~/.geo-prospects/audits/electron-srl.com-2026-03-12.md
```

--------------------------------

### Run tests with pytest (all tests and single test)

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/CLAUDE.md

Run the pytest-based test suite. Tests are pytest-style classes (using unittest.mock, no network); unittest discover does not collect them, so pytest is required (pip install pytest).

```bash
python3 -m pytest tests/                                        # all tests
python3 -m pytest tests/test_fetch_page_ssr.py -k ssr_content   # a single test
```

--------------------------------

### Pipeline Summary Output

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-prospect/SKILL.md

Example output of the /geo prospect pipeline command, showing a revenue-focused summary with stages, counts, potential values, and next actions.

```text
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GEO AGENCY PIPELINE SUMMARY — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STAGE          COUNT   POTENTIAL VALUE   NOTES
─────────────  ─────   ───────────────   ─────────────────────
Lead             2      €8,000/mo        New discoveries
Qualified        1      €4,500/mo        Ready for proposal
Proposal Sent    1      €6,000/mo        Awaiting signature
Won              3      €18,500/mo       Active clients (MRR)
Lost             1      —                Budget freeze

COMMITTED MRR:        €18,500
PIPELINE (qualified+): €10,500
TOTAL POTENTIAL:      €29,000/mo → €348,000/yr

Next actions:
→ PRO-003 (acme.com): Send proposal — score 38/100 (strong case)
→ PRO-007 (shop.it): Follow up — proposal sent 8 days ago
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

--------------------------------

### Prospect List Summary Table Output

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-prospect/SKILL.md

Example output of the /geo prospect list command, showing a summary table of prospects with columns for ID, domain, company, status, score, and value.

```text
GEO Prospect Pipeline — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ID       Domain                  Company           Status      Score  Value
───────  ──────────────────────  ────────────────  ──────────  ─────  ──────
PRO-001  electron-srl.com        Electron Srl      Qualified   32/100  €4.5K
PRO-002  acme.com                ACME Corp         Lead        —       —
PRO-003  bigshop.it              BigShop           Won         41/100  €6.0K

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pipeline: 1 lead | 1 qualified | 0 proposals | 1 won | 0 lost
Committed MRR: €6,000 | Pipeline Value: €4,500
```

--------------------------------

### Run quick GEO audit

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Starts a 60-second GEO visibility snapshot, returning a high-level score and top issues.

```text
/geo quick https://yoursite.com
```

--------------------------------

### Usage of /geo compare command

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Examples of how to invoke the /geo compare command using a domain or explicit file paths, with an optional month flag.

```bash
/geo compare <domain>
/geo compare <baseline-file> <current-file>
/geo compare <domain> --month march-2026
```

--------------------------------

### Load brand configuration with load_brand()

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/white-label/README.md

Import and call load_brand() to get a merged brand dictionary. Pass a path to brand.json or call with no arguments for defaults. Access fields like name, colors.primary, and contact_name.

```python
from brand_config import load_brand

brand = load_brand("brand.json")        # or load_brand() for defaults

agency   = brand["name"]                 # "Your Agency Inc."
primary  = brand["colors"]["primary"]    # "#19C3B2"
contact  = brand["contact_name"]
```

--------------------------------

### Run Chrome headless to print GEO-REPORT.pdf

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-report-pdf/SKILL.md

Uses headless Chrome to print the generated HTML to a PDF. Increase --virtual-time-budget to 8000 if the PDF is blank or empty. The path assumes Chrome is installed at the default location.

```bash
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless=new \
  --disable-gpu \
  --no-sandbox \
  --print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
  --print-to-pdf-no-header \
  --no-pdf-header-footer \
  --virtual-time-budget=5000 \
  "file://$(pwd)/GEO-REPORT.html"
```

--------------------------------

### Update Python Dependencies

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-update/SKILL.md

Installs Python dependencies from the requirements.txt file found in the upstream repository.

```bash
python3 -m pip install -r "$SOURCE_DIR/requirements.txt" --quiet
```

--------------------------------

### llms.txt Title Requirement

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-llmstxt/SKILL.md

The file must start with the official site name as an H1 heading.

```markdown
# Site Name
```

--------------------------------

### Low-citability example passage

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-citability/SKILL.md

Example of a passage that scores low on citability: narrative, lacks topic identification, and has no facts or definition pattern. Word count: 52. Facts: 0. Definition pattern: No.

```text
If you've ever wondered why some websites load faster than others, the answer might
surprise you. There's this amazing technology that has been around for a while now.
It's changed the way we think about web performance. Let me explain how it works and
why you should care about it for your business.
```

--------------------------------

### High-citability example passage

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-citability/SKILL.md

Example of a passage that scores high on citability: self-contained, fact-rich, and uses a definition pattern. Word count: 58. Facts: 3 specific data points. Definition pattern: Yes.

```text
Content delivery networks (CDNs) are distributed server systems that cache and serve
web content from locations geographically close to end users. A CDN reduces latency
by 50-70% on average by serving assets from edge servers rather than a single origin
server. The three largest CDN providers as of 2025 are Cloudflare (serving approximately
20% of all websites), Amazon CloudFront, and Akamai Technologies.
```

--------------------------------

### GEO Monthly Progress Report Markdown Template

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-compare/SKILL.md

A complete markdown template for a GEO monthly progress report. It includes placeholders for company name, dates, scores, tables for breakdowns, and action plans. Use this as a starting point for generating client reports.

```markdown
# GEO Monthly Progress Report
## [COMPANY NAME] — [MONTH YEAR]

**Reporting period:** [BASELINE DATE] → [CURRENT DATE]
**Prepared by:** [AGENCY NAME]
**Report reference:** GEO-MONTHLY-[DOMAIN]-[YYMMDD]

---

## Executive Summary

[2-3 sentences: What improved, what's the trend, what to focus on next month.]

Example: "Electron Srl's GEO Score improved from 32 to 44 this month (+12 points),
placing the site firmly in the 'Below Average' tier and on track to reach 'Moderate'
by May. The biggest wins were AI crawler access (+3 crawlers now allowed) and schema
implementation (+Organization and LocalBusiness schemas live). Next month's focus is
content citability — the highest-weighted remaining gap."

---

## GEO Score Progress

```
OVERALL GEO SCORE

  Baseline   [▓▓▓▓░░░░░░░░░░░░░░░░]  32/100  (Critical)
  Current    [▓▓▓▓▓▓▓▓░░░░░░░░░░░░]  44/100  (Below Average)
  Change     ▲ +12 points (+37.5%)

  Target:    65/100 by Month 6 (on track ✓)
```

---

## Score Breakdown: Before vs. After

| Category | Baseline | Current | Change | Trend |
|----------|---------|---------|--------|-------|
| AI Citability & Visibility | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Brand Authority Signals | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Content Quality & E-E-A-T | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Technical Foundations | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Structured Data | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Platform Optimization | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| **TOTAL** | **[X]/100** | **[X]/100** | **[+/-X]** | **[▲/▼]** |

---

## Platform Readiness: Before vs. After

| AI Platform | Baseline | Current | Change |
|-------------|---------|---------|--------|
| Google AI Overviews | [X]/100 | [X]/100 | [+/-X] |
| ChatGPT Web Search | [X]/100 | [X]/100 | [+/-X] |
| Perplexity AI | [X]/100 | [X]/100 | [+/-X] |
| Google Gemini | [X]/100 | [X]/100 | [+/-X] |
| Bing Copilot | [X]/100 | [X]/100 | [+/-X] |

---

## AI Crawler Access Changes

| Crawler | Baseline | Current | Change |
|---------|---------|---------|--------|
| GPTBot (ChatGPT) | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| ClaudeBot (Anthropic) | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| PerplexityBot | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| Google-Extended (Gemini) | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| Bingbot | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |

[Show only crawlers that changed, or all if few crawlers.]

---

## Action Plan Progress

### Quick Wins — Status Update

| # | Action | Assigned | Status | Impact |
|---|--------|---------|--------|--------|
| 1 | Allow all AI crawlers in robots.txt | Client dev | ✅ Done | +3 crawlers |
| 2 | Add Organization schema to homepage | Client dev | ✅ Done | Schema score +15 |
| 3 | Create llms.txt | Agency | ✅ Done | AI visibility +8 |
| 4 | Add author bylines to all articles | Client content | 🔄 In Progress | — |
| 5 | Fix meta descriptions (47 pages missing) | Client dev | ❌ Not started | — |

**Quick wins completed: [X]/[Y] ([%])**

### Medium-Term — Status Update

| # | Action | Target Month | Status |
|---|--------|-------------|--------|
| 1 | Rewrite top 10 pages with Q&A structure | Month 2 | 🔄 3/10 done |
| 2 | E-E-A-T: Create author pages | Month 2 | ❌ Not started |
| 3 | Register Bing Webmaster Tools | Month 1 | ✅ Done |
| 4 | Implement IndexNow | Month 2 | 🔄 In Progress |

### Strategic — Status Update

| # | Action | Target | Status |
|---|--------|--------|--------|
| 1 | Wikipedia entity creation | Month 4 | 📋 Planned |
| 2 | YouTube channel launch | Month 3 | 📋 Planned |
| 3 | Reddit presence (industry subs) | Month 3 | 📋 Planned |

---

## This Month's Wins

> Use this section to celebrate — clients need to see the value clearly.

✅ **[WIN 1]:** [Specific, tangible result — e.g., "GPTBot and ClaudeBot are now allowed. ChatGPT can now crawl and cite your content."]
✅ **[WIN 2]:** [e.g., "Organization schema implemented on homepage. Your brand entity is now machine-readable."]
✅ **[WIN 3]:** [e.g., "llms.txt created and deployed at electron-srl.com/llms.txt — one of only ~12% of sites in your industry to have this."]

---

## New Issues Discovered

> Issues found in current audit that weren't in baseline.

⚠️ **[ISSUE 1]:** [What it is, what it means, how we'll fix it]
⚠️ **[ISSUE 2]:** [What it is, what it means, how we'll fix it]

---

## Next Month Focus

### Priority Actions for [NEXT MONTH]:

| Priority | Action | Owner | Expected Impact |
|----------|--------|-------|----------------|
| 1 | [Highest ROI action] | [Agency/Client] | +[X] GEO points |
| 2 | [Second priority] | [Agency/Client] | +[X] GEO points |
| 3 | [Third priority] | [Agency/Client] | +[X] GEO points |

**Target GEO Score next month:** [CURRENT + estimated gain]/100

---

## 6-Month Trajectory

```

--------------------------------

### GEO-BRAND-MENTIONS.md Template

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-brand-mentions/SKILL.md

Markdown template for a brand authority report. Includes placeholders for scores, platform details, recommendations, and competitive context. Use as a starting point for generating the report.

```markdown
# Brand Authority Report: [Brand Name]

**Analysis Date:** [Date]
**Brand:** [Brand Name]
**Domain:** [URL]
**Industry:** [Industry]

---

## Brand Authority Score: [X]/100 ([Rating])

### Platform Breakdown

| Platform | Score | Weight | Weighted | Status |
|---|---|---|---|---|
| YouTube | [X]/100 | 25% | [X] | [Active Channel / Mentioned / Absent] |
| Reddit | [X]/100 | 25% | [X] | [Active / Discussed / Absent] |
| Wikipedia | [X]/100 | 20% | [X] | [Article / Mentioned / Absent] |
| LinkedIn | [X]/100 | 15% | [X] | [Active / Basic / Absent] |
| Other Platforms | [X]/100 | 15% | [X] | [Summary] |
| **Total** | | | **[X]/100** | |

---

## Platform Detail

### YouTube ([X]/100)

**Official Channel:** [Yes/No] | [URL if exists]
**Subscribers:** [Count or N/A]
**Videos:** [Count or N/A]
**Last Upload:** [Date or N/A]
**Third-Party Mentions:** [Estimated count]
**Key Findings:**
- [Finding 1]
- [Finding 2]

### Reddit ([X]/100)

**Official Account:** [Yes/No] | [URL if exists]
**Own Subreddit:** [Yes/No] | [URL and member count if exists]
**Mention Volume:** [Estimated thread count]
**Primary Subreddits:** [List of subreddits where brand is discussed]
**Sentiment:** [Positive/Negative/Neutral/Mixed]
**Key Findings:**
- [Finding 1]
- [Finding 2]

### Wikipedia ([X]/100)

**Company Article:** [Yes/No] | [URL if exists]
**Founder Article:** [Yes/No] | [URL if exists]
**Wikidata Entry:** [Yes/No] | [Q-number if exists]
**Cited in Other Articles:** [Yes/No] | [Which articles]
**Key Findings:**
- [Finding 1]
- [Finding 2]

### LinkedIn ([X]/100)

**Company Page:** [Yes/No] | [URL if exists]
**Followers:** [Count or N/A]
**Post Frequency:** [Weekly/Monthly/Rare/Never]
**Key Findings:**
- [Finding 1]
- [Finding 2]

### Other Platforms ([X]/100)

| Platform | Presence | Notes |
|---|---|---|
| Quora | [Yes/No] | [Brief note] |
| Stack Overflow | [Yes/No] | [Brief note] |
| GitHub | [Yes/No] | [Brief note] |
| Hacker News | [Yes/No] | [Brief note] |
| News/Press | [Yes/No] | [Brief note] |
| Podcasts | [Yes/No] | [Brief note] |

---

## Recommendations

### Immediate Actions (Week 1-2)

1. **[Platform]:** [Specific action to take with expected impact]
2. **[Platform]:** [Specific action]

### Short-Term Strategy (Month 1-3)

1. **[Platform]:** [Strategy with tactics]
2. **[Platform]:** [Strategy with tactics]

### Long-Term Authority Building (Month 3-12)

1. **[Platform]:** [Long-term strategy]
2. **[Platform]:** [Long-term strategy]

---

## Competitive Context

[If competitors were analyzed, show a brief comparison table]

| Brand | YouTube | Reddit | Wikipedia | LinkedIn | Other | Total |
|---|---|---|---|---|---|---|
| [Subject Brand] | [X] | [X] | [X] | [X] | [X] | **[X]** |
| [Competitor 1] | [X] | [X] | [X] | [X] | [X] | **[X]** |
| [Competitor 2] | [X] | [X] | [X] | [X] | [X] | **[X]** |

## Key Takeaway

[1-2 sentence summary of the brand's AI visibility standing and the single most impactful action to take]
```

--------------------------------

### GEO Technical SEO Audit Markdown Template

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-technical/SKILL.md

Template for generating GEO-TECHNICAL-AUDIT.md. Includes score breakdown table, AI crawler access table, critical issues, warnings, recommendations, and agent-readiness signals sections. Use as a starting point for the audit report.

```markdown
# GEO Technical SEO Audit — [Domain]
Date: [Date]

## Technical Score: XX/100

## Score Breakdown
| Category | Score | Status |
|---|---|---|
| Crawlability | XX/15 | Pass/Warn/Fail |
| Indexability | XX/12 | Pass/Warn/Fail |
| Security | XX/10 | Pass/Warn/Fail |
| URL Structure | XX/8 | Pass/Warn/Fail |
| Mobile Optimization | XX/10 | Pass/Warn/Fail |
| Core Web Vitals | XX/15 | Pass/Warn/Fail |
| Server-Side Rendering | XX/15 | Pass/Warn/Fail |
| Page Speed & Server | XX/15 | Pass/Warn/Fail |

Status: Pass = 80%+ of category points, Warn = 50-79%, Fail = <50%

## AI Crawler Access
| Crawler | User-Agent | Status | Recommendation |
|---|---|---|---|
| GPTBot | GPTBot | Allowed/Blocked | [Action] |
| Googlebot | Googlebot | Allowed/Blocked | [Action] |
[Continue for all AI crawlers]

## Critical Issues (fix immediately)
[List with specific page URLs and what is wrong]

## Warnings (fix this month)
[List with details]

## Recommendations (optimize this quarter)
[List with details]

## Agent-Readiness Signals (non-scoring)

### RFC 8288 Link Headers (Service Discovery)

**Status:** Present / Absent / Not Applicable

<!-- If present: -->
| Relation Type | URL | Meaning |
|---|---|---|
| api-catalog | /.well-known/api-catalog | Machine-readable index of available APIs |
| mcp-server-card | /.well-known/mcp.json | MCP server capability declaration |

AI agents and API clients can discover your services without parsing HTML.

<!-- If absent, API-first site only: -->
**Informational Recommendation:** This site has API/developer-oriented content but no `Link:` headers advertising discoverable services.

Example: `Link: </.well-known/api-catalog>; rel="api-catalog"`

Relevant for: sites with public APIs, OpenAPI docs, or MCP server integrations.
Reference: RFC 8288, RFC 9609.

<!-- If absent, standard business site: omit this section entirely -->

### Markdown Content Negotiation

**Status:** Supported / Not Supported
**Test:** GET [url] with `Accept: text/markdown`
**Response Content-Type:** [value]

<!-- If supported: -->
This site serves clean Markdown to AI agents on request. AI crawlers that support content negotiation receive formatted text without HTML boilerplate.

<!-- If not supported: -->
**Forward-Looking Recommendation:** Cloudflare Workers/Pages sites can enable Markdown content negotiation with a one-line configuration change. When an AI agent sends `Accept: text/markdown`, the server responds with clean Markdown instead of HTML.

- Currently Cloudflare-specific
- Relevant for: sites already on Cloudflare infrastructure
- Other CDNs and frameworks expected to adopt this pattern as AI agent traffic grows

## Detailed Findings
[Per-category breakdown with evidence]
```

--------------------------------

### Analyze or generate llms.txt: /geo llmstxt https://example.com

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Runs the /geo llmstxt command against a domain root URL. It fetches existing llms.txt and llms-full.txt files; if none exist, it generates a new one by crawling the sitemap and homepage. Output is either GEO-LLMSTXT-ANALYSIS.md (analysis mode) or a ready-to-deploy llms.txt and GEO-LLMSTXT-GENERATION.md (generation mode).

```bash
/geo llmstxt https://example.com
```

--------------------------------

### Run brand_config.py to print merged brand dict

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/white-label/README.md

Command-line invocation to test the configuration. Prints the merged brand dictionary.

```bash
python brand_config.py brand.json    # prints the merged brand dict
```

--------------------------------

### Create geo-prospects directories

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-prospect/SKILL.md

Command to create the audits and proposals directories if they do not exist.

```bash
mkdir -p ~/.geo-prospects/audits ~/.geo-prospects/proposals
```

--------------------------------

### Check skill and agent files with ls

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Use these commands to confirm the skill and agent files are in the expected directories.

```bash
ls ~/.claude/skills/geo/
ls ~/.claude/skills/ | grep geo
ls ~/.claude/agents/ | grep geo
```

--------------------------------

### Apply Updates to Components

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-update/SKILL.md

Copies files from the cloned repository to the local ~/.claude directory, including main skills, sub-skills, agents, scripts, schema templates, and hooks.

```bash
CLAUDE_DIR="${HOME}/.claude"
SOURCE_DIR="$TEMP_DIR/repo"

# Main skill
cp -r "$SOURCE_DIR/geo/"* "$CLAUDE_DIR/skills/geo/"

# Sub-skills
for skill_dir in "$SOURCE_DIR/skills"/*/; do
    skill_name=$(basename "$skill_dir")
    mkdir -p "$CLAUDE_DIR/skills/${skill_name}"
    cp -r "$skill_dir"* "$CLAUDE_DIR/skills/${skill_name}/"
done

# Agents
for agent_file in "$SOURCE_DIR/agents/"*.md; do
    cp "$agent_file" "$CLAUDE_DIR/agents/"
done

# Scripts
if [ -d "$SOURCE_DIR/scripts" ]; then
    cp -r "$SOURCE_DIR/scripts/"* "$CLAUDE_DIR/skills/geo/scripts/"
    chmod +x "$CLAUDE_DIR/skills/geo/scripts/"*.py 2>/dev/null || true
fi

# Schema templates
if [ -d "$SOURCE_DIR/schema" ]; then
    cp -r "$SOURCE_DIR/schema/"* "$CLAUDE_DIR/skills/geo/schema/"
fi

# Hooks
if [ -d "$SOURCE_DIR/hooks" ] && [ "$(ls -A "$SOURCE_DIR/hooks" 2>/dev/null)" ]; then
    mkdir -p "$CLAUDE_DIR/skills/geo/hooks"
    cp -r "$SOURCE_DIR/hooks/"* "$CLAUDE_DIR/skills/geo/hooks/"
    chmod +x "$CLAUDE_DIR/skills/geo/hooks/"* 2>/dev/null || true
fi
```

--------------------------------

### Scan brand mentions: /geo brands https://example.com

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Runs the /geo brands command against a domain URL. The brand name is inferred from the site. It checks presence on YouTube, Reddit, Wikipedia/Wikidata, LinkedIn and other platforms, then writes GEO-BRAND-MENTIONS.md with a Brand Authority Score and prioritized recommendations.

```bash
/geo brands https://example.com
```

--------------------------------

### Prioritized Action Plan - Quick Wins markdown table

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-report/SKILL.md

Markdown table template for listing quick win actions (high impact, low effort) with impact, effort, and platforms affected. Use in the Prioritized Action Plan section under Quick Wins.

```markdown
## Prioritized Action Plan

### Quick Wins (This Week)
*High impact, low effort — can be implemented immediately*

| # | Action | Impact | Effort | Platforms Affected |
|---|---|---|---|---|
| 1 | [Specific action] | [High/Med] | [Hours estimate] | [Which AI platforms] |
| 2 | [Specific action] | [High/Med] | [Hours estimate] | [Which AI platforms] |
```

--------------------------------

### Directory structure for prospect, proposal, and report data

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/faq.md

Shows the file layout under ~/.geo-prospects/ where /geo prospect, /geo proposal, and /geo compare write data. This directory is intentionally not removed by uninstall.sh; delete it manually with rm -rf ~/.geo-prospects to discard prospect data.

```plaintext
~/.geo-prospects/
├── prospects.json
├── proposals/<domain>-proposal-<date>.md
└── reports/<domain>-monthly-<YYYY-MM>.md
```

--------------------------------

### Color-code scores and severity classes in GEO report

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/templates/geo-report-template.html

JavaScript that color-codes table cells with score patterns like "40/100" and applies severity classes to finding sections. It also adds a section-break class to major h2 headings that should start on a new page.

```javascript
// Color-code table cells containing score values (e.g. "40/100", "58/100") // and apply severity classes to finding sections (function() { function scoreColor(n) { if (n >= 80) return 'excellent'; if (n >= 65) return 'good'; if (n >= 50) return 'fair'; if (n >= 35) return 'poor'; return 'critical'; } // Color-code table cells with "XX/100" patterns document.querySelectorAll('td').forEach(function(td) { var m = td.textContent.match(/^(\d{1,3})\/100$$/); if (m) { var score = parseInt(m[1]); td.classList.add('score-' + scoreColor(score)); // Also style the row var tr = td.parentElement; tr.classList.add('score-' + scoreColor(score)); } }); // Style finding sections by detecting severity keywords in h3 headings document.querySelectorAll('h3').forEach(function(h3) { var text = h3.textContent.toLowerCase(); var severity = null; if (text.indexOf('critical') !== -1) severity = 'critical'; else if (text.indexOf('high priority') !== -1 || (text.indexOf('high') !== -1 && text.indexOf('priority') === -1 && text.indexOf('priority') === -1)) severity = 'high'; else if (text.indexOf('medium') !== -1) severity = 'medium'; else if (text.indexOf('low') !== -1) severity = 'low'; if (severity) { // Wrap following paragraphs/lists until next heading var sibling = h3.nextElementSibling; while (sibling && !['H1','H2','H3','H4'].includes(sibling.tagName)) { sibling.classList.add('finding-' + severity); sibling = sibling.nextElementSibling; } } }); // Add section-break class to major h2s that should start on new page var breakBefore = [ 'high priority', 'medium priority', 'generated schema', '90-day roadmap', 'component score' ]; document.querySelectorAll('h2').forEach(function(h2) { var text = h2.textContent.toLowerCase(); breakBefore.forEach(function(kw) { if (text.indexOf(kw) !== -1) h2.classList.add('section-break'); }); }); })();
```

--------------------------------

### Run scripted uninstaller

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Executes the uninstall script from the cloned repository directory. Removes ~/.claude/skills/geo/, all ~/.claude/skills/geo-*/ sub-skills, and all ~/.claude/agents/geo-*.md agent files. Python packages are not removed.

```bash
./uninstall.sh
```

--------------------------------

### AI Visibility Dashboard Table

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-report/SKILL.md

A table displaying readiness scores, gaps, and priority actions for various AI search platforms.

```markdown
## AI Visibility Dashboard

| AI Platform | Readiness Score | Key Gap | Priority Action |
|---|---|---|---|
| Google AI Overviews | XX/100 | [One-line gap] | [One-line action] |
| ChatGPT Web Search | XX/100 | [One-line gap] | [One-line action] |
| Perplexity AI | XX/100 | [One-line gap] | [One-line action] |
| Google Gemini | XX/100 | [One-line gap] | [One-line action] |
| Bing Copilot | XX/100 | [One-line gap] | [One-line action] |
```

--------------------------------

### Usage of /geo proposal command

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Basic syntax for generating a proposal, including optional flags for tier, client name, and currency.

```bash
/geo proposal <domain>
/geo proposal <domain> --tier basic|standard|premium --client-name "Name" --monthly EUR
```

--------------------------------

### Clone Upstream Repository

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-update/SKILL.md

Creates a temporary directory and clones the GEO-SEO repository with a shallow depth to prepare for the update process.

```bash
TEMP_DIR=$(mktemp -d)
git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git "$TEMP_DIR/repo"
```

--------------------------------

### Storage directory structure

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-prospect/SKILL.md

Shows the default directory layout under ~/.geo-prospects/ with prospects.json as the main CRM database, plus folders for audits and proposals.

```text
~/.geo-prospects/
├── prospects.json          # Main CRM database
├── audits/                 # Quick audit snapshots
│   └── electron-srl.com-2026-03-12.md
└── proposals/              # Generated proposals
    └── electron-srl.com-proposal.md
```

--------------------------------

### Proposal Generation Confirmation Output

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-proposal/SKILL.md

Displays the confirmation message and file path after a proposal is generated and the prospect status is updated.

```text
✓ Proposal generated: ~/.geo-prospects/proposals/electron-srl.com-proposal-2026-03-12.md
✓ Prospect status updated: Qualified → Proposal
✓ Recommended package: STANDARD (€5,000/month) — Score 32/100

Next: Share the proposal file or run `/geo report-pdf` for a visual version.
```

--------------------------------

### Run /geo content command

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Invokes the /geo content command with a domain URL to analyze content quality. The URL is required and should be the domain root.

```bash
/geo content https://example.com
```

--------------------------------

### Competitor Comparison Section

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-report/SKILL.md

Markdown template for a competitor comparison table and analysis, used when competitor URLs are provided. Includes metrics like GEO score, AIO readiness, and schema coverage.

```markdown
## Competitor Comparison

| Metric | [Your Brand] | [Competitor 1] | [Competitor 2] |
|---|---|---|---|
| Overall GEO Score | XX/100 | XX/100 | XX/100 |
| Google AIO Readiness | XX/100 | XX/100 | XX/100 |
| ChatGPT Readiness | XX/100 | XX/100 | XX/100 |
| Perplexity Readiness | XX/100 | XX/100 | XX/100 |
| Schema Coverage | [Detail] | [Detail] | [Detail] |
| Wikipedia Presence | Yes/No | Yes/No | Yes/No |
| Reddit Authority | [Detail] | [Detail] | [Detail] |
| SSR Status | Yes/No | Yes/No | Yes/No |

### Where You Lead
[Specific areas where the brand outperforms competitors]

### Where You Trail
[Specific areas where competitors have an advantage, with actions to close the gap]
```

--------------------------------

### Run pandoc to generate GEO-REPORT.html

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-report-pdf/SKILL.md

Converts GEO-AUDIT-REPORT.md to a self-contained HTML file using the bundled template and CSS. Replace <field> placeholders with values extracted from the report. Omit any --metadata flag if the field is not found; the template has sensible defaults.

```bash
pandoc GEO-AUDIT-REPORT.md \
  --to html5 \
  --standalone \
  --embed-resources \
  --template ~/.claude/skills/geo/templates/geo-report-template.html \
  --css ~/.claude/skills/geo/templates/geo-report-style.css \
  --metadata title="GEO Audit Report — <brand_name>" \
  --metadata brand_name="<brand_name>" \
  --metadata domain="<domain>" \
  --metadata geo_score="<geo_score>" \
  --metadata score_label="<score_label>" \
  --metadata date="<date>" \
  --metadata business_type="<business_type>" \
  --metadata locations="<locations>" \
  --metadata platform="<platform>" \
  -o GEO-REPORT.html
```

--------------------------------

### Geo Prospect CLI Commands

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

A list of available subcommands for managing prospects, including creating new entries, listing, auditing, and updating status.

```bash
/geo prospect new <domain>
/geo prospect list [<status>]
/geo prospect show <id-or-domain>
/geo prospect audit <id-or-domain>
/geo prospect note <id-or-domain> "<text>"
/geo prospect status <id-or-domain> <new-status>
/geo prospect won <id-or-domain> <monthly-value>
/geo prospect lost <id-or-domain> "<reason>"
/geo prospect pipeline
```

--------------------------------

### Maximum AI Visibility robots.txt Configuration

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-crawlers/SKILL.md

Robots.txt configuration for maximum AI search visibility. Allows GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, GoogleOther, Applebot-Extended, Amazonbot, and FacebookBot, while blocking Bytespider and CCBot.

```robots.txt
# AI Crawlers - ALLOWED for AI search visibility
User-agent: GPTBot
Allow: /

User-agent: OAI-SearchBot
Allow: /

User-agent: ChatGPT-User
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: anthropic-ai
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: Google-Extended
Allow: /

User-agent: GoogleOther
Allow: /

User-agent: Applebot-Extended
Allow: /

User-agent: Amazonbot
Allow: /

User-agent: FacebookBot
Allow: /

# AI Crawlers - BLOCKED (aggressive/low value)
User-agent: Bytespider
Disallow: /

User-agent: CCBot
Disallow: /
```

--------------------------------

### Manually remove skills and agents

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Alternative manual uninstall command that removes the same skill and agent files as the scripted uninstaller.

```bash
rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md
```

--------------------------------

### /geo prospect new <domain>

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Creates a new prospect record with the given domain.

```APIDOC
## /geo prospect new <domain>

### Description
Creates a new prospect record with the given domain.

### Method
CLI Command

### Endpoint
/geo prospect new <domain>

### Parameters
#### Arguments
- **<domain>** (string) - Required - The domain of the prospect.

### Output
Updates ~/.geo-prospects/prospects.json. Prints a confirmation and the current prospect status to the terminal.
```

--------------------------------

### Run /geo audit command

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Executes a comprehensive GEO + SEO audit on the provided homepage URL. Requires a URL argument. Writes GEO-AUDIT-REPORT.md to the working directory.

```bash
/geo audit https://example.com
```

--------------------------------

### PDF report generation workflow

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/geo/SKILL.md

Runs pandoc to convert GEO-AUDIT-REPORT.md into a standalone HTML with embedded resources using the bundled template and CSS, then uses Google Chrome headless to print the HTML to GEO-REPORT.pdf. Requires pandoc and Chrome. The workflow assumes prior execution of /geo audit and /geo report-pdf.

```bash
pandoc GEO-AUDIT-REPORT.md \
  --to html5 --standalone --embed-resources \
  --template ~/.claude/skills/geo/templates/geo-report-template.html \
  --css ~/.claude/skills/geo/templates/geo-report-style.css \
  --metadata brand_name="..." --metadata geo_score="..." \
  -o GEO-REPORT.html

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless=new --disable-gpu --no-sandbox \
  --print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
  --print-to-pdf-no-header --no-pdf-header-footer \
  --virtual-time-budget=5000 \
  "file://$(pwd)/GEO-REPORT.html"
```

--------------------------------

### llms.txt Root Location

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-llmstxt/SKILL.md

The llms.txt file must be hosted at the root of the domain.

```text
https://example.com/llms.txt
```