Teach Me

Output Directory

All teach-me data is stored under .claude/skills/teach-me/records/:

.claude/skills/teach-me/records/
├── learner-profile.md     # Cross-topic notes (created on first session)
└── {topic-slug}/
    └── session.md         # Learning state: concepts, status, notes

Slug: Topic in kebab-case, 2-5 words. Example: "Python decorators" → python-decorators

Workflow

Input → [Load Profile] → [Diagnose] → [Build Concept List] → [Tutor Loop] → [Session End]

Step 0: Parse Input

1. Extract topic. If none, use AskUserQuestion to ask what they want to learn (provide common categories as options).
2. Detect language from user input.
3. Load learner profile if .claude/skills/teach-me/records/learner-profile.md exists.
4. Check for existing session:
   • If --resume: read session.md, restore state, continue.
   • If exists without --resume: use AskUserQuestion to ask whether to resume or start fresh.
5. Create output directory: .claude/skills/teach-me/records/{topic-slug}/

Step 1: Diagnose Level

Ask 2-3 questions to calibrate understanding, all via AskUserQuestion with predefined options.

If learner profile exists, use it to skip known strengths and probe known weak areas.

If --level provided, use as hint but still ask 1-2 probing questions.

Example for "Python decorators":

Round 1 (AskUserQuestion):