teach

Explains how code works and why by combining the how and why skills into one plain account.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers often need to genuinely understand a change, subsystem, or unfamiliar codebase before modifying, reviewing, or debugging it, but raw code reading alone rarely explains both the mechanics and the reasoning behind design decisions. ## Core Features & Use Cases - Combined investigation: Runs the how and why skills in parallel and weaves their findings into one coherent explanation. - Audience-aware 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. - Progressive visual teaching: Builds understanding through a series of small diagrams that each add one part, using mermaid for flows and generated whiteboard-style images for spatial ideas. - Use Case: A developer joining a team asks "teach me how the virtualization in this chat UI works" and receives a plain, layered explanation of the rendering and disk-loading mechanisms, why they were built that way, and diagrams that assemble the flow step by step. ## Quick Start Ask the assistant to teach you how a specific subsystem or recent change works and why it was built that 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 explanation of an unfamiliar codebase subsystem?▼

Ask to be taught how the subsystem works. The skill runs the how and why skills to investigate the mechanics and design rationale, then blends the findings into one plain explanation matched to what you already know.

How to understand why a piece of code was written a certain way?▼

The skill invokes the why skill, which investigates the reasoning behind design decisions using git history and sources. Its confidence hedges are preserved in the explanation since they are findings, not style.

Does this skill modify or refactor the code it explains?▼

No. The goal is understanding, not change. It reads code to get oriented and delegates investigation to the how and why skills, then delivers only an explanation.

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

Use it when you need both mechanics and rationale quickly, such as before changing, reviewing, or debugging unfamiliar code. For a tiny change, it may run only one of the underlying skills to match the question's size.

What are the limitations of automated code explanation?▼

Explanations depend on what the how and why skills can uncover from code, git history, and available sources. Design rationale that was never written down may remain uncertain, which is why confidence hedges are kept intact.