When should I use keyword-expansion?

keyword-expansion is useful in the following scenarios: • Case 1: Broadening research scope for technical subjects by identifying industry-specific acronyms and synonyms to ensure all relevant sources are captured. • Case 2: Reducing search noise and 'scope drift' by defining negative keywords and exclusions for common false positives in high-volume information retrieval. • Case 3: Managing complex, long-term research projects by maintaining a structured 'queries.md' file that documents the evolution and logic of search parameters.

keyword-expansion

from WILLOSCAR

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

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

The keyword-expansion skill is designed to optimize information retrieval by systematically refining search terms. It improves search precision and recall by generating synonyms, acronyms, and explicit exclusions, ensuring comprehensive data coverage while eliminating irrelevant noise in automated research workflows.

Use Cases

Case 1: Broadening research scope for technical subjects by identifying industry-specific acronyms and synonyms to ensure all relevant sources are captured.
Case 2: Reducing search noise and 'scope drift' by defining negative keywords and exclusions for common false positives in high-volume information retrieval.
Case 3: Managing complex, long-term research projects by maintaining a structured 'queries.md' file that documents the evolution and logic of search parameters.

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

name

keyword-expansion

description

**Trigger**

keyword expansion, synonyms, exclusions, queries.md, 关键词扩展, 同义词, 排除词.

**Use when**

检索覆盖不足/噪声过大，或主题别名很多，需要系统化扩展与收敛检索词。

**Skip if**

`queries.md` 已经能稳定检出覆盖面（无需扩大范围导致后续成本爆炸）。

**Network**

none.

**Guardrail**

保持可控的 query 数量；明确 exclusions；避免“无限扩展”。

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.