teach

Explains code changes and subsystems through progressive diagrams and plain-language walkthroughs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers often need to genuinely understand a change or subsystem before modifying, reviewing, or debugging it, but raw code reading and dense documentation rarely build that understanding. This Skill produces a clear, paced explanation of what a body of work is, how it works, and why it was built that way. ## Core Features & Use Cases - Combined how-and-why analysis: Runs the how and why skills in parallel and weaves their findings into one coherent explanation, preserving confidence hedges from the why investigation. - Progressive diagram teaching: Builds understanding diagram by diagram, adding one part at a time using mermaid, SVG, or ASCII sketches instead of a single dense figure. - Audience-adapted depth: Calibrates what to explain based on why the person is asking (about to change it, reviewing it, debugging it, new to it) and what they already know. - Use Case: A developer joining a team asks "teach me the new sync engine" and receives a plain definition, a step-by-step walkthrough of the data flow with incremental diagrams, and the design rationale, with offers to go deeper on any thread. ## Quick Start Ask the assistant to teach you a specific change or subsystem, for example: teach me how the authentication migration works and why it was designed this way.

Frequently Asked Questions about teach

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

FAQPage Schema
How do I get an AI to explain a codebase subsystem to me?▼

Ask to be taught the subsystem by name, such as "teach me the sync engine". The Skill runs code walkthrough and design-rationale analysis, then delivers a plain explanation with diagrams built up one part at a time.

How to understand a large code change before reviewing it?▼

Request a teaching pass on the change or pull request. The explanation leads with what the change is, walks through how it works step by step, and covers why it was built that way, so you can review with real context.

Does this skill modify code while explaining it?▼

No. The goal is understanding, not changes. It reads code, diffs, and history to build the explanation, and may open the code or debugger to show you, but it does not edit anything.

What diagram formats does the explanation use?▼

It uses mermaid for flows and structures where labels carry the meaning, and SVG or ASCII sketches for spatial ideas like layout or scroll position. Complex systems are drawn as a series, adding one part per diagram.

When should I use teach instead of just reading the code?▼

Use it when you need working understanding fast: joining a new area, preparing to modify or debug something, or reviewing an unfamiliar change. It compresses the code reading and design-history digging into one paced account.