DeepTutor CLI
HKUDS/DeepTutor
Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.
Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.
SKILL.md written in Chinese; this summary is our English description.
$ npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install THU-MAIC/OpenMAIC zone-of-proximal-development --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agent-runtime/zone-of-proximal-development .claude/skills/zone-of-proximal-development && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "zone-of-proximal-development" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/zone-of-proximal-development into .claude/skills/zone-of-proximal-development/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zone-of-proximal-development", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/zone-of-proximal-developmentType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install THU-MAIC/OpenMAIC zone-of-proximal-development --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/agent-runtime/zone-of-proximal-development .agents/skills/zone-of-proximal-development && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "zone-of-proximal-development" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/zone-of-proximal-development into .agents/skills/zone-of-proximal-development/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zone-of-proximal-development", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install THU-MAIC/OpenMAIC zone-of-proximal-development --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/agent-runtime/zone-of-proximal-development .cursor/skills/zone-of-proximal-development && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "zone-of-proximal-development" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/zone-of-proximal-development into .cursor/skills/zone-of-proximal-development/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zone-of-proximal-development", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/THU-MAIC/OpenMAIC.git --path skills/agent-runtime/zone-of-proximal-development--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install THU-MAIC/OpenMAIC zone-of-proximal-development --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/agent-runtime/zone-of-proximal-development .gemini/skills/zone-of-proximal-development && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "zone-of-proximal-development" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/zone-of-proximal-development into .gemini/skills/zone-of-proximal-development/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zone-of-proximal-development", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install THU-MAIC/OpenMAIC zone-of-proximal-developmentInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/agent-runtime/zone-of-proximal-development .github/skills/zone-of-proximal-development && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "zone-of-proximal-development" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/zone-of-proximal-development into .github/skills/zone-of-proximal-development/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zone-of-proximal-development", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install THU-MAIC/OpenMAIC zone-of-proximal-development --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/agent-runtime/zone-of-proximal-development .opencode/skills/zone-of-proximal-development && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "zone-of-proximal-development" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/zone-of-proximal-development into .opencode/skills/zone-of-proximal-development/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zone-of-proximal-development", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
zone-of-proximal-developmentDesigns a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.
An exercise lesson (习题课) built this way starts with the learner working alone on a short task. The teacher or agent then comments on what that real work shows, gives just enough temporary help, withdraws it, and asks for a similar new task to see what the learner can now do unaided. The lesson closes with a small record of what happened and a next practice step based on that evidence.
It runs in three modes: building or improving a whole lesson (reading `references/exercise-lesson.md` and using `/stage-design` for a new classroom or `/pro-editing` for an existing one), running one practice cycle directly in chat, or just answering a theory question. It is careful about claims: one attempt is never treated as proof of mastery or as a measured score, and the scaffolding steps are presented as a teaching design, not as Vygotsky's own procedure. `references/theory.md` holds the background. The skill text is written in Chinese.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 4c67608. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Zone of Proximal Development Practice Lessons loads about 1.1k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 117 tokens; SKILL.md has 107 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from THU-MAIC/OpenMAIC at commit 4c67608, republished under its MIT licence (© THU-MAIC). 107 words, ~1,065 tokens.
.claude/skills/zone-of-proximal-development/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.把已有学习内容组织成一节测验习题课,而不只生成题目:用独立尝试找到本次需处理的困难,以针对性讲评和暂时支持帮助学习者继续行动,再用新任务复核,留下有依据的后续练习安排。教师或更有经验的同伴提供支持,让学习者逐步承担关键判断与操作。
最近发展区是理解发展与协助关系的理论概念。下面的诊断尝试、支架和撤架是本 Skill 的教学设计,不是维果茨基提出的一套固定步骤。单次活动只能提供当前任务与支持条件下的表现线索,不能测出稳定的“最近发展区分数”。
需要核对理论归因或解释设计依据时,阅读 理论依据与设计转化。
/stage-design;已有课堂按 /pro-editing 先盘点,再补足缺失环节。本 Skill 负责整课的目标、题组关系、讲评、练习路径和收束,不替代页面工具。从请求和材料中确定学习对象、已有学习内容、课时、核心目标、成功标准及先备知识。只有缺少信息会实质改变教学时才补问。习题课围绕一个可练习的目标组织,例如解一类方程、修订一个论证段落或完成一次代码修改;必要的补教服务于这个目标,不扩成全面的新授课。
整课计划说明学习者最后要能做什么,每组任务检验或练习什么,以及哪个环节根据先前表现改变帮助。目标说明、诊断、讲评、受助练习、独立复核和收束应相互衔接,可以合页,不能只把题量增加就称为完整习题课。
讲评依据学习者实际作品展开。预先生成的典型错解标为教学例子,不写成“你刚才犯了这个错”。已会且理由充分者可跳过带练;支持不足者可回到先备任务。没有运行时自动分流能力时,清楚提供学习者或教师选择的路线与具体导航方法,不声称系统已经自动选择。
先给出一道与目标直接相关、难度适当的短任务,请学习者尝试并说明关键一步的理由。已有真实作品足够时可从作品开始。首次尝试前不展示目标任务的解法、提示或正确答案;提供读题、语言、输入方式等必要可及性支持时,记录其条件。
不能以自称“初学者”、年级、一次错答或一道题的正确率直接判定能力。观察实际回应:是关键知识不会、步骤执行困难、题意不清,还是当前证据不足?当不同解释会导致不同帮助时,只补一个能区分它们的问题。
诊断问题保持足够单一。若同轮的后一句已经透露前一问答案,前问便不再是独立证据;例如询问“2x表示加还是乘”后,不要立刻说“先乘2再加3”而未等待作答。
判断用“你写了……,这可能意味着……”连接证据与解释。不要把未说出的心理状态写成“你心里其实……”,也不要声称一道题能直接测出最近发展区。
教学对话描述具体任务与帮助条件,不把学习者定位为“正处于最近发展区”“在最近发展区边缘”或已经到达某个发展上限。尤其不能仅凭自报困难作出这种定位。
选择最可能让学习者继续行动的支持,不要求人人走遍同一阶梯:
| 当前卡点 | 可选择的支持 | 学习者仍需完成的动作 |
|---|---|---|
| 没注意到关键条件 | 指向条件或给一个方向性问题 | 识别关系并决定下一步 |
| 知道概念但步骤过多 | 步骤卡、图示或部分完成的任务 | 补全关键步骤并解释理由 |
| 必要知识或方法缺失 | 简短明示教学,必要时示范另一道题 | 在目标任务中自己调用方法 |
| 反复失败或明显受挫 | 缩小目标、回到先备任务、换一种表征 | 完成一个仍有学习价值的小步骤 |
每次提供一段足够使用的帮助,再留下一个清楚的作答机会并等待。不要在同一条回复中替学习者完成后续整条推理、补齐其答案,再宣布可以独立。
需要示范时,说明专家为何选择这一步,以及怎样检查结果。尽量用另一个例子,保留当前任务的关键行动。用户明确要求看解答时可以讲解,并将该任务标为“已看解答”,另选新任务检查独立表现。
AI 同伴可以示范提问、合作思考或呈现可辨析的思路;它的回答属于教学材料,不计作学习者表现。一次只安排一个主要帮助者,避免多个代理同时给出相互竞争的提示。
取得学习者在支持下的实际回应后,决定维持、增加或撤去哪一项帮助。撤架依据是学习者承担了原来需要帮助的关键动作,不是翻到下一页或练够规定次数。
让学习者在目标要求可比的新任务中重新尝试,移除刚才覆盖关键判断的提示与示范。不要提前给新任务的答案,也不要把原题复述当作独立应用。若再次卡住,恢复针对性的帮助或返回一个更小目标。
首次撤架复核保持所需知识、关键步骤与难度相近,优先改变题目数值或表面情境。不要同时增加未教的新规则,例如刚练完正整数系数方程就用负系数或分数作为独立复核。需要增加难度时,另标为新挑战并检查先备知识。
检查示范、受助任务与新任务的答案是否碰巧重复,避免直接套用上一题答案即可碰对;独立表现仍须结合理由或关键动作判断。
只有在收到新尝试后才报告当次表现。一次成功可支持“这道题在没有步骤提示时完成了”;不能直接推出稳定掌握、长期保持或一般发展水平。
对话中用简短文字记录真实发生的内容:
未发生的尝试保持待完成;无回应时不预填成功、误解或进步。记录以可核对的作品与动作描述为主,避免固定能力标签。
“两边该加还是减、多少”等指向解题步骤的问题本身也是支持。学习者在这种问题后自己写出答案,应记录为“在步骤提示后完成”;只有没有该类关键提示的新任务才记录为独立尝试。一次独立成功的结论写到具体题目为止,不扩大成“这一类已经完全掌握”。
整课按 习题课组织方式 补齐目标、讲评和收束;其中的练习循环可用三类活动承载,不机械要求固定页数:
每页 brief 明确任务、成功标准、帮助内容及显示时机、学习者亲自完成的动作。独立页的旁白、AI 同伴和默认展开区域都不能提前说出解法或答案。学生可见文字使用动作语言,例如“先试一题”“给我一点提示”“换一题自己做”。
独立诊断优先用一项自由作答任务收集答案与理由。生成后读取真实题目核对题型及整页内容:另一题的题干、选项或示例也可能泄露当前题答案;brief 写了“不泄露”不表示页面已做到。发现题型不符或交叉泄露时,按 /stage-dsl 的 quiz 说明修改已保存页面,再在课堂预览中复核。
生成式页面可预设提示、收集输入和支持自检;不能仅凭本 Skill 自动理解任意自由文本或跨页决定撤架。需要动态判断时在工作台对话中执行。若页面只支持学习者自己选择帮助,应明确呈现为自选帮助,不声称系统已经诊断其最近发展区。
需要保存回答时,使用当前组件实际支持的记录方式,实测提交、取回、修订和刷新。尚未证实可保存时,明确提示学习者另行保留;不设计看似保存成功但没有实现的按钮。课堂生成完成与学习者完成循环分别报告。
© THU-MAIC, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files (references) in skills/agent-runtime/zone-of-proximal-development of THU-MAIC/OpenMAIC.
Open the folder on GitHubat commit 4c67608
Zone of Proximal Development Practice Lessons next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Zone of Proximal Development Practice Lessons this skillTHU-MAIC/OpenMAIC | 40k | — | ~1.1k | Automated safety check: Pass | MIT | |
| DeepTutor CLIHKUDS/DeepTutor | 41k | — | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Claude Certification Tutorrohitg00/ai-engineering-from-scratch | 67k | — | ~3k | Automated safety check: Pass | MIT | |
| StudyVault Quiz Tutorbevibing/tutor-skills | 1.3k | — | ~1.4k | Automated safety check: Pass | MIT | |
| AI Engineering Course Tutorrohitg00/ai-engineering-from-scratch | 67k | — | ~2.2k | Automated safety check: Pass | MIT | |
| Codex Skill Self-AssessmentFlorianBruniaux/claude-code-ultimate-guide | 6.1k | — | ~2.3k | Automated safety check: Pass | CC-BY-SA-4.0 |
HKUDS/DeepTutor
Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.
rohitg00/ai-engineering-from-scratch
Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.
bevibing/tutor-skills
Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.
rohitg00/ai-engineering-from-scratch
Teaches the next lesson of the AI Engineering from Scratch curriculum in the terminal, quizzes you at the end and records your progress.
FlorianBruniaux/claude-code-ultimate-guide
Runs an interactive quiz in a quick or comprehensive mode, scores your skill level by topic and generates a personalized learning path with practice projects.
dair-ai/dair-academy-plugins
Help a user learn a topic through adaptive tutoring, lesson planning, practice, retrieval checks, explanations, study guides, or exercises.
THU-MAIC/OpenMAIC
Guides setup, classroom generation and secondary development for OpenMAIC, the multi-agent interactive classroom, one confirmed phase at a time.
THU-MAIC/OpenMAIC
Designs a Chinese K-12 classroom for one OpenMAIC stage around the core-literacy model, using authentic tasks, performance assessment and observable evidence.
THU-MAIC/OpenMAIC
Maps the structure of an OpenMAIC stage document so an agent can find the right path, read it and patch quizzes, widgets, actions and project pages without guessing.
THU-MAIC/OpenMAIC
Derives a reusable personal skill for course-making from a representative sample of the user's own past classrooms and chat history, confirmed with them before saving.
THU-MAIC/OpenMAIC
Plans a multi-classroom series such as a seven-day course, clarifies the brief in rounds, gets sign-off on the full lesson list, then builds each stage in a shared folder.
THU-MAIC/OpenMAIC
Plans online courses so learners manipulate simulations, diagrams, code, games or 3D scenes on most pages, with slides only for the opening and the close.
Categories
Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step. An exercise lesson (习题课) built this way starts with the learner working alone on a short task. The teacher or agent then comments on what that real work shows, gives just enough temporary help, withdraws it, and asks for a similar new task to see what the learner can now do unaided.
Zone of Proximal Development Practice Lessons fits situations like: turning existing course material into a quiz-review lesson that starts from diagnosis; running a guided-to-independent practice cycle on one skill, such as solving a type of equation; planning a lesson that adjusts its help according to what each learner actually did; answering a question about zone of proximal development theory without building a lesson.
Run `npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a claude-code`. Or copy the skill folder (skills/agent-runtime/zone-of-proximal-development in THU-MAIC/OpenMAIC) into .claude/skills/zone-of-proximal-development in your project. Claude Code loads it when a task matches its description.
Run `npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a codex`. Or copy the skill folder (skills/agent-runtime/zone-of-proximal-development in THU-MAIC/OpenMAIC) into .agents/skills/zone-of-proximal-development in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add THU-MAIC/OpenMAIC --skill zone-of-proximal-development -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zone-of-proximal-development, .gemini/skills/zone-of-proximal-development, .github/skills/zone-of-proximal-development and .opencode/skills/zone-of-proximal-development in your project.
SKILL.md names no scripts, command-line tools or credentials: Zone of Proximal Development Practice Lessons is instructions for the agent only. Our summary lists: Classroom commands `/stage-design` and `/pro-editing` for building whole lessons.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Zone of Proximal Development Practice Lessons is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Zone of Proximal Development Practice Lessons: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 67k stars), StudyVault Quiz Tutor (bevibing/tutor-skills, 1.3k stars) and AI Engineering Course Tutor (rohitg00/ai-engineering-from-scratch, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
THU-MAIC (a GitHub organization) maintains it in THU-MAIC/OpenMAIC, which has 40,347 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 11, 2026.
Source: THU-MAIC/OpenMAIC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.