feynman-learning SKILL.md skillA

feynman-learning from thu-maic/openmaic is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add thu-maic/openmaic/feynman-learning@git:20260827.0462157

Pins git:20260827.0462157 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
thu-maic/openmaic
Path
skills/agent-runtime/feynman-learning/SKILL.md
Versions recorded
1
Latest version
git:20260827.0462157, committed Aug 27, 2026
Size
8,215 bytes
Repository stars
42,430
License
MIT

Turn any concept, lesson, slide deck, or source material into a Feynman learning cycle in which learners explain first, expose the smallest gap, rebuild the explanation through Socratic prompts, strip jargon, stress-test analogies, and transfer the idea to a new context. Use when the user asks for teach-back, learning by explaining, or a Feynman-style classroom. Do not use when the Feynman technique itself is merely the lesson topic or when study strategy should remain a parallel goal.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 费曼学习法

把任何学科内容重构为一轮完整的费曼学习循环。核心对象不是教材,而是学习者当前的解释。学习者必须经历“先解释、暴露缺口、自己重建、换种说法、迁移应用”,最终留下《费曼学习记录》和下一轮目标。

先加载 `/stage-design`,遵循它的新课堂创建、roster、逐页持久化和音频验收流程。本 Skill 只规定教学法、页面 brief 和互动节奏。

## 适用范围

用于以下请求:

- 用费曼法学习或教授某个具体概念;
- 把课件、教案、视频或材料改造成费曼式学习活动;
- 设计一节以 teach-back、自我解释、追问和迁移为核心的课堂。

不要用于:

- 以“费曼学习法是什么”为知识主线的科普课;
- 只想把学习策略作为概念课的平行目标,此时使用 `/learning-to-learn`;
- 品牌风格复制或 PPT 原样导入,此时使用 `/style-clone` 或 `/pptx-import`。导入材料仍可作为本 Skill 的事实来源。

## 核心原则

1. **学习者先讲,AI 后介入。** 在展示权威定义、教材解释或标准流程之前,先收集学习者自己的解释。没有初始解释,就没有费曼循环。
2. **一次只修最小缺口。** 从解释中找出当前最关键的 1–2 个断点,不把整本教材一次性砸给学习者。
3. **追问优先于代答。** 先用最少的问题帮助学习者自己补全因果链。只有多次追问仍卡住且用户允许时,才提供必要事实或支架。
4. **理解必须经得住改写和迁移。** 能背术语不等于理解;学习者要能去掉术语、说明类比边界,并在陌生情境中重新解释。
5. **材料只提供事实,不抢占初始解释。** 教师上传的材料用于确定概念边界和校验事实,不作为第一页直接展示的标准答案。

## 页面内容红线

以下词属于规划语言,只能写在对话、brief 或 roster 设计中,不得作为学生可见的标题、标签或栏目:`Teach-back`、`Jargon Challenge`、`Transfer`、`v1/v2/v3`、`概念定界`、`缺口诊断`、`类比破坏测试`、`费曼循环`、`概念变化轨迹`。

学生可见标题要写成可执行动作,例如:

- “先把它讲给一个没学过的人听”;
- “你讲到哪一步卡住了?”;
- “换掉这几个词,再讲一遍”;
- “这个类比会在哪里失效?”;
- “到一个新情境里试试”。

老师和学生代理的口述、追问与讨论放进 narration / actions,不写成“老师说”“小白说”的静态页面正文。

## 先确定三个约束

页面计划前明确:

1. **concept boundary**:本轮只解释哪个可学习的核心概念,明确不覆盖什么;
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add thu-maic/openmaic/feynman-learning@sha256:af7d9eaca12896a4

The line at the top of this page pins the label git:20260827.0462157, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_w3zrbeigsnalabim.svg)](https://markdownregistry.com/a/art_w3zrbeigsnalabim)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Aug 27, 2026.

versioncommittedcommitsizeaudit
git:20260827.0462157 latest2026-08-27 0462157 8,215 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8215 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

thu-maic/openmaic · 42,430 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_w3zrbeigsnalabim
GET https://markdownregistry.com/api/v1/resolve?ref=thu-maic/openmaic/feynman-learning
GET https://markdownregistry.com/api/v1/blob/af7d9eaca12896a498259cbae3fa09d196d455b4e72af75d63ed1d1575ca944e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from thu-maic/openmaic

AGENTS.md AGENTS.md file
thu-maic/openmaic · AGENTS.md
git:20261027.76009ef · audit A · 42,430 stars
DESIGN.md@packages/@openmaic/importer DESIGN.md file
thu-maic/openmaic · packages/@openmaic/importer/DESIGN.md
git:20260624.7cb1291 · audit A · 42,430 stars
importer SKILL.md skill
thu-maic/openmaic · packages/@openmaic/importer/SKILL.md
git:20260624.7cb1291 · audit C · 42,430 stars
DESIGN.md@packages/@openmaic/renderer DESIGN.md file
thu-maic/openmaic · packages/@openmaic/renderer/DESIGN.md
git:20260727.ff95e66 · audit A · 42,430 stars
build-personal-skill SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/build-personal-skill/SKILL.md · Evidence-based creation of a reusable personal course-making Skill from the user's own classroom and chat history. Use…
git:20260827.0462157 · audit A · 42,430 stars
curriculum-planner SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/curriculum-planner/SKILL.md · Multi-stage series — a request for several classrooms that belong together, like 「7 天学 Python」, a four-week onboarding…
git:20260904.4cfc7c1 · audit A · 42,430 stars
deep-interactive SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/deep-interactive/SKILL.md · Deep Interactive courses. Plans the course so the learner manipulates something on most pages — simulations, diagrams…
git:20260827.0462157 · audit A · 42,430 stars
deep-research SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/deep-research/SKILL.md · Courses whose content rests on current, external or real-world facts that must be verified against live sources before…
git:20260827.0462157 · audit A · 42,430 stars
fact-check SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/fact-check/SKILL.md · Improve factual reliability while creating or reviewing a course or supplied content. Use when the user asks to…
git:20260828.3cd174b · audit A · 42,430 stars
k12-core-literacy-planning SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/k12-core-literacy-planning/SKILL.md · Chinese K-12 core-literacy course design for a single OpenMAIC classroom. Use when a teacher asks for…
git:20260827.0462157 · audit A · 42,430 stars
learning-to-learn SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/learning-to-learn/SKILL.md · Infuse learning strategies and metacognition into a concept-centered OpenMAIC classroom as a parallel goal. Use when…
git:20260827.0462157 · audit A · 42,430 stars
lecture-style SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/lecture-style/SKILL.md · Masterclass lecturing — one continuous explanation carried by slides, with dense pages, long narration that builds an…
git:20260827.0462157 · audit A · 42,430 stars

Every file in thu-maic/openmaic

Other files named feynman-learning

feynman-learning SKILL.md skill
health-525/courseraptor · skills/feynman-learning/SKILL.md · Turn any concept, lesson, slide deck, or source material into a Feynman learning cycle in which learners explain first…
git:20261015.d92c95a · audit A · 44 stars

Browse by kind, by grade A, or by owner.