teach-me

Verifies user understanding of completed work through checklist-driven teaching and quizzing.

Updated Jul 17, 2026
One-click install
npx skills add https://github.com/unnxt30/skills --skill teach-me-unnxt30
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: teach-me
Source: https://github.com/unnxt30/skills/tree/main/teach-me
Command: npx skills add https://github.com/unnxt30/skills --skill teach-me-unnxt30

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a bugfix, refactor, or debugging session, users often nod along without truly understanding what changed or why. This Skill turns a completed work session into a structured teaching loop that verifies comprehension instead of assuming it. ## Core Features & Use Cases - Understanding Checklist: Creates an UNDERSTANDING.md file with granular, demonstrable items covering the problem, the solution, and the broader context. - Restate-First Teaching: Asks the user to explain each stage back before filling gaps, drilling into the whys behind every design decision. - Rigorous Quizzing: Uses fair, symmetric multiple-choice questions with shuffled answer positions and misconception-based distractors to test real mastery. - Use Case: After a tricky race-condition fix, invoke the skill to walk through why the bug existed, why the chosen solution beats the alternatives, and confirm each point via quiz before wrapping up. ## Quick Start Say "teach me what we just did in this session" to start a verified walkthrough of the completed work.

Frequently Asked Questions about teach-me

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

FAQPage Schema
How do I verify I understand what changed in a coding session?

Invoke the teach-me skill after the session. It builds a checklist of demonstrable items covering the problem, solution, and context, then teaches one stage at a time and checks off only items you restate or answer correctly.

How to quiz someone on a bugfix without leaking answers?

Use one or two questions per round, shuffle the correct answer's position, and keep all options symmetric in length and plausibility. Build distractors from real misconceptions like the bug's original wrong assumption.

What counts as demonstrated understanding versus surface agreement?

Demonstrated understanding means restating the mechanism in your own words, surviving a why follow-up, or predicting behavior in a novel scenario. Nods, labels, and repeated phrases do not count.

Can a teaching session be paused and resumed later?

Yes. The UNDERSTANDING.md checklist persists with unchecked items, so the session states exactly what remains and resumes from it later. Items are never checked off without demonstration just to wrap up.

When should I use a teaching skill after debugging?

Use it after any bugfix, refactor, or design decision where you need to explain the change to others or build on it later. It is most valuable when the root cause or design tradeoffs were non-obvious.