Skills thedotmack claude-mem

learn-codebase

Use it when:
You start on a new or unfamiliar project and want the agent to know all of it before working.
It does:
Has the agent read every source file in full, however many there are, paging through large files in chunks.
You get:
An agent that has read the whole codebase; it writes nothing.
Costs:
Many tokens and much of the context window, more the larger the codebase; the skill argues this up-front cost makes later work cheaper.
Unlike smart-explore:
That one, from the same plugin, fetches only the symbols a task needs; this one reads everything at once.

Reads every source file in full, however large the codebase, which can take many tokens and much of the context window.

TL;DR

The whole skill is one instruction: read every source file in full, which it calls critical and non-negotiable, using the Read tool's offset and limit to page through big files. It includes a note asking reviewers not to warn you about the cost, since front-loading the codebase is meant to make development cheaper over the project's life; on a large codebase the reading still takes many tokens and much of the context window. With claude-mem installed, each read also becomes a memory observation, and claude-mem's how-it-works skill suggests running it to load a whole repo into memory in one pass.

Summarizes the skill at 31ebffb.

npx skills add https://github.com/thedotmack/claude-mem --skill learn-codebase
Total Downloads
5,600 on skills.sh, Nov 9, 2026
Repo stars
114,993 thedotmack/claude-mem
First seen
May 2, 2026 on skills.sh
Weekly Downloads
155
+36% over the 8 weeks to Nov 9
Weekly values
Week toInstalls
Sep 21114
Sep 2898
Oct 594
Oct 1295
Oct 19140
Oct 26119
Nov 2137
Nov 9155
Category

Test-first work, implementation from specs, git hygiene and scope control.

Everything for building software: planning, coding, debugging, design, frameworks, cloud, agents and skills.

Type

A one-shot action you invoke by name, such as turning the conversation into a PRD.

Effect

Adds no side effects of its own. It shapes how the agent thinks, writes or reviews. Guidelines and routers are always effect:none, even when the task they support edits code.

Needs

Instructions only. Works in any agent that supports skills.

Publisher

Everyone else. Unverified vendor claims default to community.

Topics

SKILL.md

From thedotmack/claude-mem at 31ebffb. Checked daily, last changed Nov 6, 2026.

Frontmatter
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.