Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
agricidaniel avatar

Blog Geo

  • 1.7k installs
  • 1.6k repo stars
  • Updated July 23, 2026
  • agricidaniel/claude-blog

blog-geo is a Claude skill that audits blog posts for AI citation readiness and outputs a 0-100 score plus citation capsules for developers who need ChatGPT, Perplexity, and Google AI Overview visibility.

About

blog-geo is a Claude Code skill from agricidaniel/claude-blog that runs an AI citation optimization audit on existing blog posts without changing Google organic rankings. The skill evaluates five weighted categories—passage-level citability, Q&A formatting, entity clarity, content structure, and AI crawler accessibility—mapped from 15 raw points to a 0-100 AI Citation Readiness score. It checks 120-180 word self-contained passages, question-shaped H2 headings, JSON-LD schema, robots.txt rules for GPTBot and PerplexityBot, and platform-specific patterns for ChatGPT, Perplexity, and Google AI Overviews. Developers reach for blog-geo when a draft is complete and they want GEO diagnostics, per-section citation capsules (40-60 words each), and prioritized fixes before publishing or refreshing content for LLM crawlers.

  • Generative engine optimization
  • AI citation readiness
  • Answer-friendly structure
  • Entity-focused copy
  • claude-blog GEO workflow

Blog Geo by the numbers

  • 1,701 all-time installs (skills.sh)
  • +43 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #341 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/agricidaniel/claude-blog --skill blog-geo

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1.7k
repo stars1.6k
Last updatedJuly 23, 2026
Repositoryagricidaniel/claude-blog

How do you audit blog posts for AI citation readiness?

Optimize blog posts for generative-engine and AI-answer visibility so LLM crawlers, citations, and AI overviews are more likely to surface your pages as authoritative answers.

Who is it for?

Developers and technical writers who publish long-form blog content and need a structured GEO audit before optimizing for ChatGPT, Perplexity, or Google AI Overviews.

Skip if: Developers who need combined Google SEO rewrites should use blog-rewrite instead, because blog-geo performs AI citation auditing only.

When should I use this skill?

User mentions geo, aeo, ai citation, citation audit, perplexity optimization, or wants a blog post scored for LLM citability.

What you get

AI Citation Readiness Report with 0-100 score, five-category breakdown, per-section citability table, platform recommendations, citation capsules, and priority action items.

  • AI Citation Readiness Report
  • Citation capsules per H2
  • Priority action item list

By the numbers

  • Maps 15 raw audit points to a 0-100 AI Citation Readiness display score
  • Targets 120-180 word self-contained passages and 40-60 word citation capsules
  • Evaluates 5 scoring categories: citability, Q&A format, entity clarity, structure, crawler access

Files

SKILL.mdMarkdownGitHub ↗

Blog GEO: AI Citation Optimization Audit

Scores blog posts for AI citation readiness across ChatGPT, Perplexity, and Google AI Overviews. Generates citation capsules and a 0-100 AI Citation Readiness score with platform-specific recommendations.

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-prompt, ai-detector-test, ChatGPT discovery, visibility prompts), see /blog flow optimize.

Key Research Data

Reference these benchmarks throughout the audit:

  • Only 11% of domains cited by both ChatGPT and Perplexity (Digital Bloom, domain-level)
  • 80% of LLM citations don't rank in Google's top 100 (Ahrefs)
  • Brands 6.5x more likely cited through third-party sources (AirOps)
  • 120-180 word sections get 70% more ChatGPT citations (SE Ranking, Nov 2025)
  • Comparison tables with <thead> achieve 47% higher AI citation rates (directional)
  • Content freshness: 76.4% of top citations updated within 30 days (Ahrefs, ~17M citations)

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: Passage-Level Citability (4 pts)

Check each section between headings for AI-extractable passages:

CheckCriteria
Word countEach section contains 120-180 word self-contained passages
Context independenceEach passage makes sense extracted from surrounding context
Claim structurePassages contain: specific claim + supporting evidence + source attribution
CompletenessPassage answers a question without requiring reader to read adjacent sections

Scoring: Count passages meeting all criteria vs total sections.

  • 4 pts: 80%+ sections have citable passages
  • 3 pts: 60-79%
  • 2 pts: 40-59%
  • 1 pt: 20-39%
  • 0 pts: <20%

