learn-codebase — Claude Code skill: what it does, how to install
Instructs the agent to read every source file in full before starting work. Built for onboarding on unfamiliar repositories.
npx skills add thedotmack/claude-mem --skill learn-codebase -a claude-codeWhat learn-codebase does
The skill instructs the agent to systematically read every single source file in the repository regardless of project size. This builds context before editing begins.
For large files, it instructs the agent to page through content with the Read tool using offset and limit, such as chunks of 500 lines. The run consumes tokens immediately, so expect higher upfront API usage.
What it helps with
- get up to speed on an unfamiliar repository
- load complete project context into agent memory
- page through large files in 500-line increments
Example prompts for the agent
- Learn the codebase before making any changes
- Read the codebase and get up to speed
- Prime the repository by reading all source files
How to install learn-codebase
1Skills CLI (Vercel)
npx skills add thedotmack/claude-mem --skill learn-codebase -a claude-code2Manually: put the files in place
~/.claude/skills/learn-codebase/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/learn-codebase/
1Skills CLI (Vercel)
npx skills add thedotmack/claude-mem --skill learn-codebase -a codex2Manually: put the files in place
.agents/skills/learn-codebase/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedotmack/claude-mem --skill learn-codebase -a cursor2Manually: put the files in place
.cursor/skills/learn-codebase/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedotmack/claude-mem learn-codebase2Manually: put the files in place
.github/skills/learn-codebase/SKILL.md1Skills CLI (Vercel)
npx skills add thedotmack/claude-mem --skill learn-codebase -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedotmack/claude-mem --path plugin/skills/learn-codebaseManually: put the files in place
.devin/skills/learn-codebase/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedotmack/claude-mem --skill learn-codebase -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set15
The whole set →Similar
Questions about learn-codebase
How to install learn-codebase in Claude Code?
Run npx skills add thedotmack/claude-mem --skill learn-codebase -a claude-code in your terminal.
What does learn-codebase do?
It directs the agent to thoroughly read every source file in full to build deep understanding before starting project tasks.
How does it handle large files?
It uses the Read tool with offset and limit parameters to chunk files, starting with offset: 1, limit: 500.
Source text
SKILL.md · Apache-2.0
--- name: learn-codebase description: Prime a codebase by reading every source file in full. Use when starting work on a new or unfamiliar project, or when the user asks to "learn the codebase", "read the codebase", "prime", or "get up to speed". --- # Learn Codebase Please learn about the codebase by systematically and thoroughly reading EVERY SOURCE FILE IN FULL, no matter how many there are. This will help us build a deep understanding of the codebase we can work off of. This is critical and non negotiable. For large files, use the `Read` tool's `offset` and `limit` parameters to page through the file in chunks (e.g. `offset: 1, limit: 500`, then `offset: 501, limit: 500`). ## Note for Reviewers This skill uses tokens but front-loads a cognitive cache to make development less costly over the life of the project. Please keep this in mind before deciding to warn the user over cost.
© thedotmack · Apache-2.0 · thedotmack/claude-mem