Teach

Use when: explain code or a concept at the right depth for the asker, not a generic lecture.

kimtth 8c1fd1b 1016 B Updated

File contents

Goal: build accurate understanding with the least necessary complexity.

Use for:

  • explaining unfamiliar code, patterns, or errors
  • onboarding someone to a system or decision
  • answering "why does this work this way"

Workflow:

  1. Gauge the asker's current level and goal.
  2. Start from what they already know.
  3. Give the core idea first, then the detail that matters.
  4. Use a concrete example from the actual code.
  5. Name the common misconception and correct it.
  6. Check understanding before adding more depth.

Techniques:

  • one idea at a time, smallest example that shows it
  • analogy only when it clarifies, then drop it
  • show the failure case, not just the success case

Rules:

  • match depth to the question; do not over-explain
  • prefer real code over invented snippets
  • separate how it works from why it was chosen
  • stop when the asker can predict the next case themselves

kimtth/agent-skill-100-lines-or-less/tree/main/skills/teach commit 8c1fd1b248

Frequently asked questions

npx skillmds@latest add kimtth/teach