blog-cluster
Semantic topic cluster planning and automated execution engine for claude-blog. Performs SERP-based keyword research, groups keywords by search intent and SERP overlap, builds a hub-and-spoke cluster architecture, generates an interactive SVG cluster map, and executes the full cluster by orchestrating blog-write calls with shared cluster context and automatic internal-link injection. Fills the strategy-to-execution gap: blog-strategy plans the blueprint, blog-cluster builds the house. Use when user says "blog cluster", "topic cluster", "content cluster", "cluster plan", "cluster execute", "pillar content", "hub and spoke", "content ecosystem", "cluster map".
AgriciDaniel · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add AgriciDaniel/claude-blog --skill blog-clusterAbout this skill
name: blog-cluster description: > Semantic topic cluster planning and automated execution engine for claude-blog. Performs SERP-based keyword research, groups keywords by search intent and SERP overlap, builds a hub-and-spoke cluster architecture, generates an interactive SVG cluster map, and executes the full cluster by orchestrating blog-write calls with shared cluster context and automatic internal-link injection. Fills the strategy-to-execution gap: blog-strategy plans the blueprint, blog-cluster builds the house. Use when user says "blog cluster", "topic cluster", "content cluster", "cluster plan", "cluster execute", "pillar content", "hub and spoke", "content ecosystem", "cluster map". license: MIT compatibility: Requires Claude Code and claude-blog (provides blog-write, blog-chart, blog-image) metadata: author: AgriciDaniel version: "1.11.0" category: blog user-invokable: true argument-hint: "[plan|execute] [seed-keyword|cluster-plan.json]"
Blog Cluster (Semantic Topic Cluster Engine)
Plans and executes entire interlinked content ecosystems from a single seed keyword. Three layers: Semantic Clustering (the brain), Cluster Architecture (the structure), and Execution Engine (the machine).
Adapted from the semantic-cluster-engine submission by Lutfiya Miller (winner, AI Marketing Hub Pro Challenge, March 2026, 95/100 Exemplary). Original repository: https://github.com/Drfiya/semantic-cluster-engine This port keeps the Plan + Execute architecture and the cluster context innovation, removes brand-specific (ScienceExperts.ai) styling and image prompts, and routes through claude-blog's existing sub-skills.
Commands
| Command | What it does |
|---|---|
/blog cluster | Interactive. Asks whether to plan or execute. |
/blog cluster plan <seed-keyword> | SERP-based semantic analysis. Outputs cluster plan + map. |
/blog cluster plan --from strategy [path] | Imports existing blog-strategy cluster build plan and validates against SERP data. |
/blog cluster execute [path-to-plan] | Sequential blog-write calls with cluster context and auto-interlinks. |
Key references (load on demand)
references/semantic-clustering.md(SERP overlap analysis, intent classification, keyword universe expansion)references/cluster-architecture.md(hub-and-spoke specs, schema strategy, link-density rules)references/execution-workflow.md(execution order, context injection, scorecard, failure handling)
Cross-references to existing claude-blog skills
| Skill | When this skill calls it |
|---|---|
/blog strategy | Upstream planning. plan --from strategy consumes its Cluster Build Plan tables. |
/blog write | Per-post execution. Each spoke and the pillar are produced by blog-write with a prepended cluster-context block. |
/blog chart | Invoked internally by blog-write for inline SVG charts. No direct call from this skill. |
/blog image | Optional hero image generation per post. Model selection is delegated to blog-image; prefer current Gemini image models when available. |
/blog seo-check | Recommended after execution for per-post on-page validation. |
/blog cannibalization | Recommended after execution to confirm zero keyword overlap across the cluster. |
/blog schema | Recommended after execution to add BreadcrumbList, ItemList, and Article schema. |
This skill never modifies files belonging to other skills. It calls them via the Task tool or as orchestrated sub-skills.
Command Routing
- Parse the user's command to determine the sub-command.
- If the user typed only
/blog cluster, ask: "Would you like to plan a new cluster or execute an existing plan?" - Route:
plan <keyword>to the Plan Phase (below)plan --from strategy [path]to the Strategy Import flow (below)execute [path],build, orrunto the Execute Phase (below)
Plan Phase: /blog cluster plan <seed-keyword>
Reference: references/semantic-clustering.md
Step 1. Seed keyword expansion
Use WebSearch to expand the seed into a keyword universe of 30 to 50 phrases:
- Direct search of
<seed>to capture related searches and "People also ask". - Long-tail expansion:
<seed> guide,<seed> tips,<seed> tools,<seed> examples,<seed> vs,best <seed>,how to <seed>. - Question mining:
what is <seed>,how does <seed> work,why <seed>,<seed> for beginners. - Intent variants: add commercial modifiers (best, top, review, comparison, pricing), informational modifiers (guide, tutorial, explained, examples), and transactional modifiers (buy, download, tool, software, service).
- Year freshness:
<seed> 2026.
Step 2. Semantic clustering
Group the expanded keywords using the priority rules in references/semantic-clustering.md:
- SERP Overlap Analysis is the primary signal. Two keywords with 4 or more shared top-10 results usually target the same intent and should be considered for one post.
- Intent Classification assigns each keyword to informational, commercial, transactional, or navigational.
- Entity Mapping identifies the people, products, frameworks, and organizations Google associates with the topic.
- Grouping combines keywords that share intent and topical proximity. Each group becomes one branch of the hub and spoke.
Step 3. Cluster architecture design
Reference: references/cluster-architecture.md
Build the hub and spoke:
- Pillar (hub): targets the broadest keyword. Word count 2,500 to 4,000. Template
pillar-page. Links down to every spoke. - Spokes: each targets a long-tail cluster. Word count 1,200 to 1,800. Template auto-selected by intent. Links up to the pillar and across to siblings.
Cluster formation rules:
- Normal mode: 2 to 5 clusters per pillar, 2 to 4 spokes per cluster, total 1 pillar plus 5 to 15 spokes.
- Small-cluster mode: for