keyword-clustering

Cluster keywords by search intent and map them to existing or proposed pages.

1.1k|103|Updated Nov 28, 2024
One-click install
npx skills add https://github.com/VladSez/easy-invoice-pdf --skill keyword-clustering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: keyword-clustering
Source: https://github.com/VladSez/easy-invoice-pdf/tree/main/.agents/skills/keyword-clustering
Command: npx skills add https://github.com/VladSez/easy-invoice-pdf --skill keyword-clustering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SEO keyword lists are often flat, unorganized collections of terms, making it hard to decide which page should target which keywords. This leads to keyword cannibalization, missed ranking opportunities, and poorly planned content. This Skill groups keywords into intent-based clusters and maps each cluster to an existing or new page.

Core Features & Use Cases

  • Intent-Based Clustering: Groups keywords by SERP intent and page type rather than lexical similarity, using SERP overlap checks for borderline terms.
  • Page Mapping: Assigns each cluster to an existing URL, a new page recommendation, or a do-not-target bucket, with per-cluster page briefs.
  • Cannibalization Detection: Identifies when multiple pages target the same intent, confirmed with real Search Console query-to-page data when connected.
  • Use Case: An SEO specialist exports 500 ranking keywords for a domain, runs the clustering workflow, and receives a mapping table showing which pages to update, which new pages to create, and where cannibalization exists.

Quick Start

Cluster my saved keyword list by search intent and map each cluster to existing or proposed pages on my site.

Frequently Asked Questions about keyword-clustering

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

FAQPage Schema
How do I cluster keywords by search intent for SEO?

Group keywords by comparing SERP intent and ranking page types rather than word similarity. Keywords sharing the same SERP results and intent belong on one page, while different intent or buyer stages should be split into separate clusters.

How to map keywords to existing pages on a website?

Start with real query data from Search Console using query and page dimensions, or pull ranked keywords for your domain. Then assign each intent cluster to the existing URL that best matches, or propose a new page when none fits.

What is keyword cannibalization and how do I detect it?

Keyword cannibalization occurs when multiple pages on one site target the same search intent, splitting rankings and clicks. Detect it by checking whether one query sends impressions to multiple URLs in Search Console performance data.

Should I cluster keywords by lexical similarity?

No, similar wording does not guarantee the same intent. SERP overlap is the reliable signal: if two keywords return similar ranking pages, they belong together; otherwise split them regardless of wording.

What should I do with very small keyword lists?

Do not over-cluster small sets. If there are fewer than 10 usable terms, produce a simple keyword-to-page map instead of a full clustering workflow with page briefs.