/blog

name: blog
description: >
  Full-lifecycle blog engine with 31 sub-skills, 12 templates, 100-point scoring,
  and 5 agents. Routes requests to the right sub-skill: writing, rewriting,
  analysis, outlines, audits, schema, charts, images, repurposing, AI citation
  SEO, FLOW prompts, topic clusters, and multilingual publishing. Optimized for
  Google rankings, E-E-A-T, and AI citations. Supports any platform. Use when
  the user asks to create, revise, analyze, plan, translate, localize, audit, or
  repurpose blog content, or invokes a /blog subcommand. Do not activate merely
  because the word "blog" appears in an unrelated coding, theme-debugging,
  database, log-analysis, or definition request.
license: MIT
compatibility: Requires Claude Code and Python 3.11+ for quality scoring
metadata:
  author: AgriciDaniel
  version: "2.3.2"
user-invocable: true
argument-hint: "[write|rewrite|analyze|brief|calendar|cannibalization|strategy|outline|seo-check|schema|repurpose|geo|image|audit|factcheck|persona|brand|discourse|taxonomy|notebooklm|audio|google|update|cluster|multilingual|translate|localize|locale-audit|flow|style|decay] [topic-or-file]"

Blog: Content Engine for Rankings & AI Citations

Bundled paths below use host Markdown substitution of `${CLAUDE_SKILL_DIR}`; it is not an exported shell variable. Resolve them before execution, quote paths, and refuse nonabsolute overrides. Pass `blog_reference_root` resolved from `${CLAUDE_SKILL_DIR}/../blog/references`, `blog_template_root` from `${CLAUDE_SKILL_DIR}/../blog/templates`, and needed sibling roots to agents. Read the main reference `orchestration-details.md` before loading project context; pass only its helper-fenced output to downstream agents.

**Shell argument rule (all sub-skills).** Pass model-written or user-supplied text (titles, tags, questions, narration, URLs) to a command only as a single-quoted argument, writing an embedded `'` as `'\''`, or through a `--text-file`/`--topic-file` option where the script has one. Never put such text inside double quotes, and always quote URL placeholders. Examples in this suite use `'<placeholder>'` for these arguments.

Full-lifecycle blog management: strategy, briefs, outlines, writing, analysis, optimization, schema generation, repurposing, and editorial planning. Use foundational Google Search guidance and evidence-supported AI citation practices for platforms such as ChatGPT, Perplexity, Google AI Overviews and Gemini. Load the reviewed currentness references for named updates and product changes; neither timing nor local readiness scores prove ranking or citation outcomes.

Quick Reference

| Command | What it does | |---------|-------------| | `/blog write <topic>` | Write a new blog post from scratch | | `/blog rewrite <file>` | Rewrite/optimize an existing blog post | | `/blog analyze <file-or-url>` | Score one post (or a folder of posts) 0-100 with prioritized fixes | | `/blog brief <topic>` | Generate a detailed content brief | | `/blog calendar [monthly\|quarterly] [niche]` | Generate an editorial calendar | | `/blog strategy <niche>` | Blog strategy and topic ideation | | `/blog outline <topic>` | Generate SERP-informed content outline | | `/blog seo-check <file>` | Post-writing SEO validation checklist | | `/blog schema <file>` | Generate JSON-LD schema markup | | `/blog repurpose <file>` | Repurpose content for other platforms | | `/blog geo <file>` | AI citation readiness audit | | `/blog audit [directory]` | Site-wide health: scores plus orphans, cannibalization, stale content, schema | | `/blog cannibalization [dir]` | Detect keyword cannibalization across posts | | `/blog factcheck <file>` | Verify statistics against cited sources | | `/blog image [generate\|edit\|setup]` | AI image generation and editing via Gemini | | `/blog persona [create\|list\|use\|show]` | Manage writing personas and voice profiles | | `/blog brand [init\|show\|update]` | Generate BRAND.md + VOICE.md context files auto-loaded by all sub-skills | | `/blog discourse <topic>` | Research what people are actually saying about a topic in last 30 days; produces DISCOURSE.md (v1.8.0, API-free) | | `/blog taxonomy [suggest\|sync\|audit]` | Tag/category management across CMS platforms | | `/blog notebooklm [ask\|discover\|library\|setup\|status\|cleanup]` | Query NotebookLM for source-grounded research | | `/blog audio [generate\|voices\|setup]` | Generate audio narration of blog posts | | `/blog google [command] [args]` | Google API data: PSI, CrUX, GSC, GA4, NLP, YouTube, Keywords | | `/blog update <file>` | Update existing post with fresh stats (routes to rewrite) | | `/blog cluster [plan\|execute] <seed-or-plan>` | Semantic topic-cluster planning + execution (hub and spoke) | | `/blog multilingual <topic> --languages <codes>` | Write + translate + localize + emit hreflang in one command | | `/blog translate <file> --to <codes>` | SEO-optimized translation with format preservation | | `/blog localize <file> --locale <code>` | Cultural deep-adaptation (DACH, FR, ES, JA, custom) | | `/blog locale-audit <directory>` | Multilingual content QA (completeness, hreflang, parity, freshness) | | `/blog flow [find\|optimize\|win\|prompts\|sync]` | FLOW framework prompts (evidence-led, 30 blog-applicable) | | `/blog style learn <paths>` | Learn author voice profile from 5-10 posts (feeds blog-write and blog-persona) | | `/blog decay <current-gsc> <previous-gsc>` | Detect content decay: flag 20%+ QoQ traffic decline from GSC exports |

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)
• `canni