mcpField
K
keyword-expansion

keyword-expansion

github.com/willoscarProductivity51753 installsUpdated 4w ago
Repository

About keyword-expansion

keyword-expansion is a skill for refining `queries.md` when search coverage is weak, noisy, or affected by many aliases. It adds controlled synonyms and exclusions while preserving the topic scope.

Key features

  1. 01Expands keywords with synonyms and related terms
  2. 02Adds exclusions for likely false positives
  3. 03Records the reason for each query change
  4. 04Checks changes against `DECISIONS.md` scope

Use cases

  1. 01Improve recall when searches miss relevant material
  2. 02Reduce noise from common false positives
  3. 03Organize aliases for a topic without widening scope

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill keyword-expansion

After installing, type/keyword-expansionin Claude Code to confirm it loaded.

Details

From the project README

Skill: keyword-expansion

Triggers & routing

  • Trigger: keyword expansion, synonyms, exclusions, queries.md, 关键词扩展, 同义词, 排除词.
  • Use when: 检索覆盖不足/噪声过大，或主题别名很多，需要系统化扩展与收敛检索词。
  • Skip if: queries.md 已经能稳定检出覆盖面（无需扩大范围导致后续成本爆炸）。
  • Network: none.
  • Guardrail: 保持可控的 query 数量；明确 exclusions；避免“无限扩展”。

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)

  1. Extract the current topic scope and exclusions.
  2. Propose keyword expansions (synonyms, related terms, acronyms) and add explicit exclusions for common false positives.
  3. 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.

Comments

Markdown supported