Agent skill

GEO-First SEO Audit Tool

by zubair-trabzada in zubair-trabzada/geo-seo-claude

Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

MITAuto-check: notesMarketing & SEO

Install GEO-First SEO Audit Tool

skills CLI
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zubair-trabzada/geo-seo-claude geo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/geo .claude/skills/geo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
geo
GitHub stars
11k
Token cost
~2.8k tokens
SKILL.md length
957 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

  • Works in 3 steps: Fetch homepage HTML (curl or WebFetch) → Detect business type (SaaS, Local,… → Extract key pages from sitemap.xml or…
  • Running a full GEO and SEO audit on a website URL
  • SKILL.md covers Quick Reference, Market Context (Why GEO Matters), Orchestration Logic and Business Type Detection, plus 6 more sections
  • Calls pandoc and brew

What it does

The skill runs under a GEO-first, SEO-supported philosophy: it treats optimizing for AI-powered search as the priority while still covering technical SEO foundations. Slash commands drive the work, including a full audit with parallel subagents, single-page GEO analysis, citability scoring for AI citation readiness, AI crawler access checks against robots.txt, llms.txt analysis and generation, brand mention scanning across AI-cited platforms, platform-specific optimization for ChatGPT, Perplexity and Google AI Overviews, schema markup detection and generation, and traditional technical SEO and content quality (E-E-A-T) checks.

Output commands produce a client-ready GEO report or a PDF with charts and scores, plus lighter sales-pipeline commands for managing prospects and generating client proposals and monthly comparison reports. A full audit runs a sequential discovery phase first: fetching the homepage HTML and detecting the business type (SaaS, local, e-commerce, publisher, agency or other) before branching into the rest of the checks.

When your agent uses it

  • Running a full GEO and SEO audit on a website URL
  • Scoring a page's content for AI citation readiness
  • Checking whether AI crawlers can access a site, including llms.txt
  • Generating a client-ready GEO report or proposal

Example prompts

  • “/geo audit https://example.com”
  • “Score example.com's blog post for AI citability.”
  • “Generate an llms.txt file for our site and check our AI crawler access.”
  • “Create a client-ready GEO PDF report for example.com.”

Requirements

  • Read, Grep, Glob, Bash, WebFetch and Write tool access
  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash, WebFetch, Write

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Fetch homepage HTML (curl or WebFetch)
  2. Detect business type (SaaS, Local, E-commerce, Publisher, Agency, Other)
  3. Extract key pages from sitemap.xml or internal links (up to 50 pages)

What it can do on your machine

Read from SKILL.md and the folder at commit 989cae0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Bash
    • WebFetch
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pandoc
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

GEO-First SEO Audit Tool loads about 2.8k tokens when it runs. Until then it costs about 151 tokens; SKILL.md has 957 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~151
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Grep, Glob, Bash, WebFetch, Write

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zubair-trabzada/geo-seo-claude at commit 989cae0, republished under its MIT licence (© zubair-trabzada). 957 words, ~2,786 tokens.

Download SKILL.mdSave it as .claude/skills/geo/SKILL.md (or your agent's skills folder).
name
geo
description
GEO-first SEO analysis tool. Optimizes websites for AI-powered search engines (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations. Performs full GEO audits, citability scoring, AI crawler analysis, llms.txt generation, brand mention scanning, platform-specific optimization, schema markup, technical SEO, content quality (E-E-A-T), and client-ready GEO report generation. Use when user says "geo", "seo", "audit", "AI search", "AI visibility", "optimize", "citability", "llms.txt", "schema", "brand mentions", "GEO report", or any URL for analysis.
allowed-tools
Read, Grep, Glob, Bash, WebFetch, Write

GEO-SEO Analysis Tool — Claude Code Skill (February 2026)

Philosophy: GEO-first, SEO-supported. AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.


Quick Reference

CommandWhat It Does
/geo audit <url>Full GEO + SEO audit with parallel subagents
/geo page <url>Deep single-page GEO analysis
/geo citability <url>Score content for AI citation readiness
/geo crawlers <url>Check AI crawler access (robots.txt analysis)
/geo llmstxt <url>Analyze or generate llms.txt file
/geo brands <url>Scan brand mentions across AI-cited platforms
/geo platforms <url>Platform-specific optimization (ChatGPT, Perplexity, Google AIO)
/geo schema <url>Detect, validate, and generate structured data
/geo technical <url>Traditional technical SEO audit
/geo content <url>Content quality and E-E-A-T assessment
/geo report <url>Generate client-ready GEO deliverable
/geo report-pdf <url>Generate professional PDF report with charts and scores
/geo quick <url>60-second GEO visibility snapshot
/geo prospect <cmd>CRM-lite: manage prospects through the sales pipeline
/geo proposal <domain>Auto-generate client proposal from audit data
/geo compare <domain>Monthly delta report: show score improvements to client
/geo updatePull latest GEO skill updates from upstream

Market Context (Why GEO Matters)

MetricValueSource
GEO services market (2025)$850M-$886MYahoo Finance / Superlines
Projected GEO market (2031)$7.3B (34% CAGR)Industry analysts
AI-referred sessions growth+527% (Jan-May 2025)SparkToro
AI traffic conversion vs organic4.4x higherIndustry data
Google AI Overviews reach1.5B users/month, 200+ countriesGoogle
ChatGPT weekly active users900M+OpenAI
Perplexity monthly queries500M+Perplexity
Gartner: search traffic drop by 2028-50%Gartner
Marketers investing in GEOOnly 23%Industry surveys
Brand mentions vs backlinks for AI3x stronger correlationAhrefs (Dec 2025)

Orchestration Logic

Full Audit (/geo audit <url>)

Phase 1: Discovery (Sequential)

  1. Fetch homepage HTML (curl or WebFetch)
  2. Detect business type (SaaS, Local, E-commerce, Publisher, Agency, Other)
  3. Extract key pages from sitemap.xml or internal links (up to 50 pages)

Phase 2: Parallel Analysis (Delegate to Subagents) Launch these 5 subagents simultaneously:

SubagentFileResponsibility
geo-ai-visibilityagents/geo-ai-visibility.mdGEO audit, citability, AI crawlers, llms.txt, brand mentions
geo-platform-analysisagents/geo-platform-analysis.mdPlatform-specific optimization (ChatGPT, Perplexity, Google AIO)
geo-technicalagents/geo-technical.mdTechnical SEO, Core Web Vitals, crawlability, indexability
geo-contentagents/geo-content.mdContent quality, E-E-A-T, readability, AI content detection
geo-schemaagents/geo-schema.mdSchema markup detection, validation, generation

Phase 3: Synthesis (Sequential)

  1. Collect all subagent reports
  2. Calculate composite GEO Score (0-100)
  3. Generate prioritized action plan
  4. Output client-ready report
Scoring Methodology
CategoryWeightMeasured By
AI Citability & Visibility25%Passage scoring, answer block quality, AI crawler access
Brand Authority Signals20%Mentions on Reddit, YouTube, Wikipedia, LinkedIn; entity presence
Content Quality & E-E-A-T20%Expertise signals, original data, author credentials
Technical Foundations15%SSR, Core Web Vitals, crawlability, mobile, security
Structured Data10%Schema completeness, JSON-LD validation, rich result eligibility
Platform Optimization10%Platform-specific readiness (Google AIO, ChatGPT, Perplexity)

Business Type Detection

Analyze homepage for patterns:

TypeSignals
SaaSPricing page, "Sign up", "Free trial", "/app", "/dashboard", API docs
Local ServicePhone number, address, "Near me", Google Maps embed, service area
E-commerceProduct pages, cart, "Add to cart", price elements, product schema
PublisherBlog, articles, bylines, publication dates, article schema
AgencyPortfolio, case studies, "Our services", client logos, testimonials
OtherDefault — apply general GEO best practices

Adjust recommendations based on detected type. Local businesses need LocalBusiness schema and Google Business Profile optimization. SaaS needs SoftwareApplication schema and comparison page strategy. E-commerce needs Product schema and review aggregation.


Show full SKILL.md (422 more words)Show less

Sub-Skills (14 Specialized Components)

#SkillDirectoryPurpose
1geo-auditskills/geo-audit/Full audit orchestration and scoring
2geo-citabilityskills/geo-citability/Passage-level AI citation readiness
3geo-crawlersskills/geo-crawlers/AI crawler access and robots.txt
4geo-llmstxtskills/geo-llmstxt/llms.txt standard analysis and generation
5geo-brand-mentionsskills/geo-brand-mentions/Brand presence on AI-cited platforms
6geo-platform-optimizerskills/geo-platform-optimizer/Platform-specific AI search optimization
7geo-schemaskills/geo-schema/Structured data for AI discoverability
8geo-technicalskills/geo-technical/Technical SEO foundations
9geo-contentskills/geo-content/Content quality and E-E-A-T
10geo-reportskills/geo-report/Client-ready deliverable generation
11geo-prospectskills/geo-prospect/CRM-lite prospect and client pipeline management
12geo-proposalskills/geo-proposal/Auto-generate client proposals from audit data
13geo-compareskills/geo-compare/Monthly delta tracking and progress reports
14geo-updateskills/geo-update/Pull latest updates from upstream repository

Subagents (5 Parallel Workers)

AgentFileSkills Used
geo-ai-visibilityagents/geo-ai-visibility.mdgeo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions
geo-platform-analysisagents/geo-platform-analysis.mdgeo-platform-optimizer
geo-technicalagents/geo-technical.mdgeo-technical
geo-contentagents/geo-content.mdgeo-content
geo-schemaagents/geo-schema.mdgeo-schema

Output Files

All commands generate structured output:

CommandOutput File
/geo auditGEO-AUDIT-REPORT.md
/geo pageGEO-PAGE-ANALYSIS.md
/geo citabilityGEO-CITABILITY-SCORE.md
/geo crawlersGEO-CRAWLER-ACCESS.md
/geo llmstxtllms.txt (ready to deploy)
/geo brandsGEO-BRAND-MENTIONS.md
/geo platformsGEO-PLATFORM-OPTIMIZATION.md
/geo schemaGEO-SCHEMA-REPORT.md + generated JSON-LD
/geo technicalGEO-TECHNICAL-AUDIT.md
/geo contentGEO-CONTENT-ANALYSIS.md
/geo reportGEO-CLIENT-REPORT.md (presentation-ready)
/geo report-pdfGEO-REPORT.pdf (professional PDF with charts)
/geo quickInline summary (no file)
/geo prospectUpdates ~/.geo-prospects/prospects.json
/geo proposal~/.geo-prospects/proposals/<domain>-proposal-<date>.md
/geo compare~/.geo-prospects/reports/<domain>-monthly-<YYYY-MM>.md

PDF Report Generation

The /geo report-pdf <url> command converts GEO-AUDIT-REPORT.md into a styled, client-ready PDF.

Requirements
  • pandoc — brew install pandoc
  • Google Chrome — /Applications/Google Chrome.app/ (standard Mac install)

No Python dependencies required for PDF generation.

What the PDF Includes
  • Cover page — dark navy gradient, GEO score badge, brand/domain/date/location metadata
  • Color-coded score tables — cells with XX/100 values are automatically colored green/blue/amber/orange/red
  • Severity-tagged findings — Critical/High/Medium/Low sections get colored left-border callout blocks
  • Section page breaks — major sections break to new pages automatically
  • Styled code blocks — JSON schema templates render with dark monospace theme
Templates

Bundled at ~/.claude/skills/geo/templates/:

  • geo-report-style.css — stylesheet (edit colors, fonts, layout here)
  • geo-report-template.html — pandoc HTML template (edit cover fields here)
Workflow
  1. Run /geo audit <url> to produce GEO-AUDIT-REPORT.md
  2. Run /geo report-pdf — extracts metadata from the report and runs:
    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"
  3. Output: GEO-REPORT.pdf in the current directory

Quality Gates

  • Crawl limit: Max 50 pages per audit (focus on quality over quantity)
  • Timeout: 30 seconds per page fetch
  • Rate limiting: 1-second delay between requests, max 5 concurrent
  • Robots.txt: Always respect, always check
  • Duplicate detection: Skip pages with >80% content similarity

Quick Start Examples

# 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

© zubair-trabzada, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in geo of zubair-trabzada/geo-seo-claude.

Open the folder on GitHubat commit 989cae0

Compare with similar skills

GEO-First SEO Audit Tool next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

GEO-First SEO Audit Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
GEO-First SEO Audit Tool this skillzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
SEONexus-JPF/note-companion870—~2.2kAutomated safety check: PassMIT
SEOAgriciDaniel/seo-os1372 repos~3.5kAutomated safety check: PassMIT
SEOAgriciDaniel/codex-seo799—~3.7kAutomated safety check: PassMIT
Money SEOiamzifei/show-me-the-money1k—~4.4kAutomated safety check: PassCustom licence
AI Discoverability AuditBrianRWagner/ai-marketing-claude-code-skills441—~2.3kAutomated safety check: PassNone

Similar skills

  • SEO

    Nexus-JPF/note-companion

    Use and read this skill immediately if the user request is in any way related to SEO or a site's organic search or AI search presence.

    870 GitHub stars~2.2k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • SEO

    AgriciDaniel/seo-os

    Comprehensive SEO analysis for any website or business type.

    137 GitHub starsUsed in 2 repos~3.5k tokens
    Marketing & SEOAuto-check passed
  • SEO

    AgriciDaniel/codex-seo

    Comprehensive SEO analysis for any website, page, business, or topic.

    799 GitHub stars~3.7k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed
  • Money SEO

    iamzifei/show-me-the-money

    SEO and GEO (Generative Engine Optimization) for organic traffic and AI search visibility.

    1k GitHub stars~4.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • AI Discoverability Audit

    BrianRWagner/ai-marketing-claude-code-skills

    Audits how a brand is described by AI search tools such as ChatGPT, Perplexity and Gemini, then produces a scored report, action plan and re-audit schedule.

    441 GitHub stars~2.3k tokensUpdated 6 mo ago
    Marketing & SEOAuto-check passed
  • Global SEO Growth

    minhnv0807/ai-business-skills

    Covers six SEO layers for a website: crawl and index audit, local SEO, search-intent content, AI search visibility, schema markup and backlink or directory distribution.

    609 GitHub stars~5k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed

More from zubair-trabzada/geo-seo-claude

All 16 skills in this repo
  • GEO Monthly Delta Report

    zubair-trabzada/geo-seo-claude

    Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.

    11k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check: notes
  • AI Citability Scorer

    zubair-trabzada/geo-seo-claude

    Scores how likely AI assistants are to quote passages from a web page and suggests rewrites that make those passages easier to extract.

    11k GitHub starsUsed in 2 repos~3.7k tokens
    Auto-check: notes
  • GEO Service Proposal Generator

    zubair-trabzada/geo-seo-claude

    Builds a client-ready AI-search-optimization proposal from an existing GEO audit, with pricing tiers, an ROI estimate and a markdown document ready to send.

    11k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • GEO Content E-E-A-T Scorer

    zubair-trabzada/geo-seo-claude

    Scores a page's content against Google's E-E-A-T framework and AI-citability structure, then writes a scored gap-analysis report.

    11k GitHub starsUsed in 2 repos~4k tokens
    Auto-check: notes
  • GEO Prospect Tracker

    zubair-trabzada/geo-seo-claude

    Tracks GEO agency leads and clients through a sales pipeline in a local JSON file, with notes, audit scores, deal values and a pipeline summary.

    11k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • llms.txt Analyzer and Generator

    zubair-trabzada/geo-seo-claude

    Validates an existing llms.txt file or crawls a site to generate a new one, following the format rules for a root-level Markdown file aimed at AI systems.

    11k GitHub starsUsed in 2 repos~3.9k tokens
    Auto-check: notes

Categories

Questions about GEO-First SEO Audit Tool

What does GEO-First SEO Audit Tool do?

Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality. The skill runs under a GEO-first, SEO-supported philosophy: it treats optimizing for AI-powered search as the priority while still covering technical SEO foundations.txt analysis and generation, brand mention scanning across AI-cited platforms, platform-specific optimization for ChatGPT, Perplexity and Google AI Overviews, schema markup detection and generation, and traditional technical SEO and content quality (E-E-A-T) checks.

When should I use GEO-First SEO Audit Tool?

GEO-First SEO Audit Tool fits situations like: running a full GEO and SEO audit on a website URL; scoring a page's content for AI citation readiness; checking whether AI crawlers can access a site, including llms.txt; generating a client-ready GEO report or proposal.

How do I install GEO-First SEO Audit Tool in Claude Code?

Run `npx skills add zubair-trabzada/geo-seo-claude --skill geo -a claude-code`. Or copy the skill folder (geo in zubair-trabzada/geo-seo-claude) into .claude/skills/geo in your project. Claude Code loads it when a task matches its description.

How do I install GEO-First SEO Audit Tool in Codex?

Run `npx skills add zubair-trabzada/geo-seo-claude --skill geo -a codex`. Or copy the skill folder (geo in zubair-trabzada/geo-seo-claude) into .agents/skills/geo in your project. Codex loads it when a task matches its description.

Can I use GEO-First SEO Audit Tool in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zubair-trabzada/geo-seo-claude --skill geo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/geo, .gemini/skills/geo, .github/skills/geo and .opencode/skills/geo in your project.

What does GEO-First SEO Audit Tool need to run?

Going by SKILL.md and its folder, GEO-First SEO Audit Tool needs the command-line tools its instructions call (pandoc and brew). Our summary lists: Read, Grep, Glob, Bash, WebFetch and Write tool access. Its frontmatter pre-approves these tools: Read, Grep, Glob, Bash, WebFetch, Write.

Does GEO-First SEO Audit Tool access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is GEO-First SEO Audit Tool safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does GEO-First SEO Audit Tool use?

GEO-First SEO Audit Tool is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does GEO-First SEO Audit Tool use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to GEO-First SEO Audit Tool?

Skills that share tags, products or a category with GEO-First SEO Audit Tool: SEO (Nexus-JPF/note-companion, 870 stars), SEO (AgriciDaniel/seo-os, 137 stars), SEO (AgriciDaniel/codex-seo, 799 stars) and Money SEO (iamzifei/show-me-the-money, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains GEO-First SEO Audit Tool?

zubair-trabzada (a GitHub user) maintains it in zubair-trabzada/geo-seo-claude, which has 10,982 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 10, 2026.

Source: zubair-trabzada/geo-seo-claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.