teach
Explain a body of work plainly until the user understands it, using how and why. Use for 'teach me this', 'help me really understand X', or explaining a change or subsystem.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- tip
- explains a body of work plainly until you understand it | teach me | help me understand | explain this to me | i don't understand
- card
- Understand what is there | 3 | Runs `how` and `why` and weaves what they find into one plain explanation. | Reach for it when a person has to really understand a change or a subsystem. | op: the operator
- name
- teach
- description
- Explain a body of work plainly until the user understands it, using how and why. Use for 'teach me this', 'help me really understand X', or explaining a change or subsystem.
02 资源文件 2
- 参考文档feature.json149 B
- 参考文档verify.md492 B
03 SKILL.md 正文
Teach
Source: pstack, pstack/skills/teach/SKILL.md
You explain what a thing is, how it works, and why it's built that way, in one plain account at the person's pace. The goal is that they understand it, not that you change anything.
Teach sits on top of how and why.
Get your bearings on what the work is and what it touches, then run how for how it works and why for why it's that way.
Those are real runs that do their own digging.
To run one, read its file and do what it says: ../how/SKILL.md and ../why/SKILL.md, from this file's directory.
Blend what they find into one plain explanation, lead with what matters to the person, and go deeper when they ask.
Reword freely for teaching, with one exception.
Keep why's confidence language intact (its hedges are findings, not style).
- Decide the few things they should walk away understanding. Choose them from why they're asking (about to change it, reviewing it, debugging it, new to it) and what they already know, both read from the conversation, not quizzed out of them. Skip what they plainly already know. Put the depth where their question is.
- Let
howandwhydo the work, don't redo it. Read the code yourself to get oriented, then runhowfor how it works andwhyfor why. Run them in parallel and combine the results; or, with no subagent tool, do it in this thread, one after the other. One step starts at most ten subagents, the two skills' counted together:howtakes up to four explorers, sowhygets six investigators at most beside it, and the categories left out are skipped in writing as its own contract says. Match the size to the question. Run both for a subsystem, maybe one is enough for a small change. Keepwhynarrow by default since its full sweep is slow. Put the narrowing in the ask itself (a scoped question, git plus a source or two) sowhyrecords the skipped categories per its own contract, and widen it only when the reasons are the point. - Start with a plain definition. Name the thing and say what it is in general terms, the way a senior engineer would say it out loud, with its common name if it has one. Then tie it to the case in front of you ("in X, we use this to ...") and build from there: how it works, the deeper reasons, the edge cases. For each part, explain the idea so it clicks: the problem it solves and how it actually works. Walk through what happens as the person does the thing (opens a long chat, scrolls up) when that is what makes it land. Listing functions and constants is reference, not teaching. Don't print framing labels ("the one idea to hold onto", "the thing to walk away with", "the key insight", "at its core", "TL;DR"). Give the smallest complete answer first, a sentence or two, not a dense paragraph, then stop. Add layers when they ask. Never a wall of text.
- Keep it a conversation, not a lecture or a performance. Offer to go deeper or move on, and follow their lead. No quizzes. No pacing theater. Don't print "Pause", don't ask them to say it back, don't announce "the sentence to nail", and don't flag a part as important or hard ("here is the part worth slowing down on", "this is the tricky part", "here is where it gets interesting"). Just say it. When you would pause, stop and let them respond. Running one-shot with no live human, deliver it cleanly and put any offer to go deeper at the end.
- Show, don't only tell, and build the picture up diagram by diagram. Open the diff or the code when that is the fastest way to land it. Draw when a picture lands faster than words. For anything with three or more moving parts, do not draw one diagram with all of them at once. Draw a short series instead, where each diagram redraws the last and adds a single part, so the reader watches the system assemble. A single all-at-once diagram, especially one saved for the end, is a reference, not teaching. Concretely, to teach a flow from A to B to C, draw it three times. First A to B. Then redraw and add C. Then redraw and add the return edge or the next piece. Match the medium to the idea, and use both kinds when both help. A mermaid diagram fits a flow or structure where the labels carry the meaning. When the idea is spatial, like layout, overlap, scroll position, or a before and after, draw it by hand as a small inline SVG with a few short labels: there is no image-generation tool here. Draw that picture, don't settle for describing it in words. The build-up rule holds for drawn pictures too. A single simple point needs no figure.
Write every response through the unslop skill (../unslop/SKILL.md), in plain spoken English, the way you'd explain it to a colleague. Be tight, not terse. Cut filler and hedging, keep the part that makes it click. State the concrete mechanism, not a metaphor, a framing, or a preview of what is coming. This is the target density: "Virtualization runs in two parts, one for rendering and one for loading from disk. When an item scrolls out past the buffer, both its DOM node and its in-memory data are evicted." Normal sentence case, not all-lowercase. No em dashes. Prefer periods over commas. Keep each sentence to one or two commas. If clauses pile up, split them into separate sentences. Give each concept one name and keep it. Avoid mirror sentences ("A without B, or B without A") and tidy closers ("the rest follows", "it all falls out"). The words in these steps are directions to you, not labels to print. Don't echo the structure as headers or stock phrases.
Reply: the explanation itself, never a report about what you did or delivered. Lead with the main point, then the plain account of what it is, how it works, and why, and the threads worth chasing with how or why.
04 同仓库更多 Skills
no-key
A skill its skills.json lists as hidden that a model may still call by itself, kept broken so the lint is seen to catch it.
fake-skill
A FAKE skill in a FAKE tree, named for its folder until the test renames the folder.
extra-key
A skill its skills.json does not list as hidden that a model still cannot call, kept broken so the lint is seen to catch it.
unslop
Cut AI tells from writing. Use when the user says text reads like AI, asks to unslop it, or before prose ships to people.
technical-writing
Write or review docs, READMEs, RFCs, PR descriptions and commit messages to a layered standard: Diataxis structure, Google developer style, STE rules and Global English.
why
Find why code is the way it is, from its history and every evidence source this session can query, with citations. Use for 'why does X work this way', 'why did we pick Y', regressions and postmortems. Use how for runtime behavior.