SEO Keyword Cluster Builder skill for Claude and Codex
Turns a messy keyword list into labelled topic clusters, each with a pillar page, supporting articles and a suggested title, ready to drop into a content plan.
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when a marketer or SEO has a long raw keyword export and needs it sorted into topic clusters with titles before planning content. Do not use for running keyword research from scratch or auditing a live page's rankings. Related topics: seo, marketing, data.
What it will ask you for
- Keywords (longer free text)
- Niche or industry (free text, e.g. "Personal finance")
- Grouping method (choose one: By search intent, By semantic similarity, By customer journey stage)
- Map each cluster to a content type (choose one: Yes, No)
- Output format (choose one: Markdown table, Bulleted list, JSON)
How it works
- Normalise the list by merging plurals and variants and removing duplicates, so each keyword appears once.
- Group the keywords using the chosen method and check that each cluster can be satisfied by a single page.
- Pick a head keyword per cluster and list its supporting keywords beneath it.
- Write one suggested article title per cluster that includes the head keyword.
- Assign a content type per cluster when requested and move unplaceable keywords to a leftovers list.
What you get
The clusters in the chosen format, each with a name, head keyword, supporting keywords, a suggested title and optionally a content type, followed by a short leftovers list.
What it watches out for
- Grouping by shared words instead of shared intent, which puts a buyer and a researcher on the same page.
- Making clusters so large that one page cannot cover them, which dilutes the target keyword.
- Inventing search volumes or difficulty scores that were not in the pasted data.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.