seo-cluster

Groups keywords by Google SERP overlap into hub-and-spoke content cluster plans with link matrices.

4|Updated Aug 22, 2025
One-click install
npx skills add https://github.com/justin06lee/justin06lee.dev --skill seo-cluster-justin06lee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-cluster
Source: https://github.com/justin06lee/justin06lee.dev/tree/main/.gemini/skills/valhalla/skills/seo-cluster
Command: npx skills add https://github.com/justin06lee/justin06lee.dev --skill seo-cluster-justin06lee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Keyword lists built on text similarity often produce overlapping pages that cannibalize each other in search results. This Skill clusters keywords by actual Google SERP overlap, so each page targets a distinct ranking opportunity and the whole set forms a coherent content architecture. ## Core Features & Use Cases - SERP-Overlap Clustering: Expands a seed keyword into 30-50 variants, then groups them by shared top-10 Google results rather than text similarity, with intent classification and cannibalization checks. - Hub-and-Spoke Architecture: Designs a pillar page plus 2-5 spoke clusters with template selection, word count targets, and a bidirectional internal link matrix exported as JSON. - Interactive Visualization & Execution: Generates an interactive cluster-map.html, produces content briefs, or executes the plan through the claude-blog skill with resume support and a quality scorecard. - Use Case: A content marketer enters a seed keyword like "crm software" and receives a full cluster plan: one pillar guide, several spoke posts with assigned templates and keywords, an internal linking matrix, and a visual map to share with stakeholders. ## Quick Start Ask the AI to run a topic cluster plan for your seed keyword, for example: create a content cluster plan for "email marketing automation".

Frequently Asked Questions about seo-cluster

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cluster keywords for SEO content planning?

Provide a seed keyword and the skill expands it into 30-50 variants, fetches top-10 Google results for each, and groups keywords by shared SERP URLs. Keywords with 7+ shared results merge into one page; 4-6 shared results join the same cluster.

What is SERP overlap clustering vs keyword similarity clustering?

SERP overlap clustering groups keywords by how many of the same URLs Google ranks for them, reflecting real ranking behavior. Text-similarity clustering only compares wording, which can merge keywords that Google treats as entirely different intents.

Can I use DataForSEO instead of WebSearch for SERP data?

Yes. If the DataForSEO MCP is available, the skill uses serp_organic_live_advanced for SERP data and runs a cost check before each batch. If the cost check is blocked, it falls back to WebSearch automatically.

Does the skill write the actual cluster content?

Only if the claude-blog skill is installed; then it executes posts in priority order with cluster context and backward link injection. Otherwise it generates detailed content briefs for each planned post in a cluster-briefs directory.

What outputs does a topic cluster plan produce?

It writes cluster-plan.json with the full machine-readable plan, a human-readable cluster-plan.md, an interactive cluster-map.html visualization, and optionally content briefs or a post-execution scorecard measuring coverage, link density, and orphan pages.