agent-readiness-scan
Use when a client audit, GEO/AI-visibility snapshot, or remediation re-scan needs the Cloudflare agent-readiness score from isitagentready.com — e.g. Theo…
AI citability scoring and optimization. Analyzes web page content to determine how likely AI systems (ChatGPT, Claude, Perplexity, Gemini) are to cite or quote passages from the page. Provides a citability score (0-100) with specific rewrite suggestions.
$ npx -y skills add techhorizonlabs/thl-open --skill geo-citability --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/geo-citabilityContext preview
The summary Claude sees to decide when to auto-load this skill.
AI citability scoring and optimization. Analyzes web page content to determine how likely AI systems (ChatGPT, Claude, Perplexity, Gemini) are to cite or quote passages from the page. Provides a citability score (0-100) with specific rewrite suggestions.
name: geo-citability description: AI citability scoring and optimization. Analyzes web page content to determine how likely AI systems (ChatGPT, Claude, Perplexity, Gemini) are to cite or quote passages from the page. Provides a citability score (0-100) with specific rewrite suggestions. allowed-tools: - Read - Grep - Glob - Bash - WebFetch - Write
AI language models cite passages that meet specific structural criteria. Research on Generative Engine Optimization (Aggarwal et al., KDD 2024) found GEO tactics can lift visibility in AI answers by roughly **30–115%** depending on the tactic and query set (see [`docs/SOURCES.md`](../../docs/SOURCES.md) for provenance on this and the length figure). The pattern: AI systems preferentially extract passages that are **~134–167 words long**, **self-contained** (understandable without surrounding context), **fact-rich** (specific statistics, dates, named entities), and **directly answer a question** in the first 1-2 sentences.
> **This score is a proxy, not a measurement.** It scores how *extractable* your passages are against these research-derived criteria — it does not ask an AI engine whether it actually quoted you. Any "expected lift" is a research-informed estimate, never a promise. For the live check of whether the engines name you, run the free scan at **[areyoufoundbyai.com](https://areyoufoundbyai.com)** (two buyer questions on ChatGPT and Gemini; the trial and paid tiers cover all seven engines).
This is fundamentally different from traditional SEO copywriting, which optimizes for keyword density and user engagement metrics. GEO citability optimizes for **extractability** -- the ease with which an AI system can pull a passage from your content and present it as a direct answer.
---
This measures whether content contains clear, quotable answer passages that AI systems can extract verbatim.
**Scoring Criteria:**
| Score | Criteria | |---|---| | **90-100** | Every major section opens with a 1-2 sentence direct answer. Uses "X is..." or "X refers to..." patterns. First 40-60 words of each section can stand alone as a complete answer. | | **70-89** | Most sections have clear answer openings. Some definition patterns present. Answers are identifiable but may need minor context. | | **50-69** | Some sections have answer-like openings but many bury the answer in the middle or end of paragraphs. Few explicit definition patterns. | | **30-49** | Answers are generally buried in long paragraphs. No consistent definition patterns. Content is narrative-driven rather than answer-driven. | | **0-29** | No identifiable answer blocks. Content is entirely narrative, conversational, or fragmented. AI would struggle to extract any quotable passage. |
**What to look for:**
**High-citability example:**
Content delivery networks (CDNs) are distributed server systems that cache and serve web content from locations geographically close to end users. A CDN reduces latency by 50-70% on average by serving assets from edge servers rather than a single origin server. The three largest CDN providers as of 2025 are Cloudflare (serving approximately 20% of all websites), Amazon CloudFront, and Akamai Technologies.
Word count: 58. Self-contained: Yes. Facts: 3 specific data points. Definition pattern: Yes.
**Low-citability example:**
If you've ever wondered why some websites load faster than others, the answer might surprise you. There's this amazing technology that has been around for a while now. It's changed the way we think about web performance. Let me explain how it works and why you should care about it for your business.
Word count: 52. Self-contained: No (no topic identified). Facts: 0. Definition pattern: No.
---
This measures whether individual passages can be extracted and understood without needing the surrounding content.
**Scoring Criteria:**
| Score | Criteria | |---|---| | **90-100** | 80%+ of content blocks are fully self-contained. Each passage names its subject explicitly. No reliance on pronouns referencing earlier content. Contains specific facts within the passage. | | **70-89** | 60-79% of content blocks are self-contained. Most passages name their subject. Occasional pronoun references that require context. | | **50-69** | 40-59% of content blocks are self-contained. Mixed use of explicit subjects and pronouns. Some passages require reading prior sections. | | **30-49** | 20-39% of content blocks are self-contained. Heavy reliance on pronouns and contextual references. Most passages need surrounding text. | | **0-29** | Under 20% self-contained. Content reads as a continuous narrative where extracting any paragraph loses meaning. |
**Self-containment checklist for each passage:**
1. Does the passage explicitly name the subject (not "it," "this," "they")? 2. Can someone understand the main point reading ONLY this passage? 3. Does the passage contain at least one specific fact, statistic, or named entity? 4. Is the passage between 50-200 words (the optimal extraction length)? 5. Does the passage avoid starting with conjunctions ("But," "However," "And") that imply prior context?
---
This measures the structural formatting that helps AI systems parse and segment content.
**Scoring Criteria:**
| Score | Criteria | |---|-
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.
Repo: techhorizonlabs/thl-open
Use when a client audit, GEO/AI-visibility snapshot, or remediation re-scan needs the Cloudflare agent-readiness score from isitagentready.com — e.g. Theo…
Measure whether AI engines actually recommend a business when buyers ask. Runs the free live scan at areyoufoundbyai.com (no auth, ~60s), reads the verdict and…
Full website GEO+SEO audit with parallel subagent delegation. Orchestrates a comprehensive Generative Engine Optimization audit across AI citability, platform…
Brand mention and authority scanner for AI visibility. Analyzes brand presence across platforms that AI models rely on for entity recognition and citation…
Monthly delta tracking and progress reporting for GEO clients. Compares two GEO audits (baseline vs. current), calculates score improvements across all…
Content quality and E-E-A-T assessment for AI citability — evaluate experience, expertise, authoritativeness, trustworthiness, and content structure