Skip to main content
The geo-audit skill is the orchestration layer at the heart of thl-open. Point it at any URL and it runs five specialised subagents in parallel (one per GEO dimension group), each fetching evidence, scoring its dimensions and returning a provenance-tagged result. The skill then computes a composite GEO Score (0 to 100) and writes everything into a single GEO-AUDIT-REPORT.md you can act on.
This composite is not the AI Readiness score in your Are you found by AI? report. The geo-audit GEO Score is thl-open’s own audit: six dimensions, including Brand Authority, combined with the repo’s fixed weights. That AI Readiness score is a different measure, composed of five site signals (Citability, E-E-A-T, Technical, Schema and Platform), with off-site presence scored separately as Footprint. Do not compare the two numbers directly or present one as the other.
Like AI Readiness, the geo-audit composite is a readiness measure: it reads public signals and infers how citable and recommendable a site is. It does not query the AI engines to confirm whether they actually name you right now. For that, use the found-by-ai skill or run the free scan at areyoufoundbyai.com.

​
Prerequisites

  • Claude Code with the THL Open skill suite installed:

​
How to Run a Full Audit

Invoke the skill from Claude Code with the target URL:
Claude Code begins a three-phase workflow:
1

Discovery and Reconnaissance

The skill fetches the homepage, detects your business type (SaaS, Local Business, E-commerce, Publisher, Agency, or Professional/YMYL), then crawls your sitemap or internal links to build a page list of up to 50 URLs. It records titles, headings, schema markup, word counts, and response codes for every page.
2

Parallel Subagent Delegation

Five specialised subagents run simultaneously (not sequentially) so the full audit completes in roughly the time it takes to run the slowest single dimension:Every subagent returns its dimension score (0 to 100, or a placeholder dash instead of a number when unmeasured), a provenance tag, and findings tied to the evidence that justifies them.
3

Score Aggregation and Report Generation

The orchestrator collects all subagent results, applies the fixed composite formula, and writes GEO-AUDIT-REPORT.md to your working directory.

​
The Composite Formula

The overall GEO Score is a weighted average across six dimensions. These are thl-open’s published weights for its own audit, and subagents cannot change them:

​
Output: GEO-AUDIT-REPORT.md

The skill writes a structured Markdown file containing:

Composite Score

Overall GEO Score (0 to 100) with a rating band: Excellent (90 to 100), Good (75 to 89), Fair (60 to 74), Poor (40 to 59), or Critical (0 to 39)

Per-Dimension Scores

Each of the six dimensions scored with its provenance tag: [scan], [partial-scan], [heuristic], or [unmeasured]. Unmeasured dimensions show a placeholder dash, never an invented number

Prioritised Findings

Issues classified as Critical, High, Medium, or Low, each with specific page URLs and the evidence behind the finding

30-Day Action Plan

Week-by-week fix sequence with quick wins, medium-term improvements, and strategic changes, ordered by expected impact on your score

​
Targeted Dimension Audits

You don’t need to run the full audit every time. Use individual dimension commands for faster, focused analysis: Each targeted command writes its own output file (e.g., GEO-CITABILITY-SCORE.md, GEO-SCHEMA-REPORT.md) so you can share individual dimension results without running the full audit.

​
Provenance Tags

Every score the audit emits carries one of four provenance tags. These tell you exactly how much to trust each number:
A [heuristic] tag is not a failure. It means informed model judgement based on available signals. But treat it differently from [scan]: a heuristic score is a useful pointer, not a measured fact. When a category is [unmeasured], the report emits a placeholder dash rather than a number, because a number with weak provenance still reads as hard data.

​
Combining with the THL Method

The geo-audit skill is the first layer of the three-layer THL GEO Method:
  1. Dimensional audit (geo-audit): six GEO dimensions, a composite 0 to 100 and an action plan
  2. External benchmark (agent-readiness-scan): Cloudflare’s independent 0 to 100, tracked as a delta across re-audits
  3. Deliverable (audit-report-kit): a branded PDF and compile-checked JSON-LD from the audit data
Run the agent-readiness-scan skill alongside geo-audit so you have two independent scores: one from your own dimensional analysis and one from Cloudflare’s public benchmark. On a re-audit, the delta on each is the proof of progress.