Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Keyword Research — measured AI agent skill | DecimalAI

itamarzand88/keyword-research

SkillScore91Maintained

Use when the user asks to "find keywords", "挖词", or "搜什么词"; prioritizes search volume, keyword difficulty, intent, and topic clusters from provided or connected data. Not for competitor-relative coverage gaps — use content-gap-analysis. 关键词研究/内容选题

by itamarzand88

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Marketing & Content pack

decimalai skills pull itamarzand88-keyword-research

Get this skill — curl · raw file

curl -fsSL https://app.decimal.ai/s/itamarzand88-keyword-research/SKILL.md

Raw file: /s/itamarzand88-keyword-research/SKILL.md ↗ · machine-readable summary at /s/itamarzand88-keyword-research.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 2d ago

Yes — +55% lift · at higher cost+51% tokens0% turns91% of whole cases pass with skill (20/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-09	✗→✓	▲ Improved	67%	0%
case-01	✗→✓	▲ Improved	21%	0%
case-02	✗→✓	▲ Improved	41%	0%
case-03	✗→✓	▲ Improved	28%	0%
case-07	✗→✓	▲ Improved	36%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/2/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

itamarzand88 / awesome-agent-conventions

conventions/skill-md/examples/content-comms/seo-keyword-research/SKILL.md

View on GitHub ↗

License Apache-2.0Imported 8/2/2026Version v1

Skill contents

SKILL.md

Keyword Research

Discovers, scores, and clusters keywords for SEO and GEO planning.

Quick Start

Research keywords for [topic/product/service]

What keywords is [competitor URL] ranking for that I should target?

Skill Contract

Expected output: a prioritized keyword brief plus the standard handoff summary for memory/research/.

Reads: topic or seed keyword, target market/language, business goal, site DR, and any user-provided or tool metrics.
Writes: a user-facing research deliverable and reusable summary.
Promotes: durable keyword priorities, competitor facts, and pending strategy decisions to memory/hot-cache.md, memory/open-loops.md, and memory/research/.
Done when: every shortlisted keyword carries volume + difficulty + intent (or a labeled N/A); keywords are grouped into pillar + cluster hubs; and the deliverable names at least 3 prioritized Quick Win / Growth / GEO opportunities.
Primary next skill: competitor-analysis when the keyword set is ready for market comparison.

Handoff Summary

> Emit the standard shape from skill-contract.md §Handoff Summary Format.

Data Sources

Optional integrations: ~~SEO tool, ~~search console. Without tools, ask for seed keywords, audience, goals, and any known metrics. See CONNECTORS.md.

Zero-dependency local helper (no tool needed): python3 scripts/connectors/suggest.py "<seed>" --expand harvests free keyword ideas from Google Autocomplete (⚠️ unofficial endpoint). Search volume / difficulty still needs ~~SEO tool or own Search Console data. See scripts/connectors/README.md.

Instructions

When a user requests keyword research, run eight phases and announce each as [Phase X/8: Name]:

Scope — clarify product, audience, business goal, DR, geography, and language.
Discover — seed from core, problem, solution, audience, and industry terms.
Variations — expand with modifiers and long-tail patterns.
Classify — tag by intent (informational, navigational, commercial, transactional).
Score — assign difficulty (1-100) and compute Opportunity = (Volume × Intent Value) / Difficulty, with Intent Value 1 / 1 / 2 / 3.
GEO-Check — flag AI-answer-friendly queries such as questions, definitions, comparisons, lists, and how-tos.
Cluster — group keywords into pillar + cluster topic hubs.
Deliver — output an Executive Summary, Quick Wins / Growth / GEO opportunities, Topic Clusters, Content Calendar, and Next Steps.

Label every metric Measured (tool/export), User-provided, or Estimated (model inference); never present an estimate as measured; if a required metric is unavailable, mark it N/A — do not invent it.

Quality bar: every recommendation includes at least one specific number. Rewrite generic advice into a concrete keyword + volume + difficulty + reason.

> Reference: See references/instructions-detail.md for the full 8-phase templates, expansion patterns, intent table, difficulty tiers, opportunity matrix, GEO indicators, cluster template, actionable-vs-generic examples, and advanced usage.

Example

Example outcome: 150+ keywords analyzed, 23 high-priority opportunities, ~45K/month traffic potential across 3 focus areas. See the full sample in references/example-report.md.

Advanced Usage

Intent mapping, seasonal analysis, competitor gaps, and local keyword workflows live in references/instructions-detail.md.

Tips for Success

Start with seeds, respect intent, cluster tightly, prioritize quick wins, and review quarterly. Full notes live in references/instructions-detail.md.

Save Results

Write path: memory/research/keyword-research/YYYY-MM-DD-<topic>.md; promote durable keyword priorities to memory/hot-cache.md. See Skill Contract §Save Results Template.

Reference Materials

Instructions Detail — Workflow, scoring, cluster template, advanced usage
Keyword Intent Taxonomy — Intent signals and content mapping
Topic Cluster Templates — Pillar and cluster patterns
Keyword Prioritization Framework — Scoring and prioritization rules
Example Report — Worked sample

Next Best Skill

Primary: competitor-analysis. Also: content-gap-analysis and serp-analysis.

Want to see if itamarzand88/keyword-research would activate on your phrasing? Try it before you install — no LLM call, no signup.

Other measured skills in the registry, with their headline benchmark lift.