Agent skill

SEO Aeo Keyword Research

by henryalouf in henryalouf/ruflow

Researches and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks, and a content map.

MITAuto-check passedMarketing & SEO

Install SEO Aeo Keyword Research

skills CLI
$ npx skills add henryalouf/ruflow --skill seo-aeo-keyword-research -a claude-code

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

GitHub CLI
$ gh skill install henryalouf/ruflow seo-aeo-keyword-research --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/henryalouf/ruflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/seo-aeo-keyword-research .claude/skills/seo-aeo-keyword-research && 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
seo-aeo-keyword-research
GitHub stars
157
Token cost
~1.1k tokens
SKILL.md length
559 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Researches and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks, and a content map.

  • Works in 5 steps: Extract Seed Keywords → Expand Into Tiers → Generate AEO Keywords → …
  • Wants to find keywords
  • SKILL.md covers Overview, When to Use This Skill, How It Works and Examples, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Aeo Keyword Research is an agent skill from henryalouf/ruflow. Researches and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks, and a content map. Activate when the user wants to find keywords, research search terms, or build a keyword strategy.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering AI search optimization and Keyword research. The licence is MIT.

When your agent uses it

  • Wants to find keywords
  • Research search terms
  • Build a keyword strategy

Example prompts

  • “Use the seo-aeo-keyword-research skill to research and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks…”
  • “/seo-aeo-keyword-research”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Extract Seed Keywords
  2. Expand Into Tiers
  3. Generate AEO Keywords
  4. Run Cannibalization Check
  5. Build Content Map

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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

SEO Aeo Keyword Research loads about 1.1k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 559 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from henryalouf/ruflow at commit 568d7a5, republished under its MIT licence (© henryalouf). 559 words, ~1,146 tokens.

