Where are the research reports saved?

Research findings are automatically saved to a standardized directory structure within 'rpi/tasks/' for team-wide accessibility.

How does it handle large repositories?

It uses specialized parallel sub-agents—locators and analyzers—to search and process different parts of the codebase concurrently for maximum efficiency.

How are code references handled?

The skill generates GitHub permalinks using the current commit hash and line numbers to ensure you can jump directly to the source code.

Does this skill modify my code?

No, this skill is strictly restricted to documenting and explaining the codebase as it exists today; it does not suggest improvements or refactors unless requested.

Can it search external documentation?

Yes, it can spawn a web-researcher agent if you explicitly request information from external documentation or resources.

Codebase Research & Mapping

Name: Codebase Research & Mapping
Author: mshuffett

bymshuffett

0•

Learning & Documentation

Conducts comprehensive, parallelized research across your codebase to document system architecture and implementation patterns.

This skill empowers Claude to perform deep-dive technical research by spawning specialized sub-agents that concurrently locate files, analyze logic, and identify architectural patterns. It focuses exclusively on documenting the 'as-is' state of a repository, generating structured research reports with GitHub permalinks and detailed component maps. It is particularly useful for developers who need to understand complex systems, onboard to new repositories, or document existing features before starting a new development task.

Key Features

01Parallel sub-agent execution for multi-threaded codebase analysis

02Strict documentation-only mode to prevent unwanted code modifications

030 GitHub stars

04Automated generation of structured Markdown research reports

05Context-aware pattern discovery across complex directory structures

06GitHub permalink generation for direct code and file referencing

Use Cases

01Onboarding to a new project or large-scale legacy codebase

02Technical mapping of existing system architecture for audits

03Gathering comprehensive context for complex Jira or GitHub issues

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles create-research

For use in Claude.ai and ChatGPT

Download Skill