Blog -- Content Engine for Rankings & AI Citations

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)