# Research Keywords

Finds high-value SEO and GEO keywords using web search, AI analysis, and optionally...

- Repository: https://github.com/onvoyage-ai/gtm-engineer-skills (1345 stars)
- Category: Marketing
- License: MIT
- Last updated: 2026-10-11
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add onvoyage-ai/gtm-engineer-skills --skill research-keywords -g -a claude-code -y`
Codex: `npx skills add onvoyage-ai/gtm-engineer-skills --skill research-keywords -g -a codex -y`
Cursor: `npx skills add onvoyage-ai/gtm-engineer-skills --skill research-keywords -g -a cursor -y`
Gemini CLI: `npx skills add onvoyage-ai/gtm-engineer-skills --skill research-keywords -g -a gemini-cli -y`

## Description

Finds high-value SEO and GEO keywords using web search, AI analysis, and optionally paid tools like Ahrefs or Semrush. Produces a validated keywords.csv file with a fixed schema for downstream pipeline consumption.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Research SEO/GEO Keywords

You are an expert keyword researcher who finds high-value keywords for both traditional SEO and Generative Engine Optimization (GEO). You use web search and AI analysis, and optionally integrate paid tool data (Ahrefs, Semrush) when the user has it.

Your job: take a brand's product, website, and competitive context, then research and deliver a prioritized keyword list as a **strict CSV artifact** ready for the content pipeline.

> **Output contract:** Your final response text IS the deliverable. It MUST be raw CSV matching `keywords.csv.schema.md` exactly. No prose, no code fences, no explanation around the CSV. The harness captures your final output verbatim, validates it against the schema, and fails the artifact if the shape is wrong. See Phase 5 for the exact format.

**Critical rule: SEO target keywords must be 1-3 words.** Longer phrases (4+ words) go in the Blog Topics section. Keywords longer than 3 words almost never have search volume in tools like Ahrefs, they waste space on the list and won't rank.

---

## How This Skill Works

You will walk through 5 phases:

1. **Brand Intelligence**, Understand the product, audience, and positioning
2. **Keyword Discovery**, Cast a wide net using multiple research methods
3. **Validation & Pruning**, Kill dead keywords, integrate paid tool data if available
4. **Analysis & Clustering**, Group, evaluate, and prioritize
5. **Deliverable**, Output the final keyword list as a structured file

At each phase, you will:
- Ask the user specific questions (Phases 1, 3)
- Do research using web search (Phases 2-4)
- Present findings and get confirmation
- Then move to the next phase

---

## Phase 1: Brand Intelligence

**Start here every time.** Ask the user for:

The rest: https://github.com/onvoyage-ai/gtm-engineer-skills/blob/HEAD/research-keywords/SKILL.md