Download SKILL.mdSave it as .claude/skills/seo-aeo-keyword-research/SKILL.md (or your agent's skills folder).
name
seo-aeo-keyword-research
description
Researches and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks, and a content map. Activate when the user wants to find keywords, research search terms, or build a keyword strategy.
risk
safe
source
community
date_added
2026-04-01

SEO-AEO Keyword Research

Overview

Identifies high-value SEO keywords and AEO question-based queries for a topic. Produces keyword tiers (easy wins to long-term goals), search intent classification, cannibalization checks, and a content production map — all from a single topic input.

Part of the SEO-AEO Engine — an open-source AI-powered content growth system.

When to Use This Skill

  • Use when you need to build a keyword strategy for a new topic or niche
  • Use when you want to find AEO question queries for AI engine citation
  • Use when you need to prioritise which keywords to target first
  • Use when you want to check for keyword cannibalization before writing content

How It Works

Step 1: Extract Seed Keywords

Identify 3–5 core terms that anchor the topic's search territory. Go beyond the obvious head term to include adjacent terms the audience actually uses.

Step 2: Expand Into Tiers

Sort all keywords into three tiers:

  • Tier 1 — Low-to-moderate difficulty. Target first.
  • Tier 2 — Medium difficulty. Build toward after Tier 1 content is live.
  • Tier 3 — High difficulty. Long-term goals only.
Step 3: Generate AEO Keywords

Produce question-based keywords that AI engines surface in direct answers and People Also Ask boxes. For each AEO keyword, specify the answer format to use (definition sentence, numbered steps, comparison table, direct number).

Step 4: Run Cannibalization Check

Flag any two keywords similar enough to split traffic if targeted on separate pages. Recommend which page should own which term.

Step 5: Build Content Map

Recommend content type and production order for all Tier 1 and Tier 2 keywords.

Examples

Example 1: SaaS Product

Input: topic = "remote project management software" audience = "engineering managers and startup founders" goal = "convert" Output: Tier 1 Keywords:

"remote project management software" | Medium volume | Difficulty: 38 "project management tool remote teams" | Low volume | Difficulty: 29

AEO Keywords:

"What is the best project management software for remote teams?" → Answer format: Comparison table "How does remote project management work?" → Answer format: Numbered steps

Content Map:

Landing page → "remote project management software" Pillar blog → "complete guide to remote project management" Cluster article → "how to manage remote engineering teams"

Show full SKILL.md (212 more words)Show less
Example 2: Fintech App

Input: topic = "automated budgeting app" audience = "millennials managing personal finances" goal = "all" Output: Tier 1 Keywords:

"automated budgeting app" | Medium volume | Difficulty: 33 "automatic savings app" | Low volume | Difficulty: 24

AEO Keywords:

"What is the best budgeting app for millennials?" → Answer format: Comparison table "How does automated budgeting work?" → Answer format: Numbered steps

Best Practices

  • ✅ Do: Target Tier 1 keywords first — build authority before going after competitive terms
  • ✅ Do: Use AEO keywords in FAQ sections and definition blocks for AI engine citation
  • ✅ Do: Validate estimated volume and difficulty with a live tool (Ahrefs, SEMrush) before committing
  • ❌ Don't: Target two keywords on the same page if cannibalization is flagged
  • ❌ Don't: Use volume as the only prioritisation signal — difficulty and intent matter more

Common Pitfalls

  • Problem: High-volume keyword chosen but impossible to rank for early on Solution: Always cross-check volume with difficulty. Tier 1 should have difficulty under 45.

  • Problem: AEO keywords ignored in favour of traditional search terms Solution: AEO keywords drive AI engine citation — include at least 5 in every research run.

  • @seo-aeo-content-cluster — uses keyword research output to build topic cluster
  • @seo-aeo-landing-page-writer — consumes primary keyword to generate landing page
  • @seo-aeo-blog-writer — uses secondary keywords for cluster article targeting

Additional Resources

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

Files

Just SKILL.md in .agents/skills/seo-aeo-keyword-research of henryalouf/ruflow.

Open the folder on GitHubat commit 568d7a5

Compare with similar skills

SEO Aeo Keyword Research 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.

SEO Aeo Keyword Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Aeo Keyword Research this skillhenryalouf/ruflow157—~1.1kAutomated safety check: PassMIT
SEO DataforseoAgriciDaniel/codex-seo7992 repos~4.6kAutomated safety check: PassMIT
Competitor GapRyze-AI-Adgent/open-seo-mcp-skills4.7k—~560Automated safety check: PassMIT
Geo DifficultyOpenClaudia/openclaudia-skills713—~694Automated safety check: PassMIT
Keyword ResearchRyze-AI-Adgent/open-seo-mcp-skills4.7k—~581Automated safety check: PassMIT
DataForSEO Live SEO DataAgriciDaniel/claude-seo19k—~4.4kAutomated safety check: PassMIT

Similar skills

  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~4.6k tokens
    Marketing & SEOAuto-check passed
  • Competitor Gap

    Ryze-AI-Adgent/open-seo-mcp-skills

    Find keywords a competitor ranks for that the user's site doesn't — the content gap, prioritized by volume and winnability.

    4.7k GitHub stars~560 tokensUpdated 17 days ago
    Marketing & SEOAuto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated today
    Marketing & SEOAuto-check passed
  • Keyword Research

    Ryze-AI-Adgent/open-seo-mcp-skills

    Keyword research from a seed topic — ideas, real Google volume/CPC, intent, difficulty, clustered into a plan.

    4.7k GitHub stars~581 tokensUpdated 17 days ago
    Marketing & SEOAuto-check passed
  • DataForSEO Live SEO Data

    AgriciDaniel/claude-seo

    Pulls live SERP results, keyword metrics, backlink profiles and AI visibility data through the DataForSEO MCP server, with a cost check before each call.

    19k GitHub stars~4.4k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed
  • Serp Analysis

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "analyze the SERP" or "SERP分析"; maps SERP features, layout, ranking factors, search intent, AI Overviews, and snippet opportunities for a query.

    2.9k GitHub starsUsed in 1 repo~2.2k tokens
    Marketing & SEOAuto-check passed

More from henryalouf/ruflow

All 13 skills in this repo
  • Agents Md

    henryalouf/ruflow

    This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise.

    157 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Claimable Postgres

    henryalouf/ruflow

    Provision instant temporary Postgres databases via Claimable Postgres by Neon (pg.new).

    157 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check: notes
  • Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval.

    157 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Train or fine-tune TRL language models on Hugging Face Jobs, including SFT, DPO, GRPO, and GGUF export.

    157 GitHub stars~6.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Train or fine-tune vision models on Hugging Face Jobs for detection, classification, and SAM or SAM2 segmentation.

    157 GitHub stars~7.4k tokensUpdated 4 mo ago
    Auto-check passed
  • SEO Aeo Blog Writer

    henryalouf/ruflow

    Writes long-form blog posts with TL;DR block, definition sentence, comparison table, and 5-question FAQ for SEO ranking and AEO citation.

    157 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about SEO Aeo Keyword Research

What does SEO Aeo Keyword Research do?

Researches and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks, and a content map. SEO Aeo Keyword Research is an agent skill from henryalouf/ruflow. Researches and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks, and a content map.

When should I use SEO Aeo Keyword Research?

SEO Aeo Keyword Research fits situations like: wants to find keywords; research search terms; build a keyword strategy.

How do I install SEO Aeo Keyword Research in Claude Code?

Run `npx skills add henryalouf/ruflow --skill seo-aeo-keyword-research -a claude-code`. Or copy the skill folder (.agents/skills/seo-aeo-keyword-research in henryalouf/ruflow) into .claude/skills/seo-aeo-keyword-research in your project. Claude Code loads it when a task matches its description.

How do I install SEO Aeo Keyword Research in Codex?

Run `npx skills add henryalouf/ruflow --skill seo-aeo-keyword-research -a codex`. Or copy the skill folder (.agents/skills/seo-aeo-keyword-research in henryalouf/ruflow) into .agents/skills/seo-aeo-keyword-research in your project. Codex loads it when a task matches its description.

Can I use SEO Aeo Keyword Research 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 henryalouf/ruflow --skill seo-aeo-keyword-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-aeo-keyword-research, .gemini/skills/seo-aeo-keyword-research, .github/skills/seo-aeo-keyword-research and .opencode/skills/seo-aeo-keyword-research in your project.

What does SEO Aeo Keyword Research need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Aeo Keyword Research is instructions for the agent only.

Does SEO Aeo Keyword Research access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is SEO Aeo Keyword Research 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. Review the folder before installing.

What licence does SEO Aeo Keyword Research use?

SEO Aeo Keyword Research is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Aeo Keyword Research use?

About 1.1k tokens (SKILL.md is roughly 4.6k 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 SEO Aeo Keyword Research?

Skills that share tags, products or a category with SEO Aeo Keyword Research: SEO Dataforseo (AgriciDaniel/codex-seo, 799 stars), Competitor Gap (Ryze-AI-Adgent/open-seo-mcp-skills, 4.7k stars), Geo Difficulty (OpenClaudia/openclaudia-skills, 713 stars) and Keyword Research (Ryze-AI-Adgent/open-seo-mcp-skills, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Aeo Keyword Research?

henryalouf (a GitHub user) maintains it in henryalouf/ruflow, which has 157 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on May 18, 2026.

Source: henryalouf/ruflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.