SkillAtlasSkill 详情

geo

The open layer of how Tech Horizon Labs runs GEO / AI-visibility audits — a Claude Code skill su...

审核状态:已审核Quality 80Security 80

复制安装命令

用 Codex 或 Claude 安装复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它先审查 Skill 页面再帮你安装。

复制前请先查看来源、License 和安全提示。

项目 README

来源文件:README.md

抓取于 2026年7月29日

THL Open

AI-visibility engineering, the open way

The open layer of how Tech Horizon Labs runs GEO / AI-visibility audits — a Claude Code skill suite, two original tools, and the method that ties them together.

License: MIT Built for Claude Code Method PRs welcome


⚡ Are you found by AI?  — run the free 60-second scan →

The live measurement: it asks all seven answer engines — ChatGPT · Claude · Gemini · Perplexity · Grok · DeepSeek · Google AI — whether they actually name you, and who they name instead. Up to 228 live answers per full measure, every one recorded verbatim, 2,100+ businesses on the public index. This repo is the readiness diagnosis behind that score.


A client-ready AI-visibility audit — composite score, evidence-backed findings, and a ranked fix sequence — generated by the audit-report-kit in this repo

A client-ready audit — composite score, evidence-backed findings, ranked fixes — produced by audit-report-kit in this repo. (Sample data is fictional.)


Search is splitting in two. A growing share of your future customers will never click a blue link — they'll get an answer straight from ChatGPT, Claude, Perplexity, or Google's AI Overview. GEO — Generative Engine Optimization — is how you stay inside that answer. This repo is how we measure it, engineer it, and prove the movement.

We're an Australian AI-visibility agency. This is the open layer of our practice: the method we actually use on client work, the tools we built ourselves, and our improvements to the open-source GEO suite we build on. The calibration data, client playbooks, and full engagement pack stay proprietary — but the method and the utilities are here, for free.


Three ways to get found by AI

Same method, three depths — start wherever you are:

⚡ Measure visibilityareyoufoundbyai.comEnter your URL → the live check of whether all seven answer engines (ChatGPT, Claude, Gemini, Perplexity, Grok, DeepSeek and Google's AI actually name you, in ~60 seconds. Free, hosted, nothing to install. The outcome.
🛠 Diagnose readinessthis repoRun the full six-dimension readiness audit in Claude Code — why you're visible or not, all the evidence, none of the black box. The inputs you control.
🤝 Done for youTech Horizon LabsWe deploy it on your stack, with the calibration data and client playbooks that stay proprietary.

The method (start here)

Everything in this repo is organised around one opinionated workflow — the THL GEO Method. Three layers, each answering a different question:

flowchart TB
    A["1 · Dimensional audit — geo-audit<br/>six GEO dimensions → a 0–100 composite + action plan"]
    B["2 · External benchmark ★ — agent-readiness-scan<br/>Cloudflare's 0–100, tracked as a delta across re-audits"]
    C["3 · Deliverable ★ — audit-report-kit<br/>a branded PDF + compile-checked JSON-LD to paste"]
    A --> B --> C
    A -.-> C
    classDef thl fill:#6993ff,stroke:#1a1a2e,color:#ffffff;
    class B,C thl;
★ = built by THL, end to end

The discipline that makes it repeatable: every score traces to evidence, the composite is a fixed formula, and you verify the artifacts — not that "a run happened." Full write-up in docs/THL-GEO-METHOD.md; the run-time QA lives in the audit checklist.


What's inside

★ Built by THL, end to end

ComponentWhat it does
skills/agent-readiness-scanTurns Cloudflare's public isitagentready.com check into audit-grade artifacts — a fixed-schema CSV, the 0–100 score, and the evidence behind it. The independent benchmark the dimensional audit can't give itself.
tools/audit-report-kitTurns an audit's JSON into a polished, branded client PDF (react-pdf) plus compile-checked JSON-LD (schema-dts) — the schema the audit recommends, ready to paste. (That's the report pictured above.)
docs/THL-GEO-METHOD.mdThe orchestration + scoring discipline above.

The GEO skill suite

A comprehensive set of Claude Code skills for Generative Engine Optimization — full audits, citability scoring, AI-crawler analysis, llms.txt, schema markup, brand-mention scanning, platform-specific optimization, technical SEO, content E-E-A-T, and report generation.

Honest attribution: the geo-* skills are an improved fork of geo-seo-claude by Zubair Trabzada (MIT). We've de-rotted them, fixed portability, and wired them into our method and tools — but the foundation is his good open-source work, and we credit it. See NOTICE.md and CHANGELOG.md. Improving and crediting open source is the standard we hold ourselves to.


Quickstart

As a Claude Code plugin (installs the whole suite). Run these as two separate commands — paste the first, press Enter, then paste the second (pasting both at once makes Claude Code treat the blob as one broken /plugin call):

/plugin marketplace add https://github.com/techhorizonlabs/thl-open
/plugin install thl-open@thl-open

Use the full https:// URL — the short owner/repo form makes some setups clone via SSH and fail without an SSH key configured.

Or copy just the skills you want:

