AGENT SKILLBY AGRICIDANIEL
Blog GEO: AI citation optimization audit
AT A GLANCE
Blog GEO: AI citation optimization audit is an agent skill for SEO. AI citation readiness audit as part of SEO, covering classic Google search and AI search surfaces together. The agricidaniel/claude-blog repository on GitHub, maintained by agricidaniel, has 1.9K stars and the MIT license. To add it, run npx skills add agricidaniel/claude-blog --skill blog-geo
- SOURCE REPOSITORY
- agricidaniel/claude-blog (opens GitHub in a new tab)
- REPO STARS
- SOURCE REPOSITORY
- LICENSE
- MIT
- SKILL.MD SIZE
- 17.2 KB369 LINES
QUICK ANSWER
- WHAT IT IS01
- AI citation readiness audit as part of SEO, covering classic Google search and AI search surfaces together. It stands out by giving search and SEO workflows a defined shape, so the agent asks for better context and returns a more usable result.
- INPUTS02
- Context for search and SEO workflows: your goals, audience, constraints, and any source material the skill asks for.
- OUTPUT03
- A ready-to-use result for search and SEO workflows: the analysis, copy, or recommendations the agent produces.
INSTALL
One command adds this skill from its source repository.
npx skills add agricidaniel/claude-blog --skill blog-geoREAD THE SKILL.MD BELOW BEFORE YOU RUN IT. SKILLS INSTRUCT YOUR AGENT.
SKILL.MD
The full file, as published in the source repository. Copy it, download it or open it on GitHub.
ON THIS PAGE · 12
Blog GEO: AI Citation Optimization Audit#
Scores blog posts for AI citation readiness across ChatGPT, Perplexity, Claude, Gemini, Copilot, You.com, Google AI Overviews, and Google AI Mode as one SEO workflow, not a separate discipline. Generates a 0-100 internal AI Citation Readiness heuristic with platform-specific recommendations. The score is not a calibrated probability of citation.
Google's 2026-05-15 guidance frames generative-AI optimization as SEO: no special markup, llms.txt requirement, or separate GEO/AEO playbook is required for Google visibility. Use GEO/AEO as shorthand labels only.
Cross-reference#
This skill covers FLOW surface 3 (AI assistant citations: ChatGPT, Perplexity, Claude, Gemini, Copilot, You.com) and contributes to surface 2 (SERP plus AI Overviews). Surface mapping: skills/blog/references/flow-alignment.md.
For directly relevant AI-citation prompts (AI-supporting-pages rewrite,
evidence-based quality follow-up, ChatGPT discovery, visibility prompts), see
/blog flow optimize.
Evidence Discipline#
Use numeric AI-citation benchmarks only when the report includes a source block with URL, publisher, methodology, sample size, engine or version, query class, retrieval date, and expiry date. If any field is missing, label the benchmark as directional or remove the number. Default heuristics:
- Self-contained, evidence-backed explanations can aid reuse, but Google prescribes no passage-length or "chunking" requirement.
- Comparison tables with semantic headers may improve extractability, but do not cite an uplift without a dated source block.
- AI Overviews coverage is methodology-dependent: cite a dated range, not a fixed point.
Audit Process#
Step 1: Read Content#
Extract from the blog post:
- Full content text and word count
- Heading structure (H1, H2, H3 hierarchy)
- Individual paragraphs and their word counts
- FAQ sections (if present)
- Schema markup (JSON-LD, microdata, RDFa)
- robots.txt mentions or meta robots directives
- Any TL;DR or summary boxes
- Comparison tables and their HTML structure
- Numbered/ordered lists
- Definition-style formatting
Step 2: Evidence-Backed Citability (4 pts)#
Check each section between headings for AI-extractable passages:
| Check | Criteria |
|---|---|
| Context independence | Each passage makes sense extracted from surrounding context |
| Claim structure | Passages contain: specific claim + supporting evidence + source attribution |
| Completeness | Passage answers a question without requiring reader to read adjacent sections |
Scoring: Count important sections meeting the evidence and completeness criteria. Do not score section length.
- 4 pts: 80%+ sections have citable passages
- 3 pts: 60-79%
- 2 pts: 40-59%
- 1 pt: 20-39%
- 0 pts: <20%
Step 3: Purpose Fit and Reader Utility (3 pts)#
Check heading format and answer structure:
| Check | Criteria |
|---|---|
| Clear purpose | The introduction identifies the page's topic, audience, and reader task |
| Useful section openings | Important sections state the point without throat-clearing |
| Intent-matched format | Declarative headings, questions, FAQs, tables, and lists are used only when they fit the material |
Scoring:
- 3 pts: All three criteria met
- 2 pts: Two criteria met
- 1 pt: One criterion met
- 0 pts: None met
Step 4: Entity Clarity (3 pts)#
Check topic consistency and disambiguation:
| Check | Criteria |
|---|---|
| Canonical topic | One unambiguous primary topic per page |
| Consistent naming | Same entity name used throughout (no confusing synonyms) |
| Intro statement | Clear topic statement in the introduction paragraph |
| Title-content match | Title accurately reflects the content focus |
Scoring:
- 3 pts: All four criteria met
- 2 pts: Three criteria met
- 1 pt: One or two criteria met
- 0 pts: None met
Step 5: Content Structure for Extraction (3 pts)#
Check for AI-extractable content patterns:
| Check | Criteria |
|---|---|
| Summary | Optional standalone summary when it helps the intended reader |
| Comparison tables | Tables with semantic headers such as <thead> or clear column labels |
| Ordered lists | Numbered lists for processes and step-by-step instructions |
| Definition formatting | Key terms formatted with clear definition patterns |
| Evidence-backed explanations | Important reusable claims carry enough context and source support |
Scoring:
- 3 pts: 4-5 elements present
- 2 pts: 3 elements present
- 1 pt: 1-2 elements present
- 0 pts: None present
Step 6: AI Crawler Accessibility (2 pts)#
Check technical requirements for AI crawler indexing:
| Check | Criteria |
|---|---|
| Rendered content | Important content is present in the rendered DOM and accessible to the target crawler |
| Google visibility | Normal crawlability and indexability for Googlebot. No special GEO/AEO file or markup is required for Google AI features |
| Non-Google AI crawlers | If the site wants visibility in non-Google answer engines, check robots.txt treatment for GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot, and related documented crawlers |
| Schema consistency | Structured data reaches the rendered DOM and matches visible content |
| Page size | Reasonable page size within AI crawler limits |
Scoring:
- 2 pts: Google crawlability/indexability is clean, and selected non-Google crawler policies match the site's stated goals
- 1 pt: Google is indexable but one selected non-Google crawler or rendering check needs review
- 0 pts: Google crawling/indexing is blocked or multiple selected crawlers are unintentionally blocked
Step 7: Platform-Specific Analysis#
Evaluate observable readiness for each declared surface. Product behavior changes by mode, query set, geography, and date, so do not infer causal preferences from a vendor sample.
ChatGPT#
- Check that material claims are source-backed and useful without depending on a specific content format.
- Treat current citation samples as non-causal context, not a listicle, freshness, or domain-authority rule.
Perplexity#
- Check crawlability, source fidelity, and material freshness when the query is time-sensitive. Verify observations with current logs or reproducible tooling before describing product behavior.
Google AI Overviews#
- Follow Google's normal SEO guidance: make content helpful, crawlable, indexable, and eligible for snippets. No special GEO/AEO markup or llms.txt is required for Google visibility.
- Measure Search and AI-feature visibility separately. Organic overlap observed in a sample does not establish a preference or guarantee inclusion.
Google AI Mode#
- Treat separately from AI Overviews in reports. Emphasize normal Search eligibility, clear page purpose, accessible text, and consistency between visible content and structured data.
Claude, Gemini, Copilot, and You.com#
- Evaluate content clarity, source accessibility, freshness, and whether robots policy intentionally allows or blocks each crawler where documented.
- Use engine-specific recommendations only when current docs, logs, or test results are available.
For each platform, provide:
- Current citability rating (High / Medium / Low)
- Specific improvements to clarity, source fidelity, usefulness, and crawlability
- Content format recommendations
Step 8: Strengthen Reusable Evidence#
For important sections that lack support, propose a self-contained improvement with a specific claim, the context needed to understand it, and a verified source or transparent original methodology. Do not pad every section, impose a word band, or manufacture statistics.
Step 9: Calculate AI Citation Readiness Score (0-100)#
Map the 15-point subcategory scores to a 0-100 display score:
| Category | Raw Points | Display Weight | Max Display Score |
|---|---|---|---|
| Evidence-Backed Citability | /4 | x6.75 | 27 |
| Purpose Fit and Reader Utility | /3 | x6.67 | 20 |
| Entity Clarity | /3 | x6.67 | 20 |
| Content Structure | /3 | x6.67 | 20 |
| AI Crawler Accessibility | /2 | x6.5 | 13 |
| Total | /15 | 100 |
Rating thresholds:
- 90-100: Excellent: highly citable by AI systems
- 70-89: Good: citable with minor improvements
- 50-69: Needs Work: significant gaps in citability
- Below 50: Poor: major restructuring needed
Step 10: Generate Report#
Output the following report:
## AI Citation Readiness Report: [Title]
**AI Citation Readiness Heuristic: [X]/100**: [Rating]
This is an internal editorial heuristic, not a calibrated probability.
### Score Breakdown
| Category | Raw | Display | Max |
|----------|-----|---------|-----|
| Evidence-Backed Citability | X/4 | X | 27 |
| Purpose Fit and Reader Utility | X/3 | X | 20 |
| Entity Clarity | X/3 | X | 20 |
| Content Structure | X/3 | X | 20 |
| AI Crawler Accessibility | X/2 | X | 13 |
| **Total** | **X/15** | **X** | **100** |
### Per-Section Citability Analysis
| Section (H2) | Purpose Clear | Self-Contained | Claim+Evidence | Ready |
|---------------|---------------|----------------|----------------|-------|
| [heading] | Yes/No | Yes/No | Yes/No | Yes/No |
### Platform-Specific Optimization
#### ChatGPT
- [specific recommendations]
#### Perplexity
- [specific recommendations]
#### Google AI Overviews
- [specific recommendations]
#### Google AI Mode
- [specific recommendations]
#### Claude / Gemini / Copilot / You.com
- [specific recommendations]
### Evidence Improvements
#### [H2 Section 1]
> [Self-contained, source-backed improvement sized to the material]
#### [H2 Section 2]
> [Self-contained, source-backed improvement sized to the material]
### Technical Recommendations
- [ ] [Technical fix with specifics]
### Priority Action Items
1. [Most impactful improvement]
2. [Second most impactful]
3. [Third most impactful]
Run `/blog analyze <file>` for full content quality scoring.Optional: Search Performance Context (blog-google)#
If blog-google credentials include Tier 1 (GSC) and the post has a published URL:
- Query GSC by page and query dimensions, then filter rows to the URL:
python3 skills/blog-google/scripts/run.py gsc_query --property <property> --dimensions query,page --json - Add to platform-specific analysis:
- Current impressions, clicks, CTR, average position
- Search queries driving traffic to this URL
- Check indexation:
python3 skills/blog-google/scripts/run.py gsc_inspect <url> --json - Report indexation status, canonical selection, mobile usability.
- If skipped, report
SKIPPED: credentials unavailableorSKIPPED: unpublished URL.
Optional: AI Citation Readiness Heuristic#
For a per-engine readiness view (distinct
from the 15-point AI Citation Readiness category scored by /blog analyze), run:
python3 scripts/ai_citation_score.py <file> --format markdownIt returns a non-calibrated 0-100 overall heuristic plus per-engine subscores
for Google AI Overview, Perplexity, and ChatGPT, a factor breakdown, and up to
three highest-impact fixes. Legacy overall_probability output is retained
only as a compatibility alias.
Supporting file: skills/blog/references/flow-alignment.md#
FLOW Alignment in claude-blog#
This reference explains how claude-blog adopts the FLOW framework. Load it on demand when a user asks about FLOW, evidence standards, surface coverage, or how the blog skills route to FLOW stages.
1. What FLOW is and why claude-blog adopted it#
FLOW is an evidence-led 2026-search operating model published at github.com/AgriciDaniel/flow (CC BY 4.0 prompt content, MIT code), authored by Daniel Agrici. It treats modern discovery as a multi-surface system rather than a single SERP, and it encourages traceable support for material public claims. claude-blog v2.1.0 includes FLOW through the blog-flow sub-skill (originally integrated in v1.7.0) plus this alignment doc, which informs how every other blog skill in the suite plans, writes, optimizes, and audits content. FLOW provides the principles and prompts; claude-blog provides the production tooling that applies them at scale.
2. Evidence records in claude-blog#
Material public statistics need enough provenance for readers and editors to verify and interpret them. Useful fields include:
- Relevant date or study period when it changes the claim's meaning.
- Identifiable source with publisher and document title where needed.
- Retrievable support through a stable URL, plus retrieval notes for changeable or undated sources.
- Methodology and limitations when they affect interpretation.
The publication's citation style controls presentation. No fixed sentence form or complete field set is required for every source. Unverifiable statistics get dropped, and contradicted statistics get replaced with a verified alternative.
3. The FLOW 5-surface model#
In 2026 a query reaches a buyer through 5 parallel surfaces, often without a site visit. Coverage on each surface is planned independently.
| Surface | What it is | Where claude-blog handles it |
|---|---|---|
| 1. Owned site | Direct organic ranking on the publisher's domain | blog-write, blog-rewrite (on-page), blog-seo-check |
| 2. SERP + AI Overviews | Google SERP including AIO panels | blog-geo, blog-schema, blog-seo-check |
| 3. AI assistant citations | ChatGPT, Perplexity, Claude, Gemini, Copilot, You.com | blog-geo (citation readiness), blog-flow optimize (visibility prompts) |
| 4. Local pack | Map listings, Google Business Profile | Out of scope for blog content. Use claude-seo (/seo local, /seo maps) for local SEO. |
| 5. Communities + video | Reddit, YouTube, LinkedIn, Quora, niche forums | blog-repurpose (multi-platform), skills/blog/references/distribution-playbook.md, blog-cluster (interlinked content) |
claude-blog operationalizes surfaces 1, 2, 3, and 5 directly. Surface 4 is delegated to claude-seo. When a blog post targets a query that also surfaces in a community (Reddit thread, YouTube comment), the writer should consider dual-surface thinking: optimize the post for extraction AND consider whether the same answer should also live in the community where the query is asked.
4. FLOW stages mapped to existing claude-blog skills#
| FLOW stage | claude-blog skills that consume this | When to invoke /blog flow <stage> directly |
|---|---|---|
| Find (5 prompts) | blog-brief, blog-outline, blog-strategy, blog-cluster (planning) | When you want raw FLOW prompts for keyword discovery, audience avatar, content prioritization without invoking a full brief/outline workflow |
| Optimize (21 prompts) | blog-rewrite, blog-seo-check, blog-geo, blog-schema, blog-audit, blog-factcheck | When you want a specific optimization prompt (CTR audit, evidence-based quality follow-up, ChatGPT visibility, schema, PAA rewording, technical audit) for one-shot use |
| Win (3 prompts) | blog-audit, blog-repurpose, blog-analyze | When you want the BOFU page brief, conversion audit, or dual-surface scorecard for a specific URL |
| Prompts | (umbrella index) | When browsing all 30 blog-applicable prompts, including the 1 leverage-stage prompt that has no top-level command |
| Sync | (no skill consumes this) | When you want to refresh the synced FLOW reference files from the upstream repo |
The Leverage stage (off-site authority, 1 prompt) and Local stage (11 GBP/citation prompts) are intentionally not exposed as top-level claude-blog commands. Leverage is reachable through /blog flow prompts. Local is delegated to claude-seo.
5. What claude-blog adds beyond FLOW#
- Visual media pipeline: AI image generation via Gemini (
blog-image), inline SVG charts (blog-chart), Pixabay/Unsplash/Pexels integration. FLOW does not prescribe asset generation. - Writing-persona system (
blog-persona) for voice/tone profiles. FLOW is voice-agnostic. - 5-category 100-point scoring (
blog-analyze). FLOW provides quality bars but no numeric scoring. - Topic-cluster execution engine (
blog-cluster). FLOW prescribes content planning; claude-blog also executes clusters end-to-end with auto-interlinks. - Multilingual publishing (
blog-multilingual,blog-translate,blog-localize,blog-locale-audit). FLOW is single-locale by default. - Audio narration (
blog-audio). Not in FLOW scope. - Google API integration (
blog-google: PSI, CrUX, GSC, GA4, NLP, YouTube, Keywords). FLOW references measurement; claude-blog provides API tooling. - Source-grounded research via NotebookLM (
blog-notebooklm). Adjacent to FLOW's evidence discipline; provides the research side. - CMS taxonomy sync (
blog-taxonomy). Operational layer FLOW does not address.
These additions implement the FLOW principles in production tooling; they do not modify the principles.
6. When to consult this doc vs. the synced FLOW source#
- This doc (
flow-alignment.md): the orchestrator and any sub-skill loads this when the user asks "what does claude-blog do for AI citations / evidence / surfaces", to give a claude-blog-specific answer with skill names and routing. - The synced FLOW source (
skills/blog-flow/references/flow-framework.mdplus 30 prompts): load when applying a specific FLOW prompt or quoting the framework verbatim. CC BY 4.0 attribution is required for any quote. - The bibliography (
skills/blog-flow/references/bibliography.md): load when verifying sources for a statistic.
Last updated 2026-07-23 for claude-blog v2.1.0.
FAQ
07 QUESTIONS
01What is the Blog GEO agent skill?
AI citation readiness audit as part of SEO, covering classic Google search and AI search surfaces together. It is listed under SEO and content in the 100xLab agent skills directory.
02How do I install Blog GEO: AI citation optimization audit in Cursor, Claude Code, or Codex?
Run npx skills add agricidaniel/claude-blog --skill blog-geo in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only Blog GEO: AI citation optimization audit, not every skill in the repository.
03What does the Blog GEO: AI citation optimization audit SKILL.md cover?
The SKILL.md includes sections on Cross-reference, Evidence Discipline, Audit Process, Step 1: Read Content, Step 2: Evidence-Backed Citability (4 pts) and Step 3: Purpose Fit and Reader Utility (3 pts). Read the full text on this page or in plain markdown at /resources/agent-skills/agricidaniel-claude-blog--blog-geo--pi9wzf/raw.
04Which agents can use Blog GEO: AI citation optimization audit?
Blog GEO: AI citation optimization audit installs with the cross-agent skills installer (npx skills add), which sets it up for agents such as Claude Code, Cursor and Codex. Each agent loads the SKILL.md when you ask for the skill by name.
05What license is Blog GEO: AI citation optimization audit under?
The agricidaniel/claude-blog repository declares the MIT license. Read the license file in the repository before you copy or redistribute the skill.
06Is Blog GEO: AI citation optimization audit free to use?
Reading, copying and installing Blog GEO: AI citation optimization audit costs nothing: it is published in a public GitHub repository under the MIT license. Reuse and redistribution follow that license.
07Where is the source of Blog GEO: AI citation optimization audit?
Blog GEO: AI citation optimization audit comes from https://github.com/agricidaniel/claude-blog, which has 1.9K GitHub stars. The SKILL.md is at https://github.com/agricidaniel/claude-blog/blob/HEAD/skills/blog-geo/SKILL.md. The author is agricidaniel.
Need an agent workflow built around your stack?
Tell us the workflow you want automated. We reply within 4 working hours (IST).
ATTRIBUTION
Blog GEO: AI citation optimization audit was written by its original authors and is published in agricidaniel/claude-blog (opens GitHub in a new tab) under the MIT license. All rights stay with the original authors.
100xLab did not write, maintain or endorse this skill. This page lists it for discovery. Repo stars belong to the source repository, not to the skill. Review any skill before you install it.