Competency Unpacker
GarethManning/education-agent-skills
Unpack a broad standard or competency descriptor into specific, assessable success criteria and sub-skills.
Designs a multi-lesson course series around a few core concepts that return at higher levels of complexity, abstraction, transfer and boundary awareness, not as repeated review.
SKILL.md written in Chinese; this summary is our English description.
$ npx skills add THU-MAIC/OpenMAIC --skill spiral-curriculum -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install THU-MAIC/OpenMAIC spiral-curriculum --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/spiral-curriculum .claude/skills/spiral-curriculum && 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 "spiral-curriculum" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/spiral-curriculum into .claude/skills/spiral-curriculum/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spiral-curriculum", 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/spiral-curriculumType 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 spiral-curriculum -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install THU-MAIC/OpenMAIC spiral-curriculum --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/spiral-curriculum .agents/skills/spiral-curriculum && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "spiral-curriculum" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/spiral-curriculum into .agents/skills/spiral-curriculum/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spiral-curriculum", 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 spiral-curriculum -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install THU-MAIC/OpenMAIC spiral-curriculum --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/spiral-curriculum .cursor/skills/spiral-curriculum && 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 "spiral-curriculum" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/spiral-curriculum into .cursor/skills/spiral-curriculum/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spiral-curriculum", 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/spiral-curriculum--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 spiral-curriculum -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install THU-MAIC/OpenMAIC spiral-curriculum --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/spiral-curriculum .gemini/skills/spiral-curriculum && 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 "spiral-curriculum" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/spiral-curriculum into .gemini/skills/spiral-curriculum/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spiral-curriculum", 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 spiral-curriculumInstalls 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 spiral-curriculum -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/spiral-curriculum .github/skills/spiral-curriculum && 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 "spiral-curriculum" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/spiral-curriculum into .github/skills/spiral-curriculum/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spiral-curriculum", 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 spiral-curriculum -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 spiral-curriculum --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/spiral-curriculum .opencode/skills/spiral-curriculum && 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 "spiral-curriculum" agent skill from https://github.com/THU-MAIC/OpenMAIC/tree/main/skills/agent-runtime/spiral-curriculum into .opencode/skills/spiral-curriculum/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spiral-curriculum", 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.
spiral-curriculumDesigns a multi-lesson course series around a few core concepts that return at higher levels of complexity, abstraction, transfer and boundary awareness, not as repeated review.
Written in Chinese, this skill plans a series where a handful of core concepts return across lessons, each time at a structurally higher level in the manner of Bruner's spiral. Its first principle is that a revisit is not a review: every return must answer what is new compared with last time, in at least one of six dimensions (complexity, abstraction, relationship density, representation, transfer distance, and boundaries and counterexamples), or it is just repetition and must be rewritten.
Planning starts from a concept spine of about three to six concepts, each written as a transferable understanding with starting and final targets, then a Spiral Map of each concept's encounters. For each revisit the agent decides what to keep, add, reorganize and transfer, using growth operators such as ADD_COMPLEXITY, ABSTRACT, FORMALIZE and ADD_EXCEPTION, normally one main operator plus a few helpers. It records concept memory during the conversation, rereads earlier stages before drafting the next, writes a Spiral Contract per stage and keeps planner terms off student-facing pages. It builds on stage-design and curriculum-planner and is not for single standalone lessons.
4 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.
Spiral Curriculum Designer loads about 1.2k tokens when it runs. Until then it costs about 131 tokens; SKILL.md has 282 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). 282 words, ~1,184 tokens.
.claude/skills/spiral-curriculum/SKILL.md (or your agent's skills folder).设计一组系列课,让少数核心概念在整个系列中反复回来,并且每次都发生结构性升阶。最小设计对象是“概念脊柱 + 每个概念的遭遇史”,不是某一节课的目录。
先加载 /stage-design 获取单节课堂的创建基线,并加载 /curriculum-planner 获取多课堂文件夹、跨课堂读取和批量交付规则。本 Skill 在它们之上增加螺旋架构、升阶操作符和假螺旋检查。
用于以下请求:
不要用于:
/stage-design 和相应主题 Skill;/curriculum-planner;/style-clone 或 /pptx-import。“第 1 课讲概念、第 3 课复习概念、第 6 课再复习”不是螺旋。每次重访必须明确回答:这一次比上一次多了什么?
每次重访至少在以下一个维度升级:
| 维度 | 初次接触 | 后续重访 |
|---|---|---|
| 复杂度 | 单一关系 | 多变量相互作用 |
| 抽象度 | 具体案例 | 一般模型 |
| 关系密度 | 孤立概念 | 与更多概念连接 |
| 表征方式 | 直观经验 | 图示、模型、符号 |
| 迁移距离 | 熟悉情境 | 陌生情境、跨领域 |
| 边界与反例 | 正例 | 反例、边界、局限 |
如果一次回来没有在任何维度更高,就只是重复,必须重写。
Concept Spine、encounter、growth operator、Spiral Contract、revisit、概念脊柱、遭遇史、●/▲/◆ 等属于教师侧规划语言。它们可以出现在对话、架构和页面 brief 中,不得出现在学生可见的标题、标签或正文。
“本次比上次多了什么”写进 brief,不写成学生页面上的“复杂度升级”标签。老师与代理的口述走 narration / actions,不写成“老师说”“学生说”的静态正文。
不要先排课时清单。先回答:整个系列结束后,学生真正应该建立哪几个能够反复使用和迁移的核心观念?
/understanding-by-design 确定大概念、基本问题和表现性证据,再用本 Skill 安排跨课升阶重访。为每个核心概念维护跨课遭遇史:直觉经验 → 机制解释 → 多变量关系 → 形式化模型 → 陌生情境迁移 → 与其他概念整合。
教师侧 Spiral Map 可以使用:
●:首次接触;▲:深化;◆:综合与迁移。每个标记旁边还必须写明本次新增结构。只有符号、没有升阶说明的表格没有价值。
对每个 concept + previous encounter + target growth 决定四件事:
一次重访通常选择 1 个主操作符和少量辅助操作符。不要一次叠满所有操作符,那只会堆难度。
螺旋依赖跨 stage 的共享记忆。平台不会替本 Skill 自动维护概念模型,所以要在当前对话中保存教师侧运行记录,至少包含:
开始下一课前,使用 read_stage_outline 回读前面课堂的持久化页面列表;需要核对真实内容时继续用 read_stage。不要只相信原计划,要依据已经落进课堂的内容调整本轮“保留、增加、重组、迁移”。
每个 stage 在教师侧规划中必须有一份 contract:
returning_concepts:哪些旧概念回来;new_concepts:哪些概念第一次出现;added_complexity:比之前复杂或抽象在哪里;new_relation:新增了什么概念关系;representation_shift:是否更换表征;transfer_target:进入哪个新情境;future_hook:故意留下什么,供后续重访。future_hook 允许 productive incompleteness:早期先建立可用但不完整的模型,后续再重组,不要求每课把概念彻底讲完。
先在对话中产出并请用户确认:
使用 ask_user 让用户能调整课时数、概念出现时机、深度与交叉关系。架构未确认前不要创建课堂。
架构确认后,默认把整个已批准系列持续建到完成,不在每课之间重复停下确认,除非用户明确要求分批验收:
create_folder 创建系列文件夹;create_stage,传入该 folderId;set_roster,再按批准计划逐页 generate_scene;generate_actions,修改旁白后补 generate_tts;list_scenes、read_stage_outline 和 read_stage 验收持久化结果;架构本身只留在教师侧规划中,不生成成学生页面。
整套系列完成后逐概念检查:
命中任一项,回到对应 Spiral Contract 修改页面 brief 或课程安排,再重新验收。
/stage-design 的页面、roster、持久化与音频完成标准;/understanding-by-design 可先确定大概念、基本问题和表现性评估,本 Skill 负责让这些概念跨课升阶重访;/feynman-learning 在一节课堂内推动解释反复外化和重建,本 Skill 在整个系列中安排概念反复回来;/learning-to-learn 与 /social-emotional-learning 是平行目标,只有服务当前概念重访时才嵌入,不另起课程主线。© 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
Just SKILL.md in skills/agent-runtime/spiral-curriculum of THU-MAIC/OpenMAIC.
Open the folder on GitHubat commit 4c67608
Spiral Curriculum Designer 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 |
|---|---|---|---|---|---|---|
| Spiral Curriculum Designer this skillTHU-MAIC/OpenMAIC | 40k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Competency UnpackerGarethManning/education-agent-skills | 840 | — | ~4.5k | Automated safety check: Pass | Custom licence | |
| HTML Ppt Course Modulesanqiufong/slides-from-anything | 132 | — | ~1.1k | Automated safety check: Pass | Apache-2.0 | |
| AI Engineering Placement Quizrohitg00/ai-engineering-from-scratch | 67k | — | ~2k | Automated safety check: Pass | MIT | |
| AnythingAtlasLiuziyu77/AnythingAtlas | 195 | — | ~3.6k | Automated safety check: Pass | Apache-2.0 | |
| Codex Skill Self-AssessmentFlorianBruniaux/claude-code-ultimate-guide | 6.1k | — | ~2.3k | Automated safety check: Pass | CC-BY-SA-4.0 |
GarethManning/education-agent-skills
Unpack a broad standard or competency descriptor into specific, assessable success criteria and sub-skills.
sanqiufong/slides-from-anything
Online-course / workshop module deck — warm paper background + Playfair serif, persistent left sidebar of learning objectives, MCQ self-check page.
rohitg00/ai-engineering-from-scratch
Runs a 10-question quiz across five areas to place a learner in the AI Engineering from Scratch curriculum, so they skip what they already know.
Liuziyu77/AnythingAtlas
Researches an unfamiliar topic and delivers a verified resource guide and a staged, timed learning roadmap as matching Markdown and HTML files.
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.
madhvantyagi/Gnos
Design and revise a course's goal, progression, prerequisites, and sources.
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
Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.
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.
Categories
Designs a multi-lesson course series around a few core concepts that return at higher levels of complexity, abstraction, transfer and boundary awareness, not as repeated review. Written in Chinese, this skill plans a series where a handful of core concepts return across lessons, each time at a structurally higher level in the manner of Bruner's spiral. Its first principle is that a revisit is not a review: every return must answer what is new compared with last time, in at least one of six dimensions (complexity, abstraction, relationship density, representation, transfer distance, and boundaries and counterexamples), or it is just repetition and must be rewritten.
Spiral Curriculum Designer fits situations like: designing a course series where core ideas return at deeper levels; organizing a unit by how understanding develops rather than by a topic list; checking a plan for revisits that are only review in disguise.
Run `npx skills add THU-MAIC/OpenMAIC --skill spiral-curriculum -a claude-code`. Or copy the skill folder (skills/agent-runtime/spiral-curriculum in THU-MAIC/OpenMAIC) into .claude/skills/spiral-curriculum in your project. Claude Code loads it when a task matches its description.
Run `npx skills add THU-MAIC/OpenMAIC --skill spiral-curriculum -a codex`. Or copy the skill folder (skills/agent-runtime/spiral-curriculum in THU-MAIC/OpenMAIC) into .agents/skills/spiral-curriculum 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 spiral-curriculum -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spiral-curriculum, .gemini/skills/spiral-curriculum, .github/skills/spiral-curriculum and .opencode/skills/spiral-curriculum in your project.
SKILL.md names no scripts, command-line tools or credentials: Spiral Curriculum Designer is instructions for the agent only. Our summary lists: The stage-design and curriculum-planner skills it builds on.
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.
Spiral Curriculum Designer 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.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Spiral Curriculum Designer: Competency Unpacker (GarethManning/education-agent-skills, 840 stars), HTML Ppt Course Module (sanqiufong/slides-from-anything, 132 stars), AI Engineering Placement Quiz (rohitg00/ai-engineering-from-scratch, 67k stars) and AnythingAtlas (Liuziyu77/AnythingAtlas, 195 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.