Creator · TheSmokeDev
Last updated · Sep 6, 2026
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 me
Do not auto-install
Install targets
Codex install prompt
Install the "geo" agent skill from https://github.com/TheSmokeDev/geo-skills/tree/main/skills/geo. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: 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. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"thesmokedev-geo","task":"Install geo","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + OpenAI Agents + CLI
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add TheSmokeDev/geo-skills --skill geo
Maintenance
fresh
4d since push
Risk
Needs review
Permission surface may require sandboxing
GitHub quality
22
60/100 Quality · 63/100 Trust
Coverage tags
Review notes
Permission surface may require sandboxing · Financial research output is not financial advice; require human review before any live investment decision
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
PromisingUseful candidate, but compare it with alternatives before adopting.
Trust
Do not auto-installTrust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.
Audit
Needs reviewA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Choose a stronger alternative or inspect the source manually before any install attempt.
Stars
22 GitHub stars
Repo activity
22 stars, 6 forks
Maintenance
4d since push
License
MIT
Install
npx skills add TheSmokeDev/geo-skills --skill geo
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add TheSmokeDev/geo-skills --skill geoDo not use when
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
medium
Skill may inspect schemas, query databases, or work with persistent stores.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20geo%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20geo%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/thesmokedev-geo/install
Agent should check
Copy prompt
Task: Use geo in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20geo%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/thesmokedev-geo/install
Install command: npx skills add TheSmokeDev/geo-skills --skill geo
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/thesmokedev-geo/install
LLM text format
/api/skills/thesmokedev-geo/install?format=text
Find alternatives
/api/skills/search?q=geo&limit=3
Agent prompt
Use geo for this task. Review https://www.openagentskill.com/api/skills/thesmokedev-geo/install, then install with: npx skills add TheSmokeDev/geo-skills --skill geoRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/thesmokedev-geo
LLM text
/api/registry/manifest/thesmokedev-geo?format=text
Install alias
/api/registry/install/thesmokedev-geo
Recommend
/api/registry/recommend?task=Use%20geo%20in%20an%20agent%20workflow&limit=3
Agent fit
Research agents
Use-case tags
Platforms
Claude Code, OpenAI Agents
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Prototype with this skill first; keep a fallback candidate ready.
Role in stack
Fallback candidate
Primary fit
Research agents
Trust label
Prototype first
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Trust Score v5 found insufficient evidence for agent installation. Treat this as discovery material, not an executable recommendation.
GitHub adoption
FIX22 GitHub stars
Stars/forks activity
FIX22 stars, 6 forks; issue activity unavailable in current metadata
Recent maintenance
PASS4d since push
License clarity
PASSMIT
Good signals
Review before install
Recommended action
Choose a stronger alternative or inspect the source manually before any install attempt.
Quality profile
Useful candidate, but compare it with alternatives before adopting.
Workflow fit
Investigate faster
I need my agent to research a topic, compare sources, and produce a concise report.
Collect structured data
I need my agent to scrape websites and extract structured data from pages.
Analyze markets
I need my agent to analyze markets, financial data, filings, portfolios, and quant strategies.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Scrape, clean, and reuse web data
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Alternative shortlist
Similar skills that may fit this task.
Wazuh - The Open Source Security Platform. Unified XDR and SIEM protection for endpoints and cloud workloads.
🕵️♂️ Collect a dossier on a person by username from 3000+ sites
Nuclei is a fast, customizable vulnerability scanner powered by the global security community and built on a simple YAML-based DSL, enabling collaboration to tackle trending vulnerabilities on the internet. It helps you find vulnerabilities in your applications, APIs, networks, DNS, and cloud configurations.
Infisical is the open-source platform for secrets, certificates, and privileged access management.
--- 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
| 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 |
---
## 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 | Branded web mentions r=0.664, YouTube mentions r=0.737; raw backlink counts far weaker (directional only — precise figure has no locatable primary source) | Ahrefs 75K brands (Jul 2026) |
---
## 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 (10 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 facts-hedge analysis and generation (anti-hallucination hygiene, not a visibility lever) | | 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 rich results and entity clarity | | 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 |
---
## 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 generates a professional, branded PDF report:
### How It Works 1. Run the full audit or individual analyses first 2. Collect all scores and findings into a JSON structure 3. Execute the PDF generator: `python3 ~/.claude/skills/geo/scripts/generate_pdf_report.py data.json GEO-REPORT.pdf`
### What the PDF Includes - **Cover page** with GEO score gauge visualization - **Score breakdown** with color-coded bar charts - **AI Platform Readiness** dashboard with horizontal bar chart - **Crawler Access** status table with color-coded Allow/Block - **Key Findings** categorized by severity (Critical/High/Medium/Low) - **Prioritized Action Plan** (Quick Wins, Medium-Term, Strategic) - **Methodology & Glossary** appendix
### Workflow 1. First run `/geo audit <url>` to collect all data 2. Then run `/geo report-pdf <url>` to generate the PDF 3. The tool will compile audit data into JSON, then generate the PDF 4. 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 ```
Source provenance
Decision snapshot
recent repository activity
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for geo, ready for a manual X post.
geo: GEO-first SEO analysis tool. Optimizes websites for AI-powered search engines (ChatGPT, Claud... 22 stars https://www.openagentskill.com/skills/thesmokedev-geo?ref=x
Listing + install path for geo: https://www.openagentskill.com/skills/thesmokedev-geo?ref=x Install: npx skills add TheSmokeDev/geo-skills --skill geo
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to TheSmokeDev but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/thesmokedev-geo?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/thesmokedev-geo?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/thesmokedev-geo/audit)
[](https://www.openagentskill.com/skills/thesmokedev-geo?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)TheSmokeDev
@thesmokedev
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Do not auto-install
Wazuh
Wazuh - The Open Source Security Platform. Unified XDR and SIEM protection for endpoints and cloud workloads.
16.3K StarsMaigret
🕵️♂️ Collect a dossier on a person by username from 3000+ sites
32.9K StarsNuclei
Nuclei is a fast, customizable vulnerability scanner powered by the global security community and built on a simple YAML-based DSL, enabling collaboration to tackle trending vulnerabilities on the internet. It helps you find vulnerabilities in your applications, APIs, networks, DNS, and cloud configurations.
29.2K StarsInfisical
Infisical is the open-source platform for secrets, certificates, and privileged access management.
27.4K StarsPermission surface
shell or command execution, filesystem or document access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness