Keyword Expansion

What this skill does

Keyword Expansion enhances the breadth and accuracy of your search query list by systematically identifying synonyms, related terms, and acronyms that fit within your defined topic scope. It refines `queries.md` to improve recall and precision without introducing irrelevant or off-topic results. The process also adds explicit exclusions to filter out common false positives, ensuring your keyword set remains tightly focused.

This skill balances expanding keyword coverage with maintaining strict adherence to documented scope constraints, preventing query bloat or drift. Each update to the keyword list is accompanied by clear rationale notes, supporting traceability and ongoing optimization.

Who it's for

This skill is designed for SEO specialists aiming to deepen organic reach without compromising content relevance. Growth marketers managing paid search campaigns can also leverage it to refine and expand their keyword targeting efficiently. Agency strategists responsible for multi-client keyword frameworks will find it valuable to maintain consistent scope boundaries while scaling keyword sets across industries.

Key workflows

First, the practitioner extracts the current topic scope and exclusions from `DECISIONS.md` or equivalent documentation. Next, they propose keyword expansions by identifying synonyms, acronyms, and related terms that align with the defined scope. Then, they add explicit exclusions to `queries.md` to prevent common false positives, carefully balancing inclusion and exclusion criteria. Finally, they update `queries.md` with the new keywords and exclusions, including concise notes explaining the rationale behind each change.

Common questions

How do I prevent keyword expansion from causing scope drift? Revisit the scope notes in `DECISIONS.md` and add precise exclusions to block off-topic queries. What if the number of queries becomes unmanageable? Consolidate synonyms into fewer queries instead of adding many near-duplicates to keep the list concise. Can I expand keywords without a formal scope document? It’s possible but risky; explicit scope and exclusion notes are essential to maintain precision.

How to use in Metaflow

Attach the Keyword Expansion skill to a Metaflow agent task that manages your keyword query files. The agent will analyze your current `queries.md`, propose expansions and exclusions based on your defined scope, and produce an updated query list with clear annotations. Expect the process to help you systematically grow your keyword sets while keeping them aligned with your strategic boundaries. This makes it easier to maintain control over query relevance and volume as campaigns evolve.

For broader context, see our roundup of marketing skills claude, and read Claude skills for SEO for related setup guidance.