research-grounding
Use when answering ANY non-trivial question or doing research in this project — ground the answer in current external sources (web state-of-the-art, GitHub prior art, official docs) instead of memory,
SKILL.md.claude/skills/research-grounding/SKILL.md
GitHubResearch Grounding
Goal: answer from current reality, not stale memory — then improve on it. Before giving a non-trivial or technical answer — especially anything about libraries, tools, versions, APIs, best practices, or "how do people do X" — consult external sources, let them shape the answer, and then push past the existing: find improvements and out-of-the-box approaches rather than just replicating prior art.
The workflow
- State of the art (web) —
WebSearchfor recent (2025–2026) best practices and comparisons;WebFetchto read the authoritative page. Search before claiming "X is the standard." - Prior art (GitHub) — use
scripts/ghx.sh(= misegh+ rtk) to look at existing implementations, popular libraries, their licenses, activity, and how the originalbishopfox/unredactersolved a problem.gh search repos/code,gh api. - Official docs — the
microsoft-docsMCP for Microsoft/Azure/.NET;claude-code-guidefor Claude Code/SDK/API questions; vendor docs viaWebFetch. Verify signatures/versions rather than guessing. - Deep questions — for broad, multi-source questions, invoke the
deep-researchskill. - Go beyond the existing (improve & innovate) — once you understand the state of the art,
don't stop at replicating it:
- Critique it — what are its limitations, costs, or outdated assumptions?
- Improve — is there a newer/faster/simpler/cheaper approach, a better library, or a way to combine ideas? Look for what the common solution misses.
- Out-of-the-box — consider novel/unconventional approaches (a different algorithm, a different data representation, a tool from an adjacent domain) that could surpass prior art.
- Recommend the best approach for the goal — even if it isn't the most common — and say why it beats the standard one.
How to apply
- Prefer up-to-date primary sources over training memory; if memory and a current source disagree, trust the source and say so.
- Compare ≥2 alternatives for any tool/library/approach choice, with the trade-off and a recommendation — and ask whether an improved or out-of-the-box option beats them all.
- Cite what you used (URLs / repos) so the answer is verifiable.
- Pin versions and check release dates — the ecosystem moves fast.
- Calibrate: skip the research for trivial or mechanical asks (rename, format, "run the tests"); spend it where a wrong/stale answer would cost real time.
Notes
- This is how every recent decision here was made (gitleaks vs trufflehog, govulncheck/gosec, syft/grype, mise backends, GPL-3.0 license check) — confirm with sources, then act.
- Tools available:
WebSearch,WebFetch,scripts/ghx.sh/gh, the microsoft-docs MCP,claude-code-guide, and thedeep-researchskill.