teach

Explains code and subsystems by combining how and why skill findings into plain-language teaching.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers often need to understand an unfamiliar change, subsystem, or codebase quickly, but raw code reading and documentation dumps rarely produce real understanding. This Skill turns a body of work into a plain, paced explanation that builds genuine comprehension. ## Core Features & Use Cases - Orchestrated explanation: Runs the how and why skills in parallel and weaves their findings into one coherent account of what something is, how it works, and why it is built that way. - Audience-calibrated depth: Chooses what to teach based on why the person is asking (reviewing, debugging, onboarding) and what they already know, keeping answers short first and going deeper on request. - Progressive diagrams: Builds understanding with a series of diagrams that each add one part, using mermaid for flows and generated whiteboard-style images for spatial ideas. - Use Case: A developer joins a team and asks "help me really understand the chat virtualization subsystem." The Skill runs how and why, then delivers a plain explanation starting with a one-sentence definition and building up mechanism by mechanism. ## Quick Start Ask the agent 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 AI to explain a codebase subsystem clearly?▼

Ask for a teaching-style explanation of the named subsystem. The Skill runs the how and why skills to gather mechanism and rationale, then delivers a plain account starting with a one-sentence definition and adding depth only as you ask.

How does the teach skill use the how and why skills?▼

It invokes how for how the code works and why for why it is built that way, running them in parallel and blending results. For small changes one may suffice; why is kept narrow by default since its full sweep is slow.

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

Yes. The Skill matches scope to the question, running both how and why for a subsystem but often just one for a small change. It leads with the smallest complete answer and expands only when you ask.

When should I not use the teach skill?▼

Do not use it when required inputs are missing, when you want code changed rather than explained, or when a narrower skill fits better. The Skill HOLDs and names the gap instead of guessing when inputs are unavailable.

Why does the explanation avoid one big architecture diagram?▼

A single all-at-once diagram acts as reference material, not teaching. The Skill draws a short series where each diagram redraws the last and adds one part, so you watch the system assemble step by step.