teach-me

Teaches session content interactively through Socratic questioning, checklists, and quizzes.

2|Updated Sep 25, 2011
One-click install
npx skills add https://github.com/pokutuna/dotfiles --skill teach-me-pokutuna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: teach-me
Source: https://github.com/pokutuna/dotfiles/tree/main/claude/skills/teach-me
Command: npx skills add https://github.com/pokutuna/dotfiles --skill teach-me-pokutuna

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an AI-assisted coding or investigation session, users often have working code but only a shallow understanding of what was done and why. This Skill closes that gap by turning the session into a structured, interactive lesson that verifies real comprehension. ## Core Features & Use Cases - Socratic Teaching: Digs into the problem, the solution, and the broader context, repeatedly asking why until the user can explain each layer. - Progress Checklist: Maintains a Markdown checklist of concepts the user must master and tracks progress against it. - Comprehension Quizzes: Uses AskUserQuestion to run written or multiple-choice quizzes, never revealing answers before submission. - Use Case: After a pair-programming or code review session where changes were implemented for you, invoke this Skill to be taught the problem, design decisions, and edge cases until you can explain them yourself. ## Quick Start Ask the assistant to teach you what was done in this session and quiz you until you fully understand it.

Frequently Asked Questions about teach-me

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I understand code that an AI wrote for me?

Invoke this Skill after the session and it will teach you interactively. It breaks the work into the problem, the solution, and the broader context, then quizzes you on each until you can explain them yourself.

How does the Socratic teaching method work in this Skill?

The Skill first asks you to restate your current understanding, then fills the gaps step by step. It repeatedly asks why at both high level (motivation) and low level (business logic, edge cases) before moving to the next stage.

Can I ask for simpler explanations like ELI5 during the lesson?

Yes. You can request ELI5, ELI14, or explain-like-I'm-an-intern style explanations at any point. The teacher adapts the depth and can also show code or have you use a debugger.

When does the teaching session end?

The session does not end until you demonstrate understanding of every item on the checklist. At minimum this covers the problem, the chosen solution with its design decisions, and the wider context of why the change matters.

What are the limitations of an interactive teaching Skill?

It teaches only what happened in the current or recent session, so it is not a general-purpose tutor for unrelated topics. It also relies on your active participation, since comprehension is verified through your answers rather than passive reading.