zubair-trabzada/geo-seo-claude

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

geo‑seo‑claude – AI‑search (GEO) audit skill for Claude Code

What it is – A Claude Code skill that runs a multi‑step audit of a website and produces a “GEO” (AI‑search) score. It checks how well the site will be discovered and cited by emerging AI‑driven search engines such as ChatGPT, Claude, Perplexity, Gemini and Google AI Overviews, then outputs a client‑ready markdown or PDF report.

Why it matters – By 2026 AI‑referenced traffic is growing > 500 % YoY and conversion rates are several times higher than classic organic traffic. Traditional SEO no longer guarantees visibility; sites need to be citation‑ready for AI crawlers. This tool automates that assessment.

Key capabilities

Capability What it does
Full GEO audit (/geo audit <url>) Runs five parallel sub‑agents (visibility, platform, technical, content, schema) and aggregates a 0‑100 GEO score.
Quick snapshot (/geo quick) 60‑second visibility overview.
Citability scoring (/geo citability) Rates content blocks for AI citation readiness (ideal length 134‑167 words, self‑contained, fact‑rich).
AI‑crawler check (/geo crawlers) Parses robots.txt for > 14 AI bots (GPTBot, ClaudeBot, etc.) and suggests allow/block rules.
Brand‑mention scan (/geo brands) Looks for brand mentions on YouTube, Reddit, Wikipedia, LinkedIn and other platforms; reports authority signals.
llms.txt handling (/geo llmstxt) Validates or generates the emerging llms.txt file that tells AI crawlers site structure.
Schema analysis / generation (/geo schema) Detects missing JSON‑LD, validates against templates, can emit ready‑to‑paste markup.
Report generation (/geo report, ...‑pdf) Produces a markdown or PDF client report with score gauges, bar charts and prioritized action items.
Prospect / proposal helpers (/geo prospect, /geo proposal) Light CRM that stores pipeline data and can auto‑create proposal documents.

Architecture at a glance

geo-seo-claude/
├─ geo/                # entry point (SKILL.md) – defines the /geo commands
├─ skills/            # 13 focused sub‑skills (audit, citability, crawlers…)
├─ agents/            # 5 parallel agent markdown files that orchestrate work
├─ scripts/           # Python utilities (page fetch, scoring, PDF generation)
├─ schema/            # JSON‑LD templates used by the schema sub‑skill
└─ install.sh / uninstall.sh

All Python code runs inside an isolated virtual environment at ~/.claude/skills/geo/.venv/, leaving the system Python untouched.

Installation & requirements

  • One‑liner (macOS/Linux)
    curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
  • Manual – clone the repo, run ./install.sh (or install‑win.sh from Git Bash on Windows).
  • Dependencies – Python 3.8+, Claude Code CLI, Git; optional uv for faster pip installs and Playwright for screenshot support.

Typical workflow

  1. Open Claude Code and type a command, e.g. /geo audit https://example.com.
  2. The skill fetches the homepage, discovers the sitemap, then launches the five sub‑agents in parallel.
  3. Each agent returns a numeric sub‑score; the orchestrator combines them using the weighting table (citability 25 %, brand 20 %, content 20 %, technical 15 %, schema 10 %, platform 10 %).
  4. A composite GEO score and a markdown report are emitted. Use /geo report-pdf for a polished PDF to send to clients.

Data persistence

Prospect and proposal data are stored under ~/.geo-prospects/ (JSON and markdown files). The uninstall script removes the skill but does not delete this directory – you must delete it manually if you want to erase the stored client data.

License & community

  • License: MIT – free to use, modify, and commercialize.
  • Community: The author points to an “AI Workshop” community (Skool) that provides video walkthroughs, a client‑acquisition playbook, and live office hours for agencies that want to monetize the audit service.

TL;DR

geo-seo-claude is a ready‑to‑run Claude Code skill that audits a website for AI‑search visibility (GEO). It bundles Python utilities, JSON‑LD templates, and a set of parallel sub‑agents to produce a numeric GEO score and a polished client report, helping SEO agencies and marketers adapt to the shift toward AI‑driven search results.

Related

  • Project
    umutxyp/Seo-Promt-Master

    A technical SEO auditing framework that turns Google's official documentation into an AI skill, allowing coding agents to audit live servers and fix technical SEO gaps.

  • Project
    AgriciDaniel/claude-seo

    An open-source SEO analysis plugin for Claude Code that uses parallel specialist agents to automate technical audits, content quality checks, and AI search optimization.

  • Project
    joeseesun/qiaomu-seo

    A professional SEO Agent Skill for AI assistants that performs technical audits, traffic diagnostics, and visibility optimization for traditional search engines and AI search platforms.

  • Project
    alirezarezvani/claude-skills

    A massive open‑source library (364 skills, 120 commands) that adds domain‑specific expertise to Claude Code, Codex, Gemini CLI, Cursor, and 9 other AI coding agents. Each skill bundles a structured markdown guide, pure‑Python CLI helpers, and reference assets. The repo includes personas, an orchestration protocol, and a built‑in security auditor, making it a turnkey way to turn any LLM‑coding assistant into a full‑stack engineering, product, marketing, compliance, or C‑suite advisor.

  • Project
    KKKKhazix/khazix-skills

    A collection of standardized AI agent skills (instruction sets) for goal definition, disk cleanup, deep research, and project documentation maintenance.