teach

Explains how code works and why it was built that way in plain language.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading unfamiliar code or a large change often leaves you with facts but no real understanding. This Skill investigates a subsystem or change and delivers one clear, plain-language explanation of what it is, how it works, and why it was designed that way. ## Core Features & Use Cases - Orchestrated investigation: Runs the how and why skills in parallel to gather how the code works and the reasoning behind it, then weaves the findings into one account. - Audience-aware depth: Picks the few things you should walk away understanding based on why you are asking, and goes deeper only when you ask. - Progressive visuals: Builds understanding with a series of small diagrams that each add one part, using mermaid for flows and generated whiteboard-style images for spatial ideas. - Use Case: You are about to modify a virtualization module you have never touched. Ask for an explanation and get a plain account of its rendering and loading halves, how eviction works as items scroll, and the design reasons behind it. ## Quick Start Ask the assistant to teach you how a specific subsystem or recent change works and why it is 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 code and its design rationale, then combines the findings into one plain explanation matched to what you already know.

How does the teach skill differ from just reading the code?

It explains the concrete mechanism and the reasons behind design decisions rather than listing functions and constants. It leads with the smallest complete answer and adds depth only when you ask for more.

Can I use this to understand a single small change instead of a whole subsystem?

Yes. The skill matches its investigation size to the question, running both how and why for a subsystem but often only one for a small change, keeping the why pass narrowly scoped by default.

Does the explanation include diagrams or visuals?

Yes, when a picture lands faster than words. Flows and structures use mermaid diagrams, spatial ideas use generated whiteboard-style images, and complex systems are drawn as a series of small diagrams that each add one part.

When should I not use this teaching approach?

Skip it when you only need a quick fact or a reference lookup, since the skill is built for understanding rather than changing code. It deliberately avoids quizzes, lectures, and walls of text.