cp -R skills/agent-readiness-scan ~/.claude/skills/
cp -R skills/geo-audit skills/geo-crawlers skills/geo-schema ~/.claude/skills/

Then, in Claude Code:

run an agent-readiness scan on example.com
do a GEO audit of example.com

The report kit (Node):

cd tools/audit-report-kit && npm install && npm run report   # → out/*.pdf + out/*.jsonld

👉 New here? Start with examples/ — copy-paste prompts for every skill and one worked audit (fictional broker) you can read end to end.


Learn more

Heads up: skills can run code and fetch the open web. Read a skill before you install it, and treat fetched web content as data, not instructions. There's no telemetry — nothing here phones home (SECURITY.md). Our authoring standard bakes this in; we ask the same of contributions.


Who's behind this

Tech Horizon Labs is a Claude-native GTM + AI-visibility studio. We deploy this infrastructure for real clients — insurance brokers, professional-services firms, and scale-ups — on Cloudflare, into the workspace they already run. This repo is the readiness diagnosis we can give away — and areyoufoundbyai.com is the live visibility measurement, free for anyone to run in 60 seconds. Readiness here; visibility there. (How they fit together.)

If it's useful, a ⭐ helps. Issues and PRs welcome — see CONTRIBUTING.md.

License

MIT. The geo-* suite retains its original MIT notice (Zubair Trabzada) per skills/geo/LICENSE-geo-seo-claude; everything else is © Tech Horizon Labs. Use it, fork it, ship it.

其他

中风险

  • 来源需自行核对维护者身份。
  • 包含脚本或命令调用,安装前请复核。
  • 未检测到明显外部权限要求。
  • 未检测到高风险命令。
  • 扫描发现:2 条。

Codex — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/techhorizonlabs/thl-open.git
  3. 将 "skills/geo" 文件夹复制到 Codex 的 skills 目录中。
  4. 重启 Codex 让新的 skill 生效。

Codex — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Codex 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Codex 让新的 skill 生效。

Claude Code — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/techhorizonlabs/thl-open.git
  3. 将 "skills/geo" 文件夹复制到 Claude Code 的 skills 目录中。
  4. 重启 Claude Code 让新的 skill 生效。

Claude Code — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Claude Code 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Claude Code 让新的 skill 生效。

Cursor — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/techhorizonlabs/thl-open.git
  3. 将 "skills/geo" 文件夹复制到 Cursor 的 skills 目录中。
  4. 重启 Cursor 让新的 skill 生效。

Cursor — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Cursor 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Cursor 让新的 skill 生效。

GitHub Copilot — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/techhorizonlabs/thl-open.git
  3. 将 "skills/geo" 文件夹复制到 GitHub Copilot 的 skills 目录中。
  4. 重启 GitHub Copilot 让新的 skill 生效。

GitHub Copilot — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 GitHub Copilot 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 GitHub Copilot 让新的 skill 生效。

Windsurf — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/techhorizonlabs/thl-open.git
  3. 将 "skills/geo" 文件夹复制到 Windsurf 的 skills 目录中。
  4. 重启 Windsurf 让新的 skill 生效。

Windsurf — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Windsurf 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Windsurf 让新的 skill 生效。
查看 SKILL.md 原文
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 (improved by Tech Horizon Labs)

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

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: Dimensional analysis (delegate to the specialised skills) The canonical orchestrator is skills/geo-audit — it runs the five analysis dimensions in parallel under a fixed return contract and composite. This umbrella skill defers to it; don't re-implement the orchestration here. The dimensions and the skills that measure them:

DimensionSkillMeasures
AI visibility (citability + brand)geo-citability, geo-brand-mentionsPassage citability, off-page brand-authority signals
Platform optimisationgeo-platform-optimizerPer-surface readiness (Google AIO, ChatGPT, Perplexity)
Technicalgeo-technicalSSR, Core Web Vitals, crawlability, AI-crawler access
Content / E-E-A-Tgeo-contentExpertise, original data, author credentials
Schemageo-schemaStructured-data 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.


Sub-Skills (13 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

What this measures — and what it can't

These skills read public signals — your pages, schema, crawler access, and off-page authority (Wikipedia/Wikidata verified live; other platforms via search) — and from them infer how citable and recommendable you are to AI answer engines. That inference is grounded in published research (see docs/SOURCES.md) and is genuinely useful for fixing the foundations you control.

What it does not do: it does not query ChatGPT, Claude, Perplexity or Google's AI live to check whether they actually name you in an answer. That's a different measurement — the outcome, not the inputs — and it's what our hosted scanner does:

For the full audit — the live "are you actually in the answer" measurement across ChatGPT, Claude, Perplexity and Google's AI — run the free scan at areyoufoundbyai.com. These open skills score your readiness; the scanner measures your visibility. (See docs/THL-GEO-METHOD.md for how the two fit together.)

Every score this suite emits is tagged with its provenance ([scan] / [partial-scan] / [heuristic] / [unmeasured]) — read a [heuristic] tag as "informed model judgement from signals," not a measured fact.


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 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 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

发现问题?提交给管理员复核

评分:

评论 (0)

暂无评论,成为第一个评论者吧!