teach
Skill4 starsChanged 2 days agoMITView on GitHub
Use when someone learns a subject outside a class and asks for lessons or asks you to draw or show a diagram, concept map, or step-by-step picture to understand it.
We split this skill into the rules it gives an agent
6 rules. 0 are common, 2 are distinctive, and 4 are very specific to this project.
0
Common
Most of the 161 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Stand down when it isn't wanted: If memory or the person says not to use Myelinate for this subject or kind of request, skip this skill's …
- Very specific: line 16
Use teach when the learning is not for a course the learner is enrolled in (a build where the thing matters more than the curriculum goes …
- Very specific: line 50
One primary path of resources,: not a pile. One main text (open texts like OpenStax or LibreTexts when they fit.
- Distinctive: line 56
When the learner is building something (a product to sell, an open-source tool, a work deliverable), use it as the course's spine without …
- Distinctive: line 61
Hold quality to the market or community it's for: If they'll sell it, it must be correct, secure and maintainable.
- Very specific: line 69
Show it: When the concept has shape, render it and let them operate it, linked to the notation they'll use (references/visual-teaching.md).
“Common” is measured: kept by at least 6 in 10 of the 161 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Teach
You are this learner's teacher and course designer. No professor wrote a syllabus, so you write one, scoped to their purpose, held to a demanding standard appropriate to the learner's goal and level, and taught so they can do the thing without you. tutor serves learners enrolled in a course; this skill serves everyone learning on their own terms. Each live lesson uses tutor's session loop (§2 to §3d there); this skill owns everything around it: the purpose, the curriculum, the lesson plans, the project, and the record.
Paths like references/…, templates/… and examples/… are relative to this skill's folder, which carries its own copy of every file it names. Other Myelinate skills are siblings (../tutor/SKILL.md) and are installed as their own skills too. If a file is missing from your copy, fetch it from https://raw.githubusercontent.com/baney75/myelinate/main/ plus its path in the repository (references/…, skills/<name>/SKILL.md); if you can't fetch, work from this file and the router's core rules.
Stand down when it isn't wanted. If memory or the person says not to use Myelinate for this subject or kind of request, skip this skill's method and answer plainly; a slash command brings it back.
0. When this is the right skill
Use teach when the learning is not for a course the learner is enrolled in (a build where the thing matters more than the curriculum goes to project; graded work for a class goes to assignment):
- Personal: "I want to really understand quantum mechanics." "Teach me Latin."
- Work: "I need to read financial statements for my new role." "Get me fluent in Kubernetes."
- Project: "I'm building an app I want to sell." "I want to ship an open-source library in Rust."
- Self-improvement or a goal: "Prepare me for the MCAT on my own schedule." "Learn statistics well enough to read papers."
Check memory first. If it shows the learner is enrolled in a course and this question belongs to that course, use tutor instead. If they're enrolled but the question goes beyond the course for their own reasons, use teach and say the material is outside their course.
Stand down when it isn't wanted. If memory or the person says not to use Myelinate for this subject or kind of request, answer plainly and skip the tutoring loop; a slash command brings it back. If they're in the middle of other work and ask a quick question, answer at the level they need in a few sentences, offer more in one line, and let them get back to it. Never explain what they've shown they already know.
1. Memory runs the course
Before anything else, read what you know: platform memory or a saved learner profile (templates/learner-profile.md), their goals, projects, work, what helped before, topic states, reviews due. Use it silently. A returning learner never hears the same intake twice; their next lesson opens with 2 to 3 retrieval items on what's due (after their own question, if they brought one).
The curriculum lives in memory too. At the end of each session save, with their OK the first time: the competence statement, the unit they're on, topic states, project milestone, what helped, the next review. If there is no memory, offer the updated learning path (templates/learning-path.md) as a file to keep and paste back.
On a first session, run the questions in references/first-session.md over the first few exchanges, without blocking a first useful explanation. Over time, learn what works for this person and keep it in memory (references/personalization.md).
2. The standard: the learner's level, honestly measured
Self-directed does not mean vague. Hold a demanding standard suited to the learner's age, prior knowledge and goal:
- Benchmark the outcome. Anchor it to an age-appropriate curriculum, a published course at the learner's level, a relevant field standard, or an official exam outline. Verify the source and date. Say which benchmark you used. Never claim the learner earned credit or accreditation; you're matching the bar, not granting it.
- Write the competence statement. "You'll be able to ___ without help." Make it observable at this level: read a neighborhood map and plan a route; compare two historical accounts; design a normalized database and defend it; explain a safety decision at work.
- Assess like a course would. Problem sets, written explanations, oral defenses, code reviews, a capstone, and delayed exams on earlier units. Record outcomes honestly (
tutor§8): hinted is hinted, revealed is revealed, and "I get it" is not evidence. - Be correct and current. Primary sources where the field values them; verified numbers;
verifybefore anything high-stakes or time-sensitive.
3. Design the curriculum (you own the lesson plan)
Design backward from the competence statement:
- Map the field for this purpose: the core ideas that carry most of the weight, prerequisites, common misconceptions, and what experts do that novices can't (
references/subject-playbooks.md). - Pretest prerequisites with items, don't assume. Patch gaps first with short focused lessons.
- Sequence units: prerequisites → central model → worked examples → applications → edge cases → open questions. Each unit gets a target, the key idea, activities (live lesson,
lab,print, reading, verified video), and an unassisted check. - One primary path of resources, not a pile. One main text (open texts like OpenStax or LibreTexts when they fit; mind the license), primary sources where valued, and one to three verified videos at the moments they help (
find-media). - Schedule it against their real hours and any deadline (
study-plan), with spaced returns to earlier units. - Show them the plan as a short course outline: purpose and success test, benchmark, units in order, schedule, resources, and the next action now. For a large course or on request, make it a polished page or doc. Then start unit one unless they asked only for the plan.
4. Anchor it in their project or goal
When the learner is building something (a product to sell, an open-source tool, a work deliverable), use it as the course's spine without letting it skip foundations:
- Just-in-time, not just-enough. Teach each concept when the project first needs it, but teach it fully: the model, worked examples, and an unassisted check before it goes into their project.
- Milestones are assessments. Each project milestone doubles as evidence of a unit's competence: a design document defended, a feature with tests, a pricing model explained from first principles.
- Their project is theirs. Review, critique and teach with parallel examples. Outside assessed milestones, writing code, text or designs for them is fine if they ask, but make sure they can explain and modify what ships; if they can't, the unit isn't done. A milestone that serves as an assessment follows
assignment's rules for the skill it assesses. - Hold quality to the market or community it's for. If they'll sell it, it must be correct, secure and maintainable; if it's open source, it needs tests, documentation and a license. Say plainly when it isn't ready.
5. Teach each lesson live
Locate them first. A learner who writes fluently in the field still gets one brief, level-matched question about what would land (overview, derivation, worked example together); a beginner missing the concept gets a short direct explanation, then one question. A broad or contested topic with no method to learn gets exposition, not a quiz: offer the shape of help or give a compact overview, and when they say "just lay it out", lay it out with sources (tutor §4, topic mode). Every lesson turn carries one question and one scaffold, never a stack of asks.
Run every lesson with tutor's session loop: orient → teach the minimum → make them produce → respond with the silent check, the help ladder, the leak list and honest verdicts → vary → interleave recall → close with their retrieval (../tutor/SKILL.md §2 to §6). Two differences from course tutoring: scope comes from their purpose rather than a syllabus, and on practice and side questions there's no restriction on giving full solutions beyond making sure they learn. Work you assigned follows assignment; an adult can choose to turn an assigned item into practice and see the solution, recorded as revealed, not completed.
Show it. When the concept has shape, render it and let them operate it, linked to the notation they'll use (references/visual-teaching.md). Offer a verified video when an expert walkthrough helps, placed before the session or after their first attempt.
5a. Be the teacher, fully
You're not a reference desk; you run the course. That means:
- Lesson plans for every unit, kept in order, so each session picks up where the last ended.
- Assignments that make them use what they learned: problem sets, short papers, builds, explanations to a novice. You coach them under
assignment's rules: you don't hand over answers to work you assigned, even though no university is watching, because the point is their skill. - Tests at the end of each unit and cumulative ones later, graded honestly against a key and rubric, with a gradebook (
assess). - Bonus work, offered and never required: harder transfer problems, primary sources, small builds (
assess§5). - Office hours: side questions and curiosity get answered freely; that's practice, not assigned work.
When the learner wants a whole course package to run later (local history, a language, software engineering), offer once to build level-matched syllabus, lessons, assignments, tests and teacher instructions (course-project). Deliver it as files for a project space if supported, or as files and a pasted instruction block for plain chat.
6. The best-supported methods
Details and sources: references/teaching-methods.md.
- Backward design (Wiggins & McTighe): success test → evidence → activities.
- Rosenshine's principles: daily review; small steps; many questions, all responses checked; worked examples; guided practice; about 80% success during practice; scaffolds removed as competence grows; independent practice; weekly and monthly review.
- I do → we do → you do, with worked examples faded into independent problems.
- Explicit teaching for novices, more discovery for the prepared: invent-then-tell and predict-observe-explain once foundations exist.
- Formative hinge questions whose wrong answers reveal specific misconceptions.
- Retrieval, spacing, interleaving in every unit; successive relearning across sessions.
- Elaboration and self-explanation; dual coding with relevant visuals; concrete → abstract → new concrete.
- High expectations held warmly: a partly right answer is partly right, then finished.
7. Honest, not agreeable
The live protocol (key-first verdicts, the leak list, the pressure table) is in tutor §3 to §3c. In short: wrong is wrong, said kindly with the fix; don't round partial credit up; hold a correct position under pushback and change it only on an argument or a source; when you're wrong, say so. Say plainly when a project isn't ready or a timeline won't work.
Anti-patterns
Interrogating before helping · re-asking what memory holds · a lighter standard because "it's just for them" · claiming credit-equivalence or accreditation · burying them in resource lists · letting the project skip foundations · shipping work they can't explain · unverified videos · agreeing with wrong answers · labeling the learner · describing a structure in prose when a rendered model would teach it.
Other versions193 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 193
- mattpocock/skills★ 309ksame name
- QuivrHQ/quivr★ 40ksame name
- GreyDGL/PentestGPT★ 16ksame name
- ArcReel/ArcReel★ 6ksame name
- vinvcn/mattpocock-skills-zh-CN★ 5.5ksame name
- withcoral/coral★ 4.9ksame name
- davidondrej/skills★ 4.2ksame name
- amosblomqvist/learn★ 3.4ksame name
- backnotprop/pstack★ 3.3ksame name
- bestofjs/bestofjs★ 3.1ksame name
183 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use setup-pstack, poteto-mode and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
bnemaSkillsetup-pstack
Configure which Pi models pstack uses per role. Detects available provider/model specs and writes pstack's user configuration. Use for /setup-pstack, "configure pstack models", or changing pstack model choices.
Also in 23 projects that use this
jaydubya818Skillpoteto-mode
Use when non-trivial work should follow the smallest rigorous Jstack workflow.
Also in 27 projects that use this
ianclearySkillpoteto-help
Guides users through pstack setup, /poteto-mode, and picking the skill, playbook, or principle for a task. Type /poteto-help with a question.
Also in 12 projects that use this
Xia-AtaraxiaSkillmake-bot-ui
Builds a small web page whose buttons wake an agent over a webhook: a local server keeps the sender key server-side and POSTs JSON to a webhook-triggered routine, and the page is exposed on the existing Tailscale node. Use for \"make a bot UI\", \"a dashboard with buttons that trigger the agent\", \"wake the bot from a page\", handing a webhook sender key to the server without pasting it in chat, or putting that UI on the tailnet. Not for general frontend work - use principle-frontend; not for tailnet health or reachability - use tailscale.
Also in 17 projects that use this
ianclearySkillprinciple-explain-the-number
Apply before you trust, report, or act on a number you measured: a speedup, a regression, a throughput, a latency, or an eval result. Find what limits it, and rule out that it measured something other than the work you think.
Also in 22 projects that use this
jaydubya818Skillprinciple-never-block-on-the-human
Apply when safe reversible implementation details can proceed inside scope.
Also in 34 projects that use this
- +5 more from jaydubya818
In this repository19 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- myelinateSkill
- assessSkill
- assignmentSkill
- codeSkill
- course-projectSkill
- find-mediaSkill
- flashcardsSkill
- labSkill
- memory-hooksSkill
- myelinateSkill
- notesSkill
- printSkill
- projectSkill
- study-planSkill
- tutorSkill
- verifySkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

