What problem does it solve?
Identifies target keywords with search intent, volume, KD, and SERP feature notes; clusters them into topics; and produces a content gap analysis against current pages. Pulled by the seo specialist. TRIGGER: "do keyword research for X", "find target keywords for the new category", "build a keyword cluster map for Y", "run a content gap analysis", "identify search opportunities for the /pricing topic", "what keywords should we target for the docs hub". DO NOT TRIGGER for: on-page optimization of a specific URL (use seo-on-page-optimization), crawl / CWV / indexation audit (use seo-technical-audit), internal linking graph (use seo-internal-linking), writing the actual content (copywriter-long-form or technical-writer group), paid-search keyword lists (marketing/sales paid media, not organic SEO).
when_to_use: The parent seo specialist pulls this skill when the task requires discovering or scoping keywords before content or optimization work. Also fires on explicit user request.
Core Features & Use Cases:
- Produce a keyword list with intent labeled, clustered into topics, mapped to existing pages or content gaps. Every keyword you recommend should tie back to a business outcome — ranking alone isn't the point.
- Start from the brief: audience, product, page types, existing assets. If the brief is vague, ask before generating.
- For each candidate keyword: search volume, keyword difficulty (KD), intent (informational / navigational / commercial / transactional), SERP features (PAA, featured snippet, video, local pack), seasonality note.
- Cite data source (Ahrefs, Semrush, GSC, Keyword Planner, etc.) — never invent volumes.
- Cluster by intent + topic. A cluster is a group of keywords one page can reasonably rank for.
- Map each cluster to an existing URL or mark as a content gap. Gaps get a proposed page type.
- Flag "fit" — even a high-volume keyword is a bad bet if intent mismatches the product.
Quick Start
Provide a keyword research brief for the new category or docs hub.