mcpbeat

Keyword Expansion

willoscar/keyword-expansion

| Expand and refine search keywords (synonyms, acronyms, exclusions) and update `queries.md`.

405 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
496
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill keyword-expansion

The instruction itself

9 sections, as written by the author

Skill: keyword-expansion

Goal

  • Improve recall/precision of queries.md without drifting scope.

Inputs

  • queries.md
  • Optional: DECISIONS.md scope notes

Outputs

  • Updated queries.md

Procedure (MUST FOLLOW)

  • Extract the current topic scope and exclusions.
  • Propose keyword expansions (synonyms, related terms, acronyms) and add explicit exclusions for common false positives.
  • Update queries.md with a clear “why” note for each change.

Acceptance criteria (MUST CHECK)

  • [ ] queries.md contains updated keywords and excludes.
  • [ ] Changes do not contradict DECISIONS.md scope constraints.

Troubleshooting

Issue: keyword expansion causes scope drift

Fix:

  • Re-read DECISIONS.md scope notes and add explicit exclusions in queries.md for common false positives.

Issue: query count explodes and becomes unmanageable

Fix:

  • Keep a small set of high-signal queries; merge synonyms into the same query where possible instead of adding many near-duplicates.

How to use it

Copy the folder

Take willoscar/keyword-expansion from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.