Step 3: Q&A Formatting (3 pts)

Check heading format and answer structure:

CheckCriteria
Question headings60-70% of H2s are phrased as questions
Answer-first formatOpening paragraph under each H2 provides a direct answer
FAQ sectionDedicated FAQ section with structured question-answer pairs

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:

CheckCriteria
Canonical topicOne unambiguous primary topic per page
Consistent namingSame entity name used throughout (no confusing synonyms)
Intro statementClear topic statement in the introduction paragraph
Title-content matchTitle 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:

CheckCriteria
TL;DR box40-60 word standalone summary present at top
Comparison tablesTables with proper HTML <thead> (47% higher citation rate)
Ordered listsNumbered lists for processes and step-by-step instructions
Definition formattingKey terms formatted with clear definition patterns
Citation capsules40-60 word definitive statements in each major section

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:

CheckCriteria
Static HTMLContent rendered in static HTML, not behind JavaScript
robots.txtAllows AI crawlers: GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot
Schema in HTMLSchema markup in static HTML, not JS-injected
Page sizeReasonable page size within AI crawler limits

Scoring:

  • 2 pts: All criteria met
  • 1 pt: Most criteria met but one issue
  • 0 pts: Multiple issues blocking AI crawlers

Step 7: Platform-Specific Analysis

Evaluate the post for each AI platform's citation preferences:

ChatGPT
  • Favors "Best X" listicles (43.8% of citations)
  • Prefers well-cited, authoritative content
  • Recency matters: recent updates get priority
  • Domain authority influences citation likelihood
Perplexity
  • Favors Reddit sources (6.6% of all citations)
  • Rapid content decay: 2-3 day citation window
  • Freshness is the most critical factor
  • Community-validated content preferred
Google AI Overviews
  • Favors Google properties (23% of citations)
  • High Domain Rating strongly correlated with citation
  • Present in 49% of SERPs
  • Prefers content that already ranks well organically

For each platform, provide:

  • Current citability rating (High / Medium / Low)
  • Specific improvements to increase citation likelihood
  • Content format recommendations

Step 8: Generate Citation Capsules

For each H2 section in the post, write a citation capsule:

  • Length: 40-60 words, self-contained
  • Structure: Specific claim + data point + source attribution
  • Purpose: A passage AI could directly quote as a citation
  • Format: Present as a suggested addition the author can embed

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.

Step 9: Calculate AI Citation Readiness Score (0-100)

Map the 15-point subcategory scores to a 0-100 display score:

CategoryRaw PointsDisplay WeightMax Display Score
Passage-Level Citability/4x6.7527
Q&A Formatting/3x6.6720
Entity Clarity/3x6.6720
Content Structure/3x6.6720
AI Crawler Accessibility/2x6.513
Total/15100

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 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]

### 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.

Optional: Search Performance Context (blog-google)

If blog-google credentials include Tier 1 (GSC) and the post has a published URL:

1. Query GSC: python3 skills/blog-google/scripts/run.py gsc_query --property <property> --filter-page <url> --json 2. Add to platform-specific analysis:

  • Current impressions, clicks, CTR, average position
  • Search queries driving traffic to this URL

3. Check indexation: python3 skills/blog-google/scripts/run.py gsc_inspect <url> --json 4. Report indexation status, canonical selection, mobile usability. 5. Falls back silently if not configured.

Related skills

How it compares

Pick blog-geo for AI-only citation auditing; pair with blog-rewrite when you also need Google SEO rewrites on the same post.

FAQ

What does blog-geo score measure?

blog-geo measures AI Citation Readiness on a 0-100 scale derived from 15 raw points across passage citability, Q&A formatting, entity clarity, content structure, and AI crawler accessibility. Ratings of 90-100 indicate highly citable content; below 50 signals major restructuring

Does blog-geo change Google organic rankings?

blog-geo does not touch Google organic rankings—it performs AI citation readiness auditing only. For combined Google SEO and AI optimization, the agricidaniel/claude-blog repo directs developers to the blog-rewrite skill instead.

What artifacts does blog-geo generate?

blog-geo generates an AI Citation Readiness Report with score breakdown, per-H2 citability analysis, platform-specific tips for ChatGPT, Perplexity, and Google AI Overviews, 40-60 word citation capsules per section, and prioritized action items.

Marketing & SEOseocontentdistribution

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.