Agent skill

Keyword Cluster Builder

by MadAppGang in MadAppGang/claude-code

Techniques for expanding seed keywords and clustering by topic and intent.

MITAuto-check passedWriting & Content

Install Keyword Cluster Builder

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

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

GitHub CLI
$ gh skill install MadAppGang/claude-code 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/MadAppGang/claude-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/seo/skills/keyword-cluster-builder .claude/skills/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
keyword-cluster-builder
GitHub stars
285
Used in
1 other repo
Token cost
~674 tokens
SKILL.md length
174 words
Files
1
Skills in repo
69
Repo updated
First seen
Licence
MIT

At a glance

Techniques for expanding seed keywords and clustering by topic and intent.

  • Works in 5 steps: Extract Seed Topics: Identify main… → Group by Semantic Similarity: Keywords… → Map Intent: Assign I/C/T/N to each cluster → …
  • Building keyword lists
  • SKILL.md covers When to Use, Expansion Techniques, Clustering Algorithm and Cluster Structure, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Keyword Cluster Builder is an agent skill from MadAppGang/claude-code. Techniques for expanding seed keywords and clustering by topic and intent. Use when building keyword lists, planning content calendars, or identifying topic clusters for pillar content strategy.

Its SKILL.md is about 670 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 Writing & Content, covering Content strategy and Keyword research. The repository describes itself as: claude code plugins marketplace. The licence is MIT.

When your agent uses it

  • Building keyword lists
  • Planning content calendars
  • Identifying topic clusters for pillar content strategy

Example prompts

  • “Use the keyword-cluster-builder skill to technique for expanding seed keywords and clustering by topic and intent”
  • “/keyword-cluster-builder”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Extract Seed Topics: Identify main themes from expanded list
  2. Group by Semantic Similarity: Keywords with overlapping meaning
  3. Map Intent: Assign I/C/T/N to each cluster
  4. Identify Pillar: Highest-volume, broadest term = pillar
  5. Map Supporting: Lower-volume terms support pillar

What it can do on your machine

Read from SKILL.md and the folder at commit 6097ad4. 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

Keyword Cluster Builder loads about 674 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 174 words of instructions outside code blocks.

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

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 MadAppGang/claude-code at commit 6097ad4, republished under its MIT licence (© MadAppGang). 174 words, ~674 tokens.

