teach

name	Teach
description	Stateful multi-session teaching workspace that produces beautiful, self-contained HTML lessons grounded in a learner mission, plus reference documents and learning records. USE WHEN user says teach me, asks for a lesson, wants to learn a topic over multiple sessions, asks to continue learning, next lesson, review my learning, or mentions their teaching workspace, mission, or learning records.
disable-model-invocation	true
argument-hint	What would you like to learn about?

Teach

Stateful teaching system. The current directory is a teaching workspace whose files capture the learner's mission, resources, lessons, reference documents, and learning records across sessions.

Customization

Before executing, check for user customizations at: ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Teach/

If this directory exists, load and apply any PREFERENCES.md or configuration files found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

Voice Notification

When executing a workflow, do BOTH:

1. Send voice notification:

   curl -s -X POST http://localhost:4173/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "[🎯 focused] Running the Teach workflow to prepare a lesson.", "voice_id": "OqTGHgPzbq47nVmGUnK2", "voice_enabled": true}' \
     > /dev/null 2>&1 &
   

2. Output text notification:

   Running the **Teach** workflow in the **Teach** skill to ACTION...
   

Workflow Routing

Workflow	Trigger	File
Teach	"teach me X", "next lesson", "continue learning", "what should I learn next"	Workflows/Teach.md

Examples

Example 1: Start learning a new topic

User: "/teach I want to learn Rust lifetimes"
→ Invokes Teach workflow
→ No MISSION.md found, so interviews the user on why they want to learn this
→ Populates MISSION.md and RESOURCES.md, then produces lessons/0001-borrowing-basics.html and opens it

Example 2: Continue an existing learning track

User: "Next lesson"
→ Invokes Teach workflow
→ Reads MISSION.md, learning-records/, and NOTES.md to find the zone of proximal development
→ Produces the next numbered lesson tied to the mission, updates reference docs and learning records

Quick Reference

• Workspace state: MISSION.md, RESOURCES.md, GLOSSARY.md, NOTES.md, lessons/, reference/, learning-records/ in the current directory
• Unit of teaching: one short, beautiful, self-contained HTML lesson per session, numbered 0001-<dash-case-name>.html
• Browsable course: every page carries a shared top nav bar, index.html is the course hub, and the four meta files are mirrored to rendered HTML views (mission.html, resources.html, glossary.html, notes.html) while the .md stays the editable source
• Typeset math: any real notation is rendered with KaTeX (LaTeX in \( \) / \[ \]); lessons LINK KaTeX from node_modules and stay lean (~10–15 KB), viewed via bun run serve. Inlining self-contained (tools/inline-katex.ts) is an on-demand EXPORT for sharing, reversible with tools/deinline-katex.ts
• Bun toolchain (math/code courses, opt-in): such a course is scaffolded as a bun project (bun add katex marked); bun run build renders meta views + regenerates index.html + syncs the nav, and bun run serve views it. Non-math courses stay buildless
• Ground everything in the mission; if MISSION.md is empty, establishing it comes first
• Never trust parametric knowledge; gather high-trust resources into RESOURCES.md and cite them in lessons

Full Documentation (context files in skill root):

• Teaching principles (knowledge/skills/wisdom, storage strength, ZPD): TeachingPhilosophy.md
• Formats: MissionFormat.md, ResourcesFormat.md, GlossaryFormat.md, LearningRecordFormat.md, NavigationFormat.md, MathRenderingFormat.md
• Tools (copy into a workspace tools/ when a course needs math/code): Tools/build.ts (render meta + index + nav sync + roadmap lesson-link sync), Tools/serve.ts (local viewing server), Tools/inline-katex.ts / Tools/deinline-katex.ts (self-contained export and its inverse), plus Tools/package.template.json and Tools/course.template.json scaffolds