skills/geo/SKILL.md
AI citation readiness audit. Use whenever the user wants their content to rank in ChatGPT, Perplexity, Claude, Gemini, or Google AI Overviews. Scores 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", "AI 引用", "AI 優化".
npx skillsauth add rainday/smart-blog-skills geoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
Reference these benchmarks throughout the audit:
<thead> achieve 47% higher AI citation ratesExtract 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 |
Scoring: Count passages meeting all criteria vs total sections.
| 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 |
| Check | Criteria | |-------|----------| | Canonical topic | One unambiguous primary topic per page | | Consistent naming | Same entity name used throughout | | Intro statement | Clear topic statement in the introduction paragraph |
| 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 |
| Citation capsules | 40-60 word definitive statements in each major section |
| 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 |
For each H2 section, write a citation capsule:
| Category | Raw Points | Max Display Score | |----------|-----------|-------------------| | Passage-Level Citability | /4 | 27 | | Q&A Formatting | /3 | 20 | | Entity Clarity | /3 | 20 | | Content Structure | /3 | 20 | | AI Crawler Accessibility | /2 | 13 | | Total | /15 | 100 |
Rating thresholds:
## AI Citation Readiness Report: [Title]
**AI Citation Readiness Score: [X]/100** -- [Rating]
### Score Breakdown
| Category | Raw | Display | Max |
|----------|-----|---------|-----|
### Per-Section Citability Analysis
| Section (H2) | Word Count | Self-Contained | Claim+Evidence | Citable |
### Platform-Specific Optimization
### Generated Citation Capsules
### Priority Action Items
documentation
Smart Blog 寫文章。從零寫一篇新的部落格文章,包含模板選擇、研究、 YouTube 影片嵌入、Humanizer 反 AI 審稿、品質檢查。 內建反幻覺驗證,繁體中文優先。 Use when user says "write blog", "寫文章", "寫部落格", "new blog post", "smart-blog write", "blog write".
testing
Translate existing blog posts into one or more target languages with SEO-optimized localization. Produces native-quality translations that preserve markdown structure, frontmatter, schema JSON-LD, image and chart embeds, and citation capsules. Localizes keywords, meta tags, numbers, dates, currencies, and quote styles per locale. Flags machine-translation artifacts for review. Run BEFORE localize: this handles language conversion; localize handles cultural adaptation after translation completes. Use when user says "translate blog", "blog translate", "uebersetzen", "traduire", "traducir", "translate post", "blog auf Deutsch", "blog en espanol".
development
Extract, suggest, and sync tags and categories for blog posts across all major CMS platforms. Supports WordPress REST API, Shopify GraphQL, Ghost Content API, Strapi REST/GraphQL, and Sanity GROQ. Generates tag suggestions from content analysis (keyword frequency, heading extraction, semantic grouping), enforces minimum post-count thresholds to prevent thin tag archives, and syncs taxonomy via authenticated API calls. Use when user says "tags", "categories", "taxonomy", "tag suggestions", "sync tags", "WordPress tags", "Shopify tags".
development
Blog strategy development including topic cluster architecture with hub-and-spoke design, audience mapping, competitive landscape analysis, AI citation surface strategy across ChatGPT/Perplexity/AI Overviews, distribution channel planning (YouTube, Reddit, review platforms for GEO), content scoring targets, measurement framework, and content differentiation through original research and first-hand experience. Use when user says "blog strategy", "content strategy", "blog positioning", "what should I blog about", "blog topics", "content pillars", "blog ideation".