teach-guidance
About
The `teach-guidance` skill coaches developers on how to effectively teach and explain technical concepts. It provides guidance on structuring content, calibrating for different audiences, and improving clarity for presentations, documentation, and mentoring. Use this skill when preparing for a talk, writing tutorials, or mentoring colleagues to enhance your explanation skills.
Quick Install
Claude Code
Recommendednpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/teach-guidanceCopy and paste this command in Claude Code to install this skill
Documentation
教(引)
引人成更善之師、釋者、講者。AI 為教之師——助察何當傳於誰、構為清、練釋、依饋而精、支獻、思何成。
用時
- 須獻技內於眾而欲備之教練乃用
- 欲撰更善之文檔、教程、釋乃用
- 難釋念於異專階之人乃用
- 教或助初級開發者而欲更效乃用
- 備為講、研、知享乃用
learn-guidance助其獲知後,今須傳於他乃用
入
- 必要:所教或釋者(題、念、系、程)
- 必要:眾為何(專階、境、與其關)
- 可選:獻之格(演、文檔、一對一、研)
- 可選:時之限(5 分釋、30 分講、書文)
- 可選:前教之試與何不行
- 可選:其於題之自舒(深專 vs 新學)
法
第一步:察——解教之挑
構容前,解教之全境。
- 問所教與其因:「何念當落,若不落則何?」
- 識眾:「將釋於誰?其已知何?」
- 察人之自解:知題夠深以教乎?(若否,先薦
learn-guidance) - 識格:演、文、談、碼審、配對編
- 定成準:「何以知眾已解?」
- 顯懼或慮:「何處最令君憂?」
Teaching Challenge Matrix:
┌──────────────────┬──────────────────────────┬──────────────────────────┐
│ Challenge Type │ Indicators │ Focus Area │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Knowledge gap │ "I sort of know it │ Deepen their own under- │
│ │ but can't explain it" │ standing first (learn) │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Audience gap │ "I don't know what │ Build audience empathy │
│ │ they already know" │ and calibration │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Structure gap │ "I know it all but │ Organize content into │
│ │ don't know where to │ a narrative arc │
│ │ start" │ │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Confidence gap │ "What if they ask │ Practice and preparation │
│ │ something I can't │ for edge cases │
│ │ answer?" │ │
└──────────────────┴──────────────────────────┴──────────────────────────┘
得:教挑之明圖:何、與誰、以何格、何限、何處最不信。
敗則:若人不能述眾,助立人物:「想一具體之人聞此。其知何?所重何?」若不能述題,或須先深學。
第二步:構——組容為清
助人立明之敘構為其釋。
- 識單核訊:「若眾唯記一物,當為何?」
- 自核外建:核訊前須何境,後隨何細?
- 施倒金字塔:最要先,支細後
- 為技容,擇構之模:
- 念釋:何 → 何因 → 何如 → 例 → 邊例
- 教程:的 → 先決 → 步 → 驗 → 下步
- 構覽:問 → 限 → 解 → 權衡 → 所考之替
- 調試走:症 → 察 → 根因 → 修 → 防
- 確各節有清之的:若節不服核訊,刪之
- 計轉:「已覆 X。今於其上,須解 Y,蓋……」
得:構之提,諸元皆服核訊。構當感邏而必然——各節自引下節。
敗則:若構漸長,範圍太廣——助刪。若構感平(諸皆同層),階須精——識何主何支。若拒構(「我自然釋之」),注自然之釋於簡題行而於繁題敗——構乃架。
第三步:練——預演其釋
使人練釋念,AI 為眾。
- 求其如將實對眾而釋
- 首遍勿打斷——使其尋自然之流
- 注釋何處明何處惑
- 注用眾或不知之術之處
- 注略步或假眾或無之知之處
- 注於易部過久而於難部速過
- 若有時限,計時
得:初稿之釋,顯人之自然教模——可建之強與當調之習。練當感低賭:「此乃粗稿,非演也。」
敗則:若人僵或言「不知何始」,回第二步之構而使其一節一釋,非全。若過自批(「太爛」),轉為具:「實君釋 X 之法甚清——焦使 Y 同質。」
第四步:精——依饋改
獻具可行之饋於練之釋。
- 先強:「君以 Y 之類比釋 X 之處甚效,蓋……」
- 識最大改機(非諸患——焦一二)
- 獻具替:「勿言 [繁版],試:[簡版]」
- 察知之咒:其專使略眾所須之步乎?
- 察眾之校:深合眾,抑太淺太深?
- 若用類比,察其準(誤導之類比劣於無)
- 使其重釋精節以試改
得:的之饋,量改釋。人可覺一二試之異。饋為建構而陳——當為何,非僅當避。
敗則:若人於饋而防,自「此不明」轉為「眾或不隨——何以使更明?」若精版不善,問題或為構(第二步)非獻——回提綱。
第五步:獻——教中支
若教實時,獻獻中支。
- 為直播:助先備可能問之答
- 為文檔:審書版為清、構、眾校
- 助備「不知」之刻:「若被問不能答,言:『佳問——我察而後復。』恆可。」
- 鼓互:助備察問為眾
- 備復計:眾迷、悶、超釋之處何為
- 若獻中教練:獻簡具之催(「此處緩之」「其似惑——察之」)
得:人感備而支。有可能問之答、不期境之策、不全知亦可之信。
敗則:若憂為主礙,直治之:備減憂,認憂於眾常生連。若獻格屢變,助受格而適,非控境。
第六步:思——析何成
教事後,引思以續改。
- 問:「何成?以何為傲?」
- 問:「於何處覺眾最動?最不動?」
- 問:「眾之應有何驚?」
- 問:「若可變一物,當為何?」
- 連思於則:「成之部用 [術]。可廣施之。」
- 為下次識一具改的
- 慶其成:教乃技,以練而進
得:人得實見其教效——非泛感乃具察何成何因。離時有一可行改為下次。
敗則:若唯見負,轉至成之具刻。若唯見正,輕探眾惑之處。若無思(即過),注思乃最久之改之處——五分之審亦有義。
驗
- 教挑於構前已察(眾、格、限)
- 核訊已識而構繞之組
- 人已練釋至少一次方獻
- 饋具、可行、致量改
- 人已備為問、未確、眾適
- 獻後思識至少一具改為下次
- 教練全程鼓——教難當認
陷
- 教其容,非其教:助學材而非助獻。若須學,先用
learn-guidance。 - 過構:構過剛,失人之自然教聲。構當支其式,非代之。
- 完美陷:永練而不獻。某時練回減——推獻。
- 忽眾異:混眾須層之釋——核念為皆,細為專,類比為新。
- 饋過載:一獻過注壓人。焦最大衝之一二。
- 疏情備:教憂為實。治信與治容同要。
參
teach— AI 自為之變,校之知傳learn-guidance— 引人學;有效教之先決listen-guidance— 活聽之技助師實時應眾須meditate-guidance— 教事前定憂達焦
GitHub Repository
Related Skills
executing-plans
DesignUse the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.
requesting-code-review
DesignThis skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.
connect-mcp-server
DesignThis skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.
web-cli-teleport
DesignThis skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.
