AGENT SKILL

geo

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.

License 许可
Apache-2.0
最近更新
2026-11-03
Stars
★ 8
Forks
2

01 前言 Front Matter

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

03 SKILL.md 正文

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

Command What 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 update Pull latest GEO skill updates from upstream

Market Context (Why GEO Matters)

Metric Value Source
GEO services market (2025) $850M-$886M Yahoo 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 organic 4.4x higher Industry data
Google AI Overviews reach 1.5B users/month, 200+ countries Google
ChatGPT weekly active users 900M+ OpenAI
Perplexity monthly queries 500M+ Perplexity
Gartner: search traffic drop by 2028 -50% Gartner
Marketers investing in GEO Only 23% Industry surveys
Brand mentions vs backlinks for AI 3x stronger correlation Ahrefs (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:

Subagent File Responsibility
geo-ai-visibility agents/geo-ai-visibility.md GEO audit, citability, AI crawlers, llms.txt, brand mentions
geo-platform-analysis agents/geo-platform-analysis.md Platform-specific optimization (ChatGPT, Perplexity, Google AIO)
geo-technical agents/geo-technical.md Technical SEO, Core Web Vitals, crawlability, indexability
geo-content agents/geo-content.md Content quality, E-E-A-T, readability, AI content detection
geo-schema agents/geo-schema.md Schema 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

Category Weight Measured By
AI Citability & Visibility 25% Passage scoring, answer block quality, AI crawler access
Brand Authority Signals 20% Mentions on Reddit, YouTube, Wikipedia, LinkedIn; entity presence
Content Quality & E-E-A-T 20% Expertise signals, original data, author credentials
Technical Foundations 15% SSR, Core Web Vitals, crawlability, mobile, security
Structured Data 10% Schema completeness, JSON-LD validation, rich result eligibility
Platform Optimization 10% Platform-specific readiness (Google AIO, ChatGPT, Perplexity)

Business Type Detection

Analyze homepage for patterns:

Type Signals
SaaS Pricing page, "Sign up", "Free trial", "/app", "/dashboard", API docs
Local Service Phone number, address, "Near me", Google Maps embed, service area
E-commerce Product pages, cart, "Add to cart", price elements, product schema
Publisher Blog, articles, bylines, publication dates, article schema
Agency Portfolio, case studies, "Our services", client logos, testimonials
Other Default — 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.


Sub-Skills (14 Specialized Components)

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

Subagents (5 Parallel Workers)

Agent File Skills Used
geo-ai-visibility agents/geo-ai-visibility.md geo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions
geo-platform-analysis agents/geo-platform-analysis.md geo-platform-optimizer
geo-technical agents/geo-technical.md geo-technical
geo-content agents/geo-content.md geo-content
geo-schema agents/geo-schema.md geo-schema

Output Files

All commands generate structured output:

Command Output File
/geo audit GEO-AUDIT-REPORT.md
/geo page GEO-PAGE-ANALYSIS.md
/geo citability GEO-CITABILITY-SCORE.md
/geo crawlers GEO-CRAWLER-ACCESS.md
/geo llmstxt llms.txt (ready to deploy)
/geo brands GEO-BRAND-MENTIONS.md
/geo platforms GEO-PLATFORM-OPTIMIZATION.md
/geo schema GEO-SCHEMA-REPORT.md + generated JSON-LD
/geo technical GEO-TECHNICAL-AUDIT.md
/geo content GEO-CONTENT-ANALYSIS.md
/geo report GEO-CLIENT-REPORT.md (presentation-ready)
/geo report-pdf GEO-REPORT.pdf (professional PDF with charts)
/geo quick Inline summary (no file)
/geo prospect Updates ~/.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:
    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

04 同仓库更多 Skills

iamwaqargulzar
iamwaqargulzar/Marketing-Agent-OS

video

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'record a product demo,' 'feature demo video,' 'in-app demo,' 'video pipeline,' 'copy this edit,' 'match this video style,' 'reverse-engineer this video,' 'edit like this reference,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

★ 8
iamwaqargulzar
iamwaqargulzar/Marketing-Agent-OS

social

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social content, repurposing, scheduling, video scripts, and listening. Posts avoid AI tells like 'it's not X, it's Y' reveals and broetry. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

★ 8
iamwaqargulzar
iamwaqargulzar/Marketing-Agent-OS

sms

When the user wants to plan, build, or optimize SMS, MMS, or WhatsApp marketing — including welcome flows, abandoned cart texts, post-purchase, win-back, promotional sends, or transactional/auth SMS. Also use when the user mentions "SMS marketing," "text message campaigns," "SMS sequence," "SMS automation," "abandoned cart text," "post-purchase SMS," "Klaviyo SMS," "Postscript," "Attentive," "Twilio," "A2P 10DLC," "TCPA," "SMS compliance," "short code," "toll-free SMS," "MMS campaign," "should I do SMS," "SMS vs email," "WhatsApp marketing," "WhatsApp Business API," "WhatsApp templates," or "click-to-WhatsApp." For email sequences, see emails. For SMS copy framing, see copywriting. For opt-in popups that capture phone numbers, see popups.

★ 8
iamwaqargulzar
iamwaqargulzar/Marketing-Agent-OS

site-architecture

When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions "sitemap," "site map," "visual sitemap," "site structure," "page hierarchy," "information architecture," "IA," "navigation design," "URL structure," "breadcrumbs," "internal linking strategy," "website planning," "what pages do I need," "how should I organize my site," "site navigation," "which website builder should I use," "migrate my website," or "add a blog to my existing site." Use this whenever someone is planning what pages a website should have, how they connect, and where to build them. NOT for XML sitemaps (that's technical SEO — see seo-audit). For SEO audits, see seo-audit. For structured data, see schema.

★ 8
iamwaqargulzar
iamwaqargulzar/Marketing-Agent-OS

signup

When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the user mentions "signup conversions," "registration friction," "signup form optimization," "free trial signup," "reduce signup dropoff," "account creation flow," "people aren't signing up," "signup abandonment," "trial conversion rate," "nobody completes registration," "too many steps to sign up," or "simplify our signup." Use this whenever the user has a signup or registration flow that isn't performing. For post-signup onboarding, see onboarding. For lead capture forms (not account creation), see cro.

★ 8
iamwaqargulzar
iamwaqargulzar/Marketing-Agent-OS

seo-audit

When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.

★ 8