复制安装命令
用 Codex 或 Claude 安装复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它先审查 Skill 页面再帮你安装。
复制前请先查看来源、License 和安全提示。
The open layer of how Tech Horizon Labs runs GEO / AI-visibility audits — a Claude Code skill su...
用 Codex 或 Claude 安装复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它先审查 Skill 页面再帮你安装。
复制前请先查看来源、License 和安全提示。
来源文件:README.md
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.
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 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.
Same method, three depths — start wherever you are:
| ⚡ Measure visibility | areyoufoundbyai.com | Enter 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 readiness | this repo | Run 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 you | Tech Horizon Labs | We deploy it on your stack, with the calibration data and client playbooks that stay proprietary. |
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;
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.
| Component | What it does |
|---|---|
skills/agent-readiness-scan | Turns 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-kit | Turns 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.md | The orchestration + scoring discipline above. |
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 ofgeo-seo-claudeby 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. SeeNOTICE.mdandCHANGELOG.md. Improving and crediting open source is the standard we hold ourselves to.
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 shortowner/repoform 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.
examples/ — prompts + a worked end-to-end audit.evals/ — how we keep the audit repeatable.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.
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.
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.
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, WritePhilosophy: GEO-first, SEO-supported. AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.
| 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 audit <url>)Phase 1: Discovery (Sequential)
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:
| Dimension | Skill | Measures |
|---|---|---|
| AI visibility (citability + brand) | geo-citability, geo-brand-mentions | Passage citability, off-page brand-authority signals |
| Platform optimisation | geo-platform-optimizer | Per-surface readiness (Google AIO, ChatGPT, Perplexity) |
| Technical | geo-technical | SSR, Core Web Vitals, crawlability, AI-crawler access |
| Content / E-E-A-T | geo-content | Expertise, original data, author credentials |
| Schema | geo-schema | Structured-data detection, validation, generation |
Phase 3: Synthesis (Sequential)
| 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) |
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.
| # | 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 |
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.mdfor 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.
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 |
The /geo report-pdf <url> command generates a professional, branded PDF report:
python3 scripts/generate_pdf_report.py data.json GEO-REPORT.pdf/geo audit <url> to collect all data/geo report-pdf <url> to generate the PDFGEO-REPORT.pdf in the current directory# 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)
暂无评论,成为第一个评论者吧!