Blog -- Content Engine for Rankings & AI Citations

Full-lifecycle blog management: strategy, briefs, outlines, writing, analysis, optimization, schema generation, repurposing, and editorial planning. Dual-optimized for Google's December 2025 Core Update and AI citation platforms (ChatGPT, Perplexity, Google AI Overviews, Gemini).

Quick Reference

Orchestration Logic

Command Routing

1. Parse the user's command to determine the sub-skill
2. If no sub-command given, ask which action they need
3. Route to the appropriate sub-skill:
   • write → blog-write (new articles from scratch)
   • rewrite → blog-rewrite (optimize existing posts)
   • analyze → blog-analyze (quality scoring)
   • brief → blog-brief (content briefs)
   • calendar / plan → blog-calendar (editorial calendars)
   • cannibalization → blog-cannibalization (keyword overlap detection)
   • factcheck → blog-factcheck (statistics and source verification)
   • strategy / ideation → blog-strategy (positioning and topics)
   • outline → blog-outline (SERP-informed outlines)
   • persona → blog-persona (writing voice and style management)
   • seo-check / seo → blog-seo-check (SEO validation)
   • schema → blog-schema (JSON-LD generation)
   • repurpose → blog-repurpose (cross-platform content)
   • taxonomy → blog-taxonomy (tags, categories, CMS sync)
   • geo / aeo / citation → blog-geo (AI citation audit)
   • audit / health → blog-audit (site-wide assessment)
   • image → blog-image (AI image generation and editing)
   • notebooklm / notebook / query-notebook → blog-notebooklm (source-grounded notebook queries)
   • audio / narrate / tts → blog-audio (audio narration generation)
   • google / gsc / psi / pagespeed / crux / cwv → blog-google (Google API data and reports)
   • update → blog-rewrite (with freshness-update mode)

Platform Detection

Detect blog platform from file extension and project structure:

Adapt output format to detected platform. Default to standard markdown if unknown.

Core Methodology -- The 6 Pillars

Every blog post targets these 6 optimization pillars:

Quality Gates

These are hard rules. Never ship content that violates them:

Scoring Methodology

Blog quality is scored across 5 categories (100 points total):

Scoring Bands

Reference Files

Load on-demand as needed (12 references):

• references/google-landscape-2026.md -- December 2025 Core Update, E-E-A-T, algorithm changes
• references/geo-optimization.md -- GEO/AEO techniques, AI citation factors
• references/content-rules.md -- Structure, readability, answer-first formatting
• references/visual-media.md -- Image sourcing (Pixabay, Unsplash, Pexels), AI image generation, SVG chart integration
• references/quality-scoring.md -- Full 5-category scoring checklist (100 points)
• references/platform-guides.md -- Platform-specific output formatting (9 platforms)
• references/distribution-playbook.md -- Content distribution strategy (Reddit, YouTube, LinkedIn, etc.)
• references/content-templates.md -- Content type template index (12 templates)
• references/eeat-signals.md -- Author E-E-A-T requirements, Person schema, experience markers
• references/ai-crawler-guide.md -- AI bot management, robots.txt, SSR requirements
• references/schema-stack.md -- Complete blog schema reference (JSON-LD templates)
• references/internal-linking.md -- Link architecture, anchor text, hub-and-spoke model
• references/video-embeds.md -- YouTube video embedding patterns, quality criteria, VideoObject schema

Content Templates

12 structural templates for different content types. Auto-selected by blog-write and blog-brief:

Templates are in templates/ and contain section structure, markers, and checklists.

Sub-Skills

Agents

Agent Details

blog-researcher: Runs as a Task subagent. Uses WebSearch to find current statistics, competitor content, and SERP analysis. Outputs structured research packets with source tier classifications (Tier 1: primary research, Tier 2: major publications, Tier 3: reputable industry sources). Also sources Pixabay/Unsplash/Pexels image URLs.

blog-writer: Receives research packets and content briefs. Writes content using the selected template structure. Applies answer-first formatting, citation capsules, and TL;DR blocks. Outputs platform-formatted content ready for the SEO agent.

blog-seo: Post-writing validation agent. Checks title tag length (50-60 chars), meta description (150-160 chars), heading hierarchy, keyword density, internal link count, image alt text, and Open Graph meta tags. Returns pass/fail checklist.

blog-reviewer: Final quality gate. Runs the full 5-category 100-point scoring rubric. Detects AI-generated content patterns (repetitive sentence starters, hedge words, over-qualification). Outputs a scorecard with category breakdowns and prioritized improvement recommendations.

Execution Flow

Standard execution order for /blog write:

1. Parse -- Identify topic, detect platform, select template
2. Research -- Spawn blog-researcher agent for statistics, sources, SERP data
3. Outline -- Build section structure from template + research gaps
4. Write -- Spawn blog-writer agent with research packet and outline
5. Optimize -- Spawn blog-seo agent for on-page validation
6. Score -- Spawn blog-reviewer agent for 100-point quality audit
7. Deliver -- Output final content with scorecard and improvement notes

For /blog analyze, only steps 1 and 6 run (read + score). For /blog audit, step 6 runs in parallel across all posts in the directory.

Internal Workflows (Not User-Facing Commands)

The blog-chart sub-skill is invoked internally by blog-write and blog-rewrite when chart-worthy data is identified. It is not a standalone slash command.

The blog-image sub-skill is both user-invocable (/blog image generate) and callable internally by blog-write and blog-rewrite when AI-generated images are needed (requires nanobanana-mcp configured). Falls back gracefully when MCP is not available.

The blog-notebooklm sub-skill is both user-invocable (/blog notebooklm ask) and callable internally by blog-write and blog-researcher for Tier 1 research data from user-uploaded documents. Falls back gracefully when not authenticated.

The blog-audio sub-skill is user-invocable (/blog audio generate) and can be offered as an optional final step after blog-write completes. Generates summary, full-article, or two-speaker dialogue narration via Gemini TTS. Falls back gracefully when GOOGLE_AI_API_KEY is not configured.

The blog-google sub-skill is both user-invocable (/blog google pagespeed) and callable internally by blog-seo-check, blog-rewrite, blog-geo, and blog-audit for real Google performance data. Falls back gracefully when credentials are not configured. Shares config with claude-seo at ~/.config/claude-seo/google-api.json.

Integration

Chart generation is built-in - no external dependencies required for full functionality.

Optional companion skills (for deeper analysis of published pages):

• /seo - Full SEO audit of published blog pages
• /seo-schema - Schema markup validation and generation
• /seo-geo - AI citation optimization audit

Anti-Patterns (Never Do These)