codebase-research
Orchestrates comprehensive codebase research by decomposing user queries into parallel sub-agent tasks and synthesizing findings. This skill should be used when users ask questions about how code works, where functionality exists, how components interact, or need comprehensive documentation of existing implementations. It focuses exclusively on documenting and explaining the codebase as it exists today.
npx skills add majiayu000/claude-skill-registry --skill codebase-research --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Codebase Research ## Overview This skill enables comprehensive codebase research through parallel sub-agent orchestration. It decomposes research questions into focused sub-tasks, executes them in parallel for efficiency, and synthesizes findings into structured research documents. ## Critical Constraint **THE ONLY JOB IS TO DOCUMENT AND EXPLAIN THE CODEBASE AS IT EXISTS TODAY.** Do NOT: - Suggest improvements unless explicitly requested - Perform uninvited root cause analysis - Propose enhancements or optimizations - Critique implementation choices or identify problems - Recommend refactoring or architectural changes DO: - Describe what exists - Explain where functionality lives - Document how components work - Map component interactions and dependencies ## Initial Response When this skill is invoked, respond: > "I'm ready to research the codebase. Please provide your research question or area of interest, and I'll analyze it thoroughly by exploring relevant components and connections." ## Available Sub-Agents ### Codebase Agents | Agent | Purpose | When to Use | |-------|---------|-------------| | `codebase-locator` | Finds files by topic/feature | Need to locate all files rela
- Overview
- Critical Constraint
- Initial Response
- Available Sub-Agents
- Codebase Agents
- Documentation Agents
- External Research
- Research Workflow
- Step 1: Read Mentioned Files
- Step 2: Analyze and Decompose
- Step 3: Spawn Parallel Sub-Agents
- Step 4: Await and Compile Results
- Step 5: Generate Research Document
- Step 6: Present Findings
What does the codebase-research skill do?
Orchestrates comprehensive codebase research by decomposing user queries into parallel sub-agent tasks and synthesizing findings. This skill should be used when users ask questions about how code works, where functionality exists, how components interact, or need comprehensive documentation of existing implementations. It focuses exclusively on documenting and explaining the codebase as it exists today.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill codebase-research --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.