agricidaniel/blog-geo
> AI citation readiness audit as part of SEO, covering classic Google search and AI search surfaces together. Use whenever the user wants their content to rank or be cited in ChatGPT, Perplexity, Claude, Gemini, Copilot, You.com, Google AI Overviews, or Google AI Mode. AI citation optimization audit scoring blog posts for major answer surfaces. Evaluates passage-level citability, Q&A formatting, entity clarity, structured data, and AI crawler accessibility. Generates citation capsules and a 0-100 AI Citation Readiness score. Use when user says "geo", "ai citation", "ai optimization", "citation audit", "aeo", "perplexity optimization", "chatgpt citation".
npx skills add https://github.com/AgriciDaniel/claude-blog --skill blog-geo
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 citation capsules and a 0-100 AI
Citation Readiness score with platform-specific recommendations.
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.
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-prompt, ai-detector-test, ChatGPT discovery, visibility prompts), see /blog flow optimize.
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:
cite an uplift without a dated source block.
fixed point.
Extract from the blog post:
Check each section between headings for AI-extractable passages:
| Check | Criteria |
|-------|----------|
| Word count | Each section contains 120-180 word self-contained passages |
| 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 passages meeting all criteria vs total sections.
Check heading format and answer structure:
| Check | Criteria |
|-------|----------|
| Question headings | 60-70% of H2s are phrased as questions |
| Answer-first format | Opening paragraph under each H2 provides a direct answer |
| FAQ section | Dedicated FAQ section with structured question-answer pairs |
Scoring:
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:
Check for AI-extractable content patterns:
| Check | Criteria |
|-------|----------|
| TL;DR box | 40-60 word standalone summary present at top |
| 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 |
| Citation capsules | 40-60 word definitive statements in each major section |
Scoring:
Check technical requirements for AI crawler indexing:
| Check | Criteria |
|-------|----------|
| Static HTML | Content rendered in static HTML, not behind JavaScript |
| 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 in HTML | Schema markup in static HTML, not JS-injected |
| Page size | Reasonable page size within AI crawler limits |
Scoring:
crawler policies match the site's stated goals
check needs review
unintentionally blocked
Evaluate the post for each AI platform's citation preferences:
current logs or tooling before claiming a citation window.
indexable, and eligible for snippets. No special GEO/AEO markup or llms.txt is
required for Google visibility.
claims with dated source blocks.
eligibility, clear page purpose, accessible text, and consistency between
visible content and structured data.
policy intentionally allows or blocks each crawler where documented.
results are available.
For each platform, provide:
For each H2 section in the post, write a citation capsule:
Example:
According to [Source], [specific claim with number]. This represents
[context/comparison], making it [significance]. [Supporting detail
that reinforces the claim].
Generate one capsule per H2 section. Label each with the section heading
it belongs under.
Map the 15-point subcategory scores to a 0-100 display score:
| Category | Raw Points | Display Weight | Max Display Score |
|----------|-----------|----------------|-------------------|
| Passage-Level Citability | /4 | x6.75 | 27 |
| Q&A Formatting | /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:
Output the following report:
## AI Citation Readiness Report: [Title]
**AI Citation Readiness Score: [X]/100**: [Rating]
### Score Breakdown
| Category | Raw | Display | Max |
|----------|-----|---------|-----|
| Passage-Level Citability | X/4 | X | 27 |
| Q&A Formatting | 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) | Word Count | Self-Contained | Claim+Evidence | Citable |
|---------------|-----------|----------------|----------------|---------|
| [heading] | [N] | 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]
### Generated Citation Capsules
#### [H2 Section 1]
> [40-60 word citation capsule]
#### [H2 Section 2]
> [40-60 word citation capsule]
### 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.
If blog-google credentials include Tier 1 (GSC) and the post has a published URL:
python3 skills/blog-google/scripts/run.py gsc_query --property <property> --dimensions query,page --json
python3 skills/blog-google/scripts/run.py gsc_inspect <url> --jsonSKIPPED: credentials unavailable orSKIPPED: unpublished URL.
For a per-engine likelihood that the post gets cited by AI answer engines (distinct
from the 15-point AI Citation Readiness category scored by /blog analyze), run:
python3 scripts/ai_citation_score.py <file> --format markdown
It returns a 0-100 overall score plus per-engine subscores for Google AI Overview,
Perplexity, and ChatGPT, a factor breakdown, and up to three highest-impact fixes.
Take agricidaniel/blog-geo from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.