research
Map an unfamiliar area of the codebase before changing it. Returns a distilled map — key files, real call flow, conventions, landmines — instead of raw file dumps. Use when starting work in code you d
SKILL.mdskills/research/SKILL.md
GitHubMap this area and return a distilled map: $ARGUMENTS
Runs in a forked explorer context, so the reading happens here and only the map returns to the main conversation. Follow the explorer's method and return format.
Scope
If the request names a specific area, map that. If it names a question ("how does auth work?"), answer the question and map only what supports the answer.
Anchor to what's actually there. If the request assumes something the code contradicts — a file that doesn't exist, a pattern that was replaced — lead with that contradiction. It is the most valuable thing you can return, and the caller is about to plan against a false premise.
Before returning, cut
- Anything the caller can infer from a filename.
- Files you opened that turned out not to matter.
- Whole-file quotes. Cite
file:lineinstead. - Generated, vendored, and lockfile content.
The map should let someone plan a change without reopening the files you read. If it doesn't, it's too thin. If it reads like a transcript of your search, it's too thick.