Skip to content

techhorizonlabs/thl-open

Repository files navigation

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


The method in this repo, automated. Enter your URL, get your AI-visibility score across ChatGPT · Claude · Perplexity · Google AI — no install, no Claude Code, just the answer.


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:

⚡ Instant areyoufoundbyai.com Enter your URL → your AI-visibility score in ~60 seconds. Free, hosted, nothing to install. This is the method below, automated.
🛠 Do it yourself this repo Run the full six-dimension audit in Claude Code — the same method, all the evidence, none of the black box.
🤝 Done for you Tech Horizon Labs We 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;
Loading
★ = 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

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.

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 part we can give away — and areyoufoundbyai.com is the method automated into a free scanner anyone can run in 60 seconds.

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.

About

AI-visibility engineering, the open way — a Claude Code GEO/AI-search audit suite, two original tools (agent-readiness-scan + audit-report-kit), and the THL method that ties them together.

Topics

Resources

License

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors