blog-geo
AI citation readiness audit ONLY (does not touch Google rankings, use blog-rewrite for combined Google+AI work). Use whenever the user wants their content to rank in ChatGPT, Perplexity, Claude, Gemini, or Google AI Overviews. AI citation optimization audit scoring blog posts for ChatGPT, Perplexity, and Google AI Overview citability. 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".
What this skill does
# 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: | 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. - 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: | 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:** - 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 | |-------|----------| | TL;DR box | 40-60 word standalone summary present at top | | Comparison tables | Tables with proper HTML `<thead>` (47% higher citation rate) | | 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:** - 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 | |-------|----------| | Static HTML | Content rendered in static HTML, not behind JavaScript | | robots.txt | Allows AI crawlers: GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot | | Schema in HTML | Schema markup in static HTML, not JS-injected | | Page size | Reasonable 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: | 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: - 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
Related in AI Agents
skill-development
IncludedComprehensive meta-skill for creating, managing, validating, auditing, and distributing Claude Code skills and slash commands (unified in v2.1.3+). Provides skill templates, creation workflows, validation patterns, audit checklists, naming conventions, YAML frontmatter guidance, progressive disclosure examples, and best practices lookup. Use when creating new skills, validating existing skills, auditing skill quality, understanding skill architecture, needing skill templates, learning about YAML frontmatter requirements, progressive disclosure patterns, tool restrictions (allowed-tools), skill composition, skill naming conventions, troubleshooting skill activation issues, creating custom slash commands, configuring command frontmatter, using command arguments ($ARGUMENTS, $1, $2), bash execution in commands, file references in commands, command namespacing, plugin commands, MCP slash commands, Skill tool configuration, or deciding between skills vs slash commands. Delegates to docs-management skill for official documentation.
reprompter
IncludedTransform messy prompts into well-structured, effective prompts — single or multi-agent. Use when: "reprompt", "reprompt this", "clean up this prompt", "structure my prompt", rough text needing XML tags and best practices, "reprompter teams", "repromptception", "run with quality", "smart run", "smart agents", multi-agent tasks, audits, parallel work, anything going to agent teams. Don't use when: simple Q&A, pure chat, immediate execution-only tasks. See "Don't Use When" section for details. Outputs: Structured XML/Markdown prompt, quality score (before/after), optional team brief + per-agent sub-prompts, agent team output files. Success criteria: Single mode quality score ≥ 7/10; Repromptception per-agent prompt quality score 8+/10; all required sections present, actionable and specific.
adaptive-compaction
IncludedAdaptive add-on policy and recovery layer that decides WHEN to compact, prune, snapshot, or fork -- replacing fixed-percent auto-compaction across Claude Code, Codex, and MCP-capable hosts. Trigger on auto-compact timing or damage: "when should I compact", "is it safe to compact now or start a fresh session", "auto-compact fires too early/mid-task", "switching to an unrelated task but the window still has space", "context rot", "answers get worse the longer the session runs", "the agent forgot the plan or my decisions after it summarized", "add a layer on top that manages context without changing the agent", raising autoCompactWindow to give the policy room, or installing/tuning a cross-tool compaction policy or PreCompact hook -- even when "compaction" is never said but the problem is context-window pressure or post-summarization memory loss. Do NOT use to summarize a conversation, build RAG, write a summarization prompt (decides WHEN not HOW), or answer max-context-length trivia.
agent-skill-creator
IncludedCreate cross-platform agent skills from workflow descriptions. Activates when users ask to create an agent, automate a repetitive workflow, create a custom skill, or need advanced agent creation. Triggers on phrases like create agent for, automate workflow, create skill for, every day I have to, daily I need to, turn process into agent, need to automate, create a cross-platform skill, validate this skill, export this skill, migrate this skill. Supports single skills, multi-agent suites, transcript processing, template-based creation, interactive configuration, cross-platform export, and spec validation.
llm-wiki
IncludedUse when building or maintaining a persistent personal knowledge base (second brain) in Obsidian where an LLM incrementally ingests sources, updates entity/concept pages, maintains cross-references, and keeps a synthesis current. Triggers include "second brain", "Obsidian wiki", "personal knowledge management", "ingest this paper/article/book", "build a research wiki", "compound knowledge", "Memex", or whenever the user wants knowledge to accumulate across sessions instead of being re-derived by RAG on every query.
skill-master
IncludedAgent Skills authoring, evaluation, and optimization. Create, edit, validate, benchmark, and improve skills following the agentskills.io specification. Use when designing SKILL.md files, structuring skill folders (references, scripts, assets), ingesting external documentation into skills, running trigger evals, benchmarking skill quality, optimizing descriptions, or performing blind A/B comparisons. Keywords: agentskills.io, SKILL.md, skill authoring, eval, benchmark, trigger optimization.