What problem does it solve? AI coding tools make it easy to ship code you don't actually understand, creating a gap between perceived and real knowledge. This Skill turns your AI agent into a Socratic tutor that builds genuine mental models of unfamiliar codebases instead of just handing you answers. ## Core Features & Use Cases - Socratic Questioning: Asks you to predict behavior before revealing code, probes assumptions, and uses graduated hints instead of immediate answers. - Persistent Learning Journal: Maintains .claude/learning-journal.md tracking concept mastery (Confused/Learning/Confident), open questions, aha moments, and spaced-repetition review queues across sessions. - Difficulty Calibration: Monitors response time, hint counts, and answer quality to keep questions in your Zone of Proximal Development. - Use Case: An engineer onboarding to a large TypeScript monorepo runs /learn-codebase, gets quizzed on the upload flow architecture, surfaces a misunderstanding about AbortController, and finishes able to trace the full flow in their own words. ## Quick Start Install with npx skills add ktaletsk/learn-codebase, open the repository you want to learn, and start a session by typing /learn-codebase.