Download SKILL.mdSave it as .claude/skills/keyword-cluster-builder/SKILL.md (or your agent's skills folder).
name
keyword-cluster-builder
description
Techniques for expanding seed keywords and clustering by topic and intent. Use when building keyword lists, planning content calendars, or identifying topic clusters for pillar content strategy.
plugin
seo
updated
2026-01-20

plugin: seo updated: 2026-01-20

Keyword Cluster Builder

When to Use

  • Expanding seed keywords to comprehensive lists (50-100+)
  • Grouping keywords by topic for pillar content strategy
  • Mapping keywords to funnel stages
  • Identifying content gaps in keyword coverage

Expansion Techniques

Question Modifiers
  • What is {keyword}
  • How to {keyword}
  • Why {keyword}
  • When to {keyword}
  • Where to {keyword}
Comparative Modifiers
  • {keyword} vs {competitor}
  • {keyword} alternatives
  • best {keyword}
  • {keyword} comparison
Intent Modifiers
  • {keyword} guide
  • {keyword} tutorial
  • {keyword} examples
  • {keyword} template
  • buy {keyword}
  • {keyword} pricing
Audience Modifiers
  • {keyword} for beginners
  • {keyword} for {industry}
  • {keyword} for small business
  • {keyword} for enterprise

Clustering Algorithm

  1. Extract Seed Topics: Identify main themes from expanded list
  2. Group by Semantic Similarity: Keywords with overlapping meaning
  3. Map Intent: Assign I/C/T/N to each cluster
  4. Identify Pillar: Highest-volume, broadest term = pillar
  5. Map Supporting: Lower-volume terms support pillar

Cluster Structure

PILLAR: "content marketing" (highest volume)
+-- CLUSTER: "content marketing strategy" (commercial)
|   +-- content marketing plan template
|   +-- content marketing framework
|   +-- how to create content marketing strategy
+-- CLUSTER: "content marketing examples" (informational)
|   +-- B2B content marketing examples
|   +-- content marketing case studies
|   +-- content marketing success stories
+-- CLUSTER: "content marketing tools" (commercial)
    +-- best content marketing tools
    +-- content marketing software
    +-- content marketing platforms

Intent Classification Rules

SignalIntent
"what is", "how to", "guide"Informational
"best", "vs", "review", "compare"Commercial
"buy", "price", "discount", brandTransactional
Brand name, specific productNavigational

Output Format

When generating keyword clusters, use this format:

markdown
## Keyword Cluster Report

**Seed Keyword**: {seed}
**Total Keywords**: {count}
**Clusters**: {cluster_count}

### Cluster 1: {cluster_name}
**Intent**: {intent}
**Funnel Stage**: {stage}
**Keywords**:
1. {keyword1} - {estimated_volume}
2. {keyword2} - {estimated_volume}
...

### Cluster 2: {cluster_name}
...

© MadAppGang, 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/skills/keyword-cluster-builder of MadAppGang/claude-code.

Open the folder on GitHubat commit 6097ad4

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in MadAppGang/claude-code, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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.

Keyword Cluster Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Keyword Cluster Builder this skillMadAppGang/claude-code2851 repos~674Automated safety check: PassMIT
Local Content Strategygarrettjsmith/localseoskills121—~2.8kAutomated safety check: PassMIT
Article Writingericrisco/rsc-harness180—~2.9kAutomated safety check: PassMIT
Content Brief Factorygooseworks-ai/goose-skills1.2k1 repos~3.1kAutomated safety check: PassMIT
Ink Briefjeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: NotesMIT
SEO Keyword ClusteringAgriciDaniel/claude-seo19k2 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Local Content Strategy

    garrettjsmith/localseoskills

    Build a complete local content strategy from keyword research output.

    121 GitHub stars~2.8k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Article Writing

    ericrisco/rsc-harness

    A skill your agent uses when writing one long-form article end to end — answer-first lede, question-shaped headings, plus its on-page surface (title, meta, slug, FAQ, Article/FAQPage JSON-LD) — or…

    180 GitHub stars~2.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Content Brief Factory

    gooseworks-ai/goose-skills

    Generate detailed, differentiated content briefs at scale. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~3.1k tokens
    Writing & ContentAuto-check passed
  • Ink Brief

    jeremylongshore/tons-of-skills-marketplace

    Content brief generator — takes a topic or keyword and produces a complete content brief with target keyword, search intent, recommended structure, internal link targets, word count, CTA, and…

    2.8k GitHub stars~1.2k tokensUpdated yesterday
    Writing & ContentAuto-check: notes
  • 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

More from MadAppGang/claude-code

All 69 skills in this repo
  • Content Brief

    MadAppGang/claude-code

    Content brief template and creation methodology for SEO-optimized content.

    285 GitHub starsUsed in 1 repo~959 tokens
    Auto-check passed
  • Context Detection

    MadAppGang/claude-code

    A skill your agent uses when detecting project technology stack from files/configs/directory structure, auto-loading framework-specific skills, or analyzing multi-stack fullstack projects (e.g…

    285 GitHub stars~5.4k tokensUpdated 7 mo ago
    Auto-check passed
  • Content Optimizer

    MadAppGang/claude-code

    On-page SEO optimization techniques including keyword density, meta tags, heading structure, and readability.

    285 GitHub starsUsed in 1 repo~694 tokens
    Auto-check passed
  • Serp Analysis

    MadAppGang/claude-code

    SERP analysis techniques for intent classification, feature identification, and competitive intelligence.

    285 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Agent Coordination Discipline

    MadAppGang/claude-code

    A skill your agent uses when deciding whether to launch an agent, selecting which agent to use, or coordinating multiple agents.

    285 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Agent Enforcement

    MadAppGang/claude-code

    Multi-agent orchestration enforcement for /team command. An agent skill from MadAppGang/claude-code.

    285 GitHub stars~895 tokensUpdated 7 mo ago
    Auto-check passed

Questions about Keyword Cluster Builder

What does Keyword Cluster Builder do?

Techniques for expanding seed keywords and clustering by topic and intent. Keyword Cluster Builder is an agent skill from MadAppGang/claude-code. Techniques for expanding seed keywords and clustering by topic and intent.

When should I use Keyword Cluster Builder?

Keyword Cluster Builder fits situations like: building keyword lists; planning content calendars; identifying topic clusters for pillar content strategy.

How do I install Keyword Cluster Builder in Claude Code?

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

How do I install Keyword Cluster Builder in Codex?

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

Can I use 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 MadAppGang/claude-code --skill 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/keyword-cluster-builder, .gemini/skills/keyword-cluster-builder, .github/skills/keyword-cluster-builder and .opencode/skills/keyword-cluster-builder in your project.

What does Keyword Cluster Builder need to run?

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

Does 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 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 Keyword Cluster Builder use?

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

How many tokens does Keyword Cluster Builder use?

About 674 tokens (SKILL.md is roughly 2.7k 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 Keyword Cluster Builder?

Skills that share tags, products or a category with Keyword Cluster Builder: Local Content Strategy (garrettjsmith/localseoskills, 121 stars), Article Writing (ericrisco/rsc-harness, 180 stars), Content Brief Factory (gooseworks-ai/goose-skills, 1.2k stars) and Ink Brief (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Keyword Cluster Builder?

MadAppGang (a GitHub organization) maintains it in MadAppGang/claude-code, which has 285 GitHub stars. The repository holds 69 skills in this directory. The repository was last updated on March 15, 2026.

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