Agent skill

Keyword Clusterer

by guia-matthieu in guia-matthieu/clawfu-skills

Cluster keywords by semantic similarity and intent. An agent skill from guia-matthieu/clawfu-skills.

MITAuto-check passedMarketing & SEO

Install Keyword Clusterer

skills CLI
$ npx skills add guia-matthieu/clawfu-skills --skill keyword-clusterer -a claude-code

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

GitHub CLI
$ gh skill install guia-matthieu/clawfu-skills keyword-clusterer --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/guia-matthieu/clawfu-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-tools/keyword-clusterer .claude/skills/keyword-clusterer && 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-clusterer
GitHub stars
150
Token cost
~965 tokens
SKILL.md length
216 words
Files
3 (incl. scripts)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Cluster keywords by semantic similarity and intent. An agent skill from guia-matthieu/clawfu-skills.

  • : organizing keyword research
  • SKILL.md covers When to Use This Skill, What Claude Does vs What You…, Dependencies and Commands, plus 6 more sections
  • Runs Python scripts from its folder; calls python and pip
  • Creating content pillars

What it does

Keyword Clusterer is an agent skill from guia-matthieu/clawfu-skills. Cluster keywords by semantic similarity and intent. Use when: organizing keyword research; creating content pillars; mapping keywords to pages; identifying content gaps; grouping search intent

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/main.py`).

It sits in Marketing & SEO, covering Keyword research and Content strategy. The repository describes itself as: 172 expert marketing skills for AI agents — ClawFu MCP Server. The licence is MIT.

When your agent uses it

  • : organizing keyword research
  • Creating content pillars
  • Mapping keywords to pages
  • Identifying content gaps

Example prompts

  • “/keyword-clusterer”

Requirements

  • Python 3

What it can do on your machine

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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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 Clusterer loads about 965 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 216 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from guia-matthieu/clawfu-skills at commit 4108f5c, republished under its MIT licence (© guia-matthieu). 216 words, ~965 tokens.

Download SKILL.mdSave it as .claude/skills/keyword-clusterer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
keyword-clusterer
description
Cluster keywords by semantic similarity and intent. Use when: organizing keyword research; creating content pillars; mapping keywords to pages; identifying content gaps; grouping search intent
license
MIT
metadata.author
ClawFu
metadata.version
1.0.0
metadata.mcp-server
@clawfu/mcp-skills

Keyword Clusterer

Group keywords by semantic similarity using embeddings - turn a keyword list into an organized content strategy.

When to Use This Skill

  • Content planning - Group keywords into topic clusters
  • Site structure - Map keywords to pages
  • Intent analysis - Categorize by search intent
  • Gap analysis - Find missing keyword themes
  • PPC organization - Group keywords for ad groups

What Claude Does vs What You Decide

Claude DoesYou Decide
Structures analysis frameworksStrategic priorities
Synthesizes market dataCompetitive positioning
Identifies opportunitiesResource allocation
Creates strategic optionsFinal strategy selection
Suggests implementation approachesExecution decisions

Dependencies

bash
pip install scikit-learn sentence-transformers pandas click
# For simpler usage without ML:
pip install click pandas

Commands

Cluster Keywords
bash
python scripts/main.py cluster keywords.csv --n-clusters 10
python scripts/main.py cluster keywords.csv --column keyword --n-clusters 15
Find Similar
bash
python scripts/main.py similar "content marketing" --count 20
Analyze Intent
bash
python scripts/main.py intent keywords.csv --column keyword

Examples

Example 1: Cluster Keyword Research
bash
# Input: keywords.csv with 500 keywords
python scripts/main.py cluster keywords.csv --n-clusters 12 --output clustered.csv

# Output:
# Cluster 1 (45 keywords): "content marketing"
#   - content marketing strategy
#   - content marketing tips
#   - how to do content marketing
#
# Cluster 2 (38 keywords): "email marketing"
#   - email marketing tools
#   - best email marketing software
#   - email campaign tips
# ...
Example 2: Categorize by Intent
bash
python scripts/main.py intent keywords.csv --column keyword

# Output:
# Intent Analysis
# ──────────────────────
# Informational: 234 (47%)
#   - how to, what is, guide, tips
# Commercial: 156 (31%)
#   - best, top, review, compare
# Transactional: 78 (16%)
#   - buy, price, discount, order
# Navigational: 32 (6%)
#   - login, contact, brand names

Search Intent Categories

IntentSignalsContent Type
Informationalhow, what, why, guideBlog posts, guides
Commercialbest, top, review, vsComparisons, reviews
Transactionalbuy, price, discountProduct pages
Navigational[brand], login, contactLanding pages

Clustering Methods

MethodBest ForSpeed
semanticMeaning-based groupingSlower
lexicalWord overlap groupingFaster
intentSearch intent categoriesFast

Skill Boundaries

What This Skill Does Well
  • Structuring strategic analysis
  • Identifying market opportunities
  • Creating strategic frameworks
  • Synthesizing competitive data
What This Skill Cannot Do
  • Replace market research
  • Guarantee strategic success
  • Know proprietary competitor info
  • Make executive decisions

Skill Metadata

  • Mode: centaur
yaml
category: seo-tools
subcategory: keyword-research
dependencies: [scikit-learn, sentence-transformers, pandas]
difficulty: intermediate
time_saved: 5+ hours/week

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

Files

SKILL.md and 2 other files (scripts) in skills/seo-tools/keyword-clusterer of guia-matthieu/clawfu-skills.

  • SKILL.md
  • scripts/main.py
  • scripts/requirements.txt

Open the folder on GitHubat commit 4108f5c

Compare with similar skills

Keyword Clusterer 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 Clusterer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Keyword Clusterer this skillguia-matthieu/clawfu-skills150—~965Automated 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
Strategic SEO PlanningAgriciDaniel/claude-seo19k5 repos~1.1kAutomated safety check: PassMIT
Blog ClusterAgriciDaniel/claude-blog2.3k1 repos~4.9kAutomated safety check: PassMIT
SEO Content Briefseranking/seo-skills161—~2.5kAutomated safety check: PassMIT

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
  • Strategic SEO Planning

    AgriciDaniel/claude-seo

    Builds an SEO strategy for a new or existing site: discovery, competitor analysis, site architecture, content plan, technical foundation and a four-phase roadmap.

    19k GitHub starsUsed in 5 repos~1.1k tokens
    Marketing & SEOAuto-check passed
  • Blog Cluster

    AgriciDaniel/claude-blog

    Semantic topic cluster planning and automated execution engine for claude-blog.

    2.3k GitHub starsUsed in 1 repo~4.9k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief

    seranking/seo-skills

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

    161 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • SEO Keyword Research

    Varnan-Tech/opendirectory

    SEO keyword research workflow for blog generation using Google Trends data.

    674 GitHub stars~1.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from guia-matthieu/clawfu-skills

All 31 skills in this repo
  • Ab Test Stats

    guia-matthieu/clawfu-skills

    Calculate A/B test statistical significance. An agent skill from guia-matthieu/clawfu-skills.

    150 GitHub stars~1k tokensUpdated 9 days ago
    Auto-check passed
  • Cohort Analysis

    guia-matthieu/clawfu-skills

    Analyze user retention by cohort. An agent skill from guia-matthieu/clawfu-skills.

    150 GitHub stars~864 tokensUpdated 9 days ago
    Auto-check passed
  • Competitive Analysis

    guia-matthieu/clawfu-skills

    Analyze your competitive landscape using Porter's Five Forces and modern frameworks—understand industry dynamics, identify strategic opportunities, and position your business for sustainable…

    150 GitHub stars~5.2k tokensUpdated 9 days ago
    Auto-check passed
  • Competitor Monitor

    guia-matthieu/clawfu-skills

    Monitor competitor websites for changes. An agent skill from guia-matthieu/clawfu-skills.

    150 GitHub stars~815 tokensUpdated 9 days ago
    Auto-check passed
  • Content Repurposer

    guia-matthieu/clawfu-skills

    Transform long-form content into multiple short-form pieces.

    150 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed
  • Deliverability Checker

    guia-matthieu/clawfu-skills

    Check email deliverability and DNS configuration. An agent skill from guia-matthieu/clawfu-skills.

    150 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Keyword Clusterer

What does Keyword Clusterer do?

Cluster keywords by semantic similarity and intent. An agent skill from guia-matthieu/clawfu-skills. Keyword Clusterer is an agent skill from guia-matthieu/clawfu-skills. Cluster keywords by semantic similarity and intent.

When should I use Keyword Clusterer?

Keyword Clusterer fits situations like: : organizing keyword research; creating content pillars; mapping keywords to pages; identifying content gaps.

How do I install Keyword Clusterer in Claude Code?

Run `npx skills add guia-matthieu/clawfu-skills --skill keyword-clusterer -a claude-code`. Or copy the skill folder (skills/seo-tools/keyword-clusterer in guia-matthieu/clawfu-skills) into .claude/skills/keyword-clusterer in your project. Claude Code loads it when a task matches its description.

How do I install Keyword Clusterer in Codex?

Run `npx skills add guia-matthieu/clawfu-skills --skill keyword-clusterer -a codex`. Or copy the skill folder (skills/seo-tools/keyword-clusterer in guia-matthieu/clawfu-skills) into .agents/skills/keyword-clusterer in your project. Codex loads it when a task matches its description.

Can I use Keyword Clusterer 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 guia-matthieu/clawfu-skills --skill keyword-clusterer -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-clusterer, .gemini/skills/keyword-clusterer, .github/skills/keyword-clusterer and .opencode/skills/keyword-clusterer in your project.

What does Keyword Clusterer need to run?

Going by SKILL.md and its folder, Keyword Clusterer needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Keyword Clusterer access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Keyword Clusterer 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Keyword Clusterer use?

Keyword Clusterer 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 Keyword Clusterer use?

About 965 tokens (SKILL.md is roughly 3.9k 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 Clusterer?

Skills that share tags, products or a category with Keyword Clusterer: SEO Keyword Clustering (AgriciDaniel/claude-seo, 19k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 19k stars), Strategic SEO Planning (AgriciDaniel/claude-seo, 19k stars) and Blog Cluster (AgriciDaniel/claude-blog, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Keyword Clusterer?

guia-matthieu (a GitHub user) maintains it in guia-matthieu/clawfu-skills, which has 150 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 1, 2026.

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