Agent skill

SEO Keyword Cluster Builder

by secondsky in secondsky/claude-skills

SEO keyword clustering with topic organization, content hub architecture, internal linking strategies.

MITAuto-check passedMarketing & SEO

Install SEO Keyword Cluster Builder

skills CLI
$ npx skills add secondsky/claude-skills --skill seo-keyword-cluster-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install secondsky/claude-skills seo-keyword-cluster-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/seo-keyword-cluster-builder/skills/seo-keyword-cluster-builder .claude/skills/seo-keyword-cluster-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-keyword-cluster-builder
GitHub stars
227
Token cost
~3.1k tokens
SKILL.md length
885 words
Files
1
Skills in repo
168
Repo updated
First seen
Licence
MIT

At a glance

SEO keyword clustering with topic organization, content hub architecture, internal linking strategies.

  • Works in 6 steps: Analyze Keywords → Identify Clusters → Create Architecture → …
  • Content strategy
  • SKILL.md covers Overview, When to Use, Instructions and Core Concepts, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Keyword Cluster Builder is an agent skill from secondsky/claude-skills. SEO keyword clustering with topic organization, content hub architecture, internal linking strategies. Use for content strategy, keyword research, pillar page structures, or encountering cluster organization, hub architecture, internal linking errors.

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Keyword research, Content strategy and On-page SEO. The repository describes itself as: Production-ready skills for Claude Code CLI - Cloudflare, React, Tailwind v4, and AI integrations. The licence is MIT.

When your agent uses it

  • Content strategy
  • Keyword research
  • Pillar page structures
  • Encountering cluster organization

Example prompts

  • “/seo-keyword-cluster-builder”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Analyze Keywords
  2. Identify Clusters
  3. Create Architecture
  4. Foundation (Months 1-2)
  5. Expansion (Months 3-4)
  6. Depth (Months 5-6)

What it can do on your machine

Read from SKILL.md and the folder at commit 8837836. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Keyword Cluster Builder loads about 3.1k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 885 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from secondsky/claude-skills at commit 8837836, republished under its MIT licence (© secondsky). 885 words, ~3,111 tokens.

Download SKILL.mdSave it as .claude/skills/seo-keyword-cluster-builder/SKILL.md (or your agent's skills folder).
name
seo-keyword-cluster-builder
description
SEO keyword clustering with topic organization, content hub architecture, internal linking strategies. Use for content strategy, keyword research, pillar page structures, or encountering cluster organization, hub architecture, internal linking errors.
license
MIT

SEO Keyword Cluster Builder

Overview

Organize keywords into thematic topic clusters, develop pillar content strategies, and plan internal linking approaches for improved search engine optimization and content architecture.

When to Use

  • Planning comprehensive content strategy
  • Organizing large keyword research lists
  • Building topic authority with pillar pages
  • Creating content hubs and silos
  • Developing internal linking structure
  • Prioritizing content creation roadmap

Instructions

You are an expert at SEO and content architecture. Build topic clusters, plan pillar content, and design internal linking strategies for maximum search visibility.

Common Trigger Phrases

Users typically request this skill with phrases like:

  • "Help me with [keyword organization]"
  • "Generate [content cluster plan]"
  • "Create [internal linking strategy]"
  • "Organize these keywords into topic clusters"
  • "Build a content hub architecture for [topic]"

Example Request:

"Help me organize these 30 keywords about email marketing into topic clusters and create a content hub architecture"

Response Approach

When activated, follow this process:

  1. Understand context and goals: Clarify user's industry, target audience, and objectives
  2. Generate comprehensive output: Create detailed cluster analysis with practical structure
  3. Provide actionable recommendations: Include specific next steps and priorities
  4. Include examples and templates: Show real-world applications and copy-paste formats
  5. Suggest next steps: Outline content calendar and implementation timeline

Core Concepts

Topic Clusters

A topic cluster consists of:

  • Pillar page: Comprehensive guide on broad topic (2000-4000 words)
  • Cluster content: Detailed articles on specific subtopics (800-1500 words each)
  • Internal links: Bidirectional links connecting all related content
text
                    [Pillar Page]
                  "Project Management"
                          |
        +----------------+----------------+
        |                |                |
   [Cluster 1]      [Cluster 2]     [Cluster 3]
   "PM Tools"       "PM Methods"    "PM Skills"
        |                |                |
    +--+--+          +--+--+          +--+--+
    |     |          |     |          |     |
  Sub1  Sub2      Sub1  Sub2       Sub1  Sub2
Keyword Clustering Strategy

Group keywords by:

  1. Search intent: Informational, commercial, transactional
  2. Topic similarity: Semantic relationships
  3. User journey stage: Awareness, consideration, decision
  4. Content type: How-to, comparison, definition, list

Clustering Process

Step 1: Analyze Keywords
markdown
Example keyword list:
- project management software (2.4k vol)
- best project management tools (1.8k vol)
- project management apps (1.2k vol)
- free project management software (900 vol)
- project management tools for small teams (500 vol)
Step 2: Identify Clusters

Group by semantic similarity:

Cluster 1: Software Selection
  • project management software
  • best project management tools
  • project management apps
  • top pm software
Cluster 2: Budget/Pricing
  • free project management software
  • project management software pricing
  • affordable pm tools
  • pm software cost
Cluster 3: Team Size
  • pm tools for small teams
  • enterprise project management
  • pm for startups
  • pm for large organizations
Step 3: Create Architecture
markdown
Pillar Page: "Complete Guide to Project Management Software"
├── Cluster 1: Software Selection
│   ├── Best Project Management Tools 2024
│   ├── Project Management Apps Comparison
│   └── Top PM Software Features
├── Cluster 2: Budget & Pricing
│   ├── Free Project Management Software Options
│   ├── PM Software Pricing Guide
│   └── ROI of Project Management Tools
└── Cluster 3: Team Size Solutions
    ├── PM Tools for Small Teams
    ├── Enterprise PM Solutions
    └── Scaling PM Software

Output Format

Basic Template (Minimal)

For quick results, use this concise format:

markdown
# SEO Keyword Cluster Builder Output

**Generated**: {timestamp}

---

## Results

[Your formatted output here]

---

## Recommendations

[Actionable next steps]
Detailed Template (Comprehensive)

For thorough analysis, use this expanded format:

markdown
# SEO Keyword Cluster Analysis

**Generated**: [Date]
**Total Keywords Analyzed**: [X]
**Clusters Identified**: [X]

---

## Cluster 1: [Cluster Name]

**Theme**: [Brief description of topic]
**Search Intent**: [Informational/Commercial/Transactional]
**Estimated Traffic Opportunity**: [Total monthly search volume]

### Keywords (sorted by volume)
1. [keyword] - [search volume] - [difficulty]
2. [keyword] - [search volume] - [difficulty]
3. [keyword] - [search volume] - [difficulty]

### Recommended Content

**Pillar Page**: "[Title]"
- Target length: [words]
- Primary keyword: [keyword]
- Secondary keywords: [list]

**Cluster Content** (3-5 articles):
1. **"[Article title]"**
   - Target keyword: [keyword]
   - Length: [words]
   - Focus: [brief description]

2. **"[Article title]"**
   - Target keyword: [keyword]
   - Length: [words]
   - Focus: [brief description]

### Internal Linking Strategy

```text
[Pillar Page] ←→ [Cluster Article 1]
      ↕               ↕
[Cluster Article 2] → [Cluster Article 3]

Link from Pillar to Clusters:

  • Anchor text: "[keyword phrase]"
  • Context: [where in pillar page]

Link from Clusters to Pillar:

  • Anchor text: "[broader topic phrase]"
  • Context: [intro or conclusion]

Cluster 2: [Next Cluster Name]

[Repeat structure]


Content Priority Roadmap

Phase 1: Foundation (Months 1-2)
  1. Create pillar page for Cluster 1
  2. Write top 3 cluster articles (highest volume keywords)
  3. Implement internal linking structure
Phase 2: Expansion (Months 3-4)
  1. Add remaining Cluster 1 articles
  2. Create pillar page for Cluster 2
  3. Write Cluster 2 core articles
Phase 3: Depth (Months 5-6)
  1. Add supporting content for both clusters
  2. Create comparison/versus articles
  3. Add FAQ sections for featured snippets

Implementation Checklist

Pillar Page Requirements:

  • Comprehensive coverage of topic (2000-4000 words)
  • Links to all cluster articles
  • Table of contents with anchor links
  • Target primary keyword with variations
  • Include multimedia (images, videos, infographics)
  • FAQ section for featured snippets

Cluster Article Requirements:

  • Deep dive into specific subtopic (800-1500 words)
  • Link to pillar page (contextual anchor)
  • Link to 2-3 related cluster articles
  • Target long-tail keyword
  • Include examples and actionable tips

Technical SEO:

  • Optimize meta titles and descriptions
  • Create descriptive URLs (keyword-rich slugs)
  • Add alt text to all images
  • Implement schema markup (Article/FAQ)
  • Ensure mobile responsiveness
  • Check page load speed

Show full SKILL.md (316 more words)Show less

Recommendations

Next Steps
  1. [Specific actionable step]
  2. [Specific actionable step]
  3. [Specific actionable step]
Additional Opportunities
  • [Content gap or keyword opportunity]
  • [Internal linking improvement]
  • [Topic expansion suggestion]

## Best Practices

### 1. Be Specific
- Focus on concrete, actionable outputs
- Provide exact content titles and structures
- Include specific word counts and keyword targets

### 2. Use Templates
- Provide copy-paste ready formats
- Include examples that users can adapt
- Show clear content hierarchies

### 3. Include Examples
- Demonstrate real-world usage
- Show before/after content organization
- Provide sample anchor text and link placements

### 4. Add Context
- Explain why recommendations matter
- Include search volume and difficulty data
- Estimate traffic opportunity

### 5. Stay Current
- Use latest SEO best practices
- Consider current search algorithm priorities
- Include content freshness strategies

## Common Clustering Patterns

### Pattern 1: Feature-Based

```text
Pillar: "Email Marketing Software"
├── Email Marketing Features
├── Email Marketing Automation
├── Email Marketing Analytics
└── Email Marketing Templates
Pattern 2: Problem-Solution
text
Pillar: "CRM for Small Business"
├── How to Choose a CRM
├── CRM Implementation Guide
├── CRM Best Practices
└── Common CRM Mistakes
Pattern 3: Comparison-Based
text
Pillar: "Project Management Tools Comparison"
├── Asana vs Monday.com
├── Trello vs ClickUp
├── Best Free PM Tools
└── PM Tools for Remote Teams
Pattern 4: Stage-Based
text
Pillar: "Content Marketing Guide"
├── Content Strategy Planning
├── Content Creation Process
├── Content Distribution Channels
└── Content Performance Measurement

Keyword Research Integration

Organize by Intent

Informational Intent:

  • "what is [topic]"
  • "how to [action]"
  • "[topic] guide"
  • "[topic] examples"

Commercial Intent:

  • "best [product]"
  • "[product] comparison"
  • "[product] review"
  • "top [product] for [use case]"

Transactional Intent:

  • "[product] pricing"
  • "buy [product]"
  • "[product] discount"
  • "[product] free trial"
Search Volume Tiers
markdown
High Volume (>1000/month):
- Primary pillar page targets
- High priority for content creation
- Competitive but high reward

Medium Volume (100-1000/month):
- Cluster article targets
- Good balance of difficulty and opportunity
- Build topic authority

Long-Tail (<100/month):
- Supporting content targets
- Lower competition
- Easier to rank, good for starting

Internal Linking Guidelines

Anchor Text Best Practices

Good Examples:

  • "project management best practices"
  • "how to implement agile methodology"
  • "comparison of top CRM platforms"

Bad Examples:

  • "click here" ❌ (not descriptive)
  • "this article" ❌ (no keyword context)
  • "project management project management" ❌ (stuffing)

Hub-and-Spoke Model:

text
Every cluster article links:
→ To pillar page (1 link)
→ To 2-3 related cluster articles (lateral links)
← From pillar page (receives link)

Link Frequency:

  • Pillar to cluster: 1-2 contextual links
  • Cluster to pillar: 1 link (introduction or conclusion)
  • Cluster to cluster: 2-3 related links

Content Calendar Template

markdown
| Month | Week | Content Type | Title | Target Keyword | Status |
|-------|------|--------------|-------|----------------|--------|
| Jan | 1 | Pillar | [Title] | [keyword] | Planning |
| Jan | 2 | Cluster | [Title] | [keyword] | In Progress |
| Jan | 3 | Cluster | [Title] | [keyword] | Not Started |
| Jan | 4 | Cluster | [Title] | [keyword] | Not Started |
| Feb | 1 | Cluster | [Title] | [keyword] | Not Started |

Success Metrics

Track These KPIs

Traffic Metrics:

  • Organic sessions per cluster
  • Click-through rate from search
  • Pages per session (internal link effectiveness)

Ranking Metrics:

  • Average position for target keywords
  • Number of keywords ranking in top 10
  • Featured snippet wins

Engagement Metrics:

  • Time on page
  • Bounce rate
  • Internal link click rate

Authority Metrics:

  • Backlinks to pillar pages
  • Domain authority growth
  • Social shares per cluster

Example Workflow

User Request

"Help me organize these 30 keywords about email marketing into topic clusters"

Your Response Process
  1. Analyze keywords → Identify themes
  2. Group by similarity → Create 3-4 main clusters
  3. Recommend structure → Pillar + cluster content
  4. Suggest titles → SEO-optimized content titles
  5. Plan linking → Internal link strategy
  6. Prioritize → Content creation roadmap
  7. Provide template → Formatted output ready to use

Philosophy

"Focus on delivering value quickly and clearly!"

Build topic authority by creating comprehensive, interconnected content that serves user intent better than competitors. Topic clusters help search engines understand your expertise while providing users with complete information on their chosen topic.

© secondsky, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/seo-keyword-cluster-builder/skills/seo-keyword-cluster-builder of secondsky/claude-skills.

Open the folder on GitHubat commit 8837836

Compare with similar skills

SEO Keyword Cluster Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Keyword Cluster Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Keyword Cluster Builder this skillsecondsky/claude-skills227—~3.1kAutomated safety check: PassMIT
SEO Keyword ClusteringAgriciDaniel/claude-seo19k2 repos~3.3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo19k2 repos~2.6kAutomated safety check: PassMIT
SEO Keyword Clusterseranking/seo-skills160—~2.5kAutomated safety check: PassMIT
Content Brief Authoringrampstackco/claude-skills941—~5.6kAutomated safety check: PassMIT
Ink Clusterjeremylongshore/tons-of-skills-marketplace2.8k—~1.3kAutomated safety check: NotesMIT

Similar skills

  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • SEO Keyword Cluster

    seranking/seo-skills

    Build a content cluster plan from seed keywords — intent-grouped clusters, pillar+spokes architecture with H1/H2 suggestions per spoke, prioritised build order, and an internal-linking map.

    160 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Content Brief Authoring

    rampstackco/claude-skills

    How to author a content brief that actually guides a writer (human or AI) to produce a piece that ranks, converts, or both.

    941 GitHub stars~5.6k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Ink Cluster

    jeremylongshore/tons-of-skills-marketplace

    Topic cluster architecture builder — takes a core topic and maps the full cluster with 1 pillar page, 6-10 supporting posts, internal linking map, keyword targets, and estimated monthly search…

    2.8k GitHub stars~1.3k tokensUpdated today
    Marketing & SEOAuto-check: notes
  • SEO Content Brief

    seranking/seo-skills

    Generate a writer-ready SEO content brief from a target domain and topic.

    160 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed

More from secondsky/claude-skills

All 168 skills in this repo
  • Auto Animate

    secondsky/claude-skills

    AutoAnimate (@formkit/auto-animate) zero-config animations for React.

    227 GitHub stars~2.9k tokensUpdated 11 days ago
    Auto-check passed
  • Base UI React

    secondsky/claude-skills

    MUI Base UI unstyled React components with Floating UI. An agent skill from secondsky/claude-skills.

    227 GitHub stars~1.9k tokensUpdated 11 days ago
    Auto-check passed
  • Cloudflare Images

    secondsky/claude-skills

    This skill should be used when the user asks to "upload images to Cloudflare", "implement direct creator upload", "configure image transformations", "optimize WebP/AVIF", "create image variants"…

    227 GitHub stars~3.6k tokensUpdated 11 days ago
    Auto-check: notes
  • Cloudflare Nextjs

    secondsky/claude-skills

    Deploy Next.js to Cloudflare Workers via the OpenNext adapter (@opennextjs/cloudflare).

    227 GitHub stars~5.3k tokensUpdated 11 days ago
    Auto-check: notes
  • Cloudflare Sandbox

    secondsky/claude-skills

    Cloudflare Sandboxes SDK for secure code execution in Linux containers at edge.

    227 GitHub stars~4.5k tokensUpdated 11 days ago
    Auto-check passed
  • GitHub Project Automation

    secondsky/claude-skills

    GitHub repository automation (CI/CD, issue templates, Dependabot, CodeQL).

    227 GitHub stars~4k tokensUpdated 11 days ago
    Auto-check: notes

Questions about SEO Keyword Cluster Builder

What does SEO Keyword Cluster Builder do?

SEO keyword clustering with topic organization, content hub architecture, internal linking strategies. SEO Keyword Cluster Builder is an agent skill from secondsky/claude-skills. SEO keyword clustering with topic organization, content hub architecture, internal linking strategies.

When should I use SEO Keyword Cluster Builder?

SEO Keyword Cluster Builder fits situations like: content strategy; keyword research; pillar page structures; encountering cluster organization.

How do I install SEO Keyword Cluster Builder in Claude Code?

Run `npx skills add secondsky/claude-skills --skill seo-keyword-cluster-builder -a claude-code`. Or copy the skill folder (plugins/seo-keyword-cluster-builder/skills/seo-keyword-cluster-builder in secondsky/claude-skills) into .claude/skills/seo-keyword-cluster-builder in your project. Claude Code loads it when a task matches its description.

How do I install SEO Keyword Cluster Builder in Codex?

Run `npx skills add secondsky/claude-skills --skill seo-keyword-cluster-builder -a codex`. Or copy the skill folder (plugins/seo-keyword-cluster-builder/skills/seo-keyword-cluster-builder in secondsky/claude-skills) into .agents/skills/seo-keyword-cluster-builder in your project. Codex loads it when a task matches its description.

Can I use SEO Keyword Cluster Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add secondsky/claude-skills --skill seo-keyword-cluster-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-keyword-cluster-builder, .gemini/skills/seo-keyword-cluster-builder, .github/skills/seo-keyword-cluster-builder and .opencode/skills/seo-keyword-cluster-builder in your project.

What does SEO Keyword Cluster Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Keyword Cluster Builder is instructions for the agent only.

Does SEO Keyword Cluster Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Keyword Cluster Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Keyword Cluster Builder use?

SEO Keyword Cluster Builder is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Keyword Cluster Builder use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Keyword Cluster Builder?

Skills that share tags, products or a category with SEO Keyword Cluster Builder: SEO Keyword Clustering (AgriciDaniel/claude-seo, 19k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 19k stars), SEO Keyword Cluster (seranking/seo-skills, 160 stars) and Content Brief Authoring (rampstackco/claude-skills, 941 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Keyword Cluster Builder?

secondsky (a GitHub user) maintains it in secondsky/claude-skills, which has 227 GitHub stars. The repository holds 168 skills in this directory. The repository was last updated on September 28, 2026.

Source: secondsky/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.