understanding-by-design SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

understanding-by-design from health-525/courseraptor is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add health-525/courseraptor/understanding-by-design@git:20261015.d92c95a

Pins git:20261015.d92c95a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
health-525/courseraptor
Path
skills/understanding-by-design/SKILL.md
Versions recorded
1
Latest version
git:20261015.d92c95a, committed Oct 15, 2026
Size
4,211 bytes
Repository stars
36
License
MIT

Use Understanding by Design (UbD) to plan one OpenMAIC classroom or a course series around transferable conceptual understanding. Use when the user wants backward design, enduring understandings, essential questions, GRASPS performance evidence, WHERETO learning experiences, or a concept-centered lesson rather than a list of facts. Do not use for visual style cloning, teacher-style imitation, or direct PPT import.

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

# 理解本位设计(UbD)

用 UbD 逆向设计组织一节课或一组系列课:先明确学生最终要理解什么、如何证明真正理解,再设计学习经历。

`stage-design` 仍然约束新课堂的持久化顺序;本 Skill 约束教学设计与每页 brief 的内容。已有页面的课堂按 `pro-editing` 做局部编辑,不要重建课堂。

## 先确定设计范围

- **单节独立课**:在本课内走完整三阶段。
- **单元或系列课**:先以整个单元为单位确定大概念、总基本问题与单元表现性任务,再为每节课拆出子理解、子问题与子评估。先得到用户对单元蓝图的确认,再逐节起稿。

只有当用户的请求不足以判断单节还是系列时,才用 `ask_user` 确认范围。

## 阶段一:确定预期结果

1. 用 1–3 句声明**持久理解(Enduring Understanding)**:学生离开课堂后仍能保留并迁移的思想,而不是事实清单。
2. 写出 1–2 个**基本问题(Essential Question)**:开放、可持续讨论、没有唯一答案,并能在课程中反复回到。
3. 用基本问题打开课程第一页,把抽象概念变成一个需要探究的真实问题。

## 阶段二:先确定评估证据

在写页面计划前定义学生如何证明理解:

- **表现性任务(GRASPS)**:写清 Goal、Role、Audience、Situation、Product 和 Standards,在 OpenMAIC 中优先落到 `pbl` 页。
- **概念诊断与辨析**:用 `quiz` 暴露典型错误概念,要求学生给出理由,不只是选项。
- **迁移与应用**:用 `interactive` 或新情境任务观察学生能否把理解用到变化后的问题中。

表现性任务是学习路径的终点,前面的页面都要为它提供概念、证据或练习,不要在课程末尾突然加一个没有铺垫的任务。

## 阶段三:用 WHERETO 设计学习经历

用 WHERETO 检查每个活动,并把它们写进页面 brief:

- **W — Where & Why**:学生知道学习要去哪里、为什么值得学。
- **H — Hook**:用真实、有冲突的情境或问题引出基本问题。
- **E — Equip**:用 `slide` 提供建立概念所需的证据与逻辑链。
- **E — Experience**:用 `interactive` 让学生操作、模拟或亲手做出概念。
- **R — Rethink & Revise**:换一个情境让学生重新应用并修正理解。
- **T — Tailor**:为不同起点的学生提供支架与挑战。
- **O — Organize**:页面顺序让理解逐步生成,最后回到基本问题。

## OpenMAIC 页面节奏
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add health-525/courseraptor/understanding-by-design@sha256:75af8be3ec7772b6

The line at the top of this page pins the label git:20261015.d92c95a, 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_6gvbtgrghpaesrwn.svg)](https://markdownregistry.com/a/art_6gvbtgrghpaesrwn)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 15, 2026.

versioncommittedcommitsizeaudit
git:20261015.d92c95a latest2026-10-15 d92c95a 4,211 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 (4211 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

health-525/courseraptor · 36 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6gvbtgrghpaesrwn
GET https://markdownregistry.com/api/v1/resolve?ref=health-525/courseraptor/understanding-by-design
GET https://markdownregistry.com/api/v1/blob/75af8be3ec7772b6ae97ac70ceedbb00fcfbb16a6d4addceb5f62ec0b3614808

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 health-525/courseraptor

AGENTS.md AGENTS.md file
health-525/courseraptor · AGENTS.md
git:20261015.d4b5895 · audit A · 36 stars
ai-news SKILL.md skill
health-525/courseraptor · skills/ai-news/SKILL.md · 采集 AI 行业动态、生成有来源的中文日报,查询突发简报和本地近期趋势。用于 AI 新闻、模型动态、开源雷达和行业日报;学校教务通知使用教务工具。
git:20261019.3e69194 · audit A · 36 stars
build-personal-skill SKILL.md skill
health-525/courseraptor · skills/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:20261015.d92c95a · audit A · 36 stars
curriculum-planner SKILL.md skill
health-525/courseraptor · skills/curriculum-planner/SKILL.md · Multi-stage series — a request for several classrooms that belong together, like 「7 天学 Python」, a four-week onboarding…
git:20261015.d92c95a · audit A · 36 stars
deep-interactive SKILL.md skill
health-525/courseraptor · skills/deep-interactive/SKILL.md · Deep Interactive courses. Plans the course so the learner manipulates something on most pages — simulations, diagrams…
git:20261015.d92c95a · audit A · 36 stars
deep-research SKILL.md skill
health-525/courseraptor · skills/deep-research/SKILL.md · Courses whose content rests on current, external or real-world facts that must be verified against live sources before…
git:20261015.d92c95a · audit A · 36 stars
export-schedule SKILL.md skill
health-525/courseraptor · skills/export-schedule/SKILL.md · 把本地课表缓存渲染成课表图片(第 N 周或整学期,PNG/SVG,红头档案或彩色课格两种风格)。 当用户说「导出课表」「导出课表图片」「把课表导出来」「本周/这周课表图」「第 N 周…
git:20261003.3433f28 · audit B · 36 stars
export-schedule SKILL.md skill
health-525/courseraptor · skills/export-schedule/package/SKILL.md · 课表图片导出技能(独立包,本地渲染)。把课表渲染成图片文件——第 N 周课表或 整学期汇总,PNG/SVG,红头档案或彩色课格两种风格。当用户说「导出课表」 「导出课表图片」「把课表导出来」「本周/这周课表图」「第 N 周课表图片」…
git:20261012.2724d8e · audit B · 36 stars
fact-check SKILL.md skill
health-525/courseraptor · skills/fact-check/SKILL.md · Improve factual reliability while creating or reviewing a course or supplied content. Use when the user asks to…
git:20261015.d92c95a · audit A · 36 stars
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 · 36 stars
k12-core-literacy-planning SKILL.md skill
health-525/courseraptor · skills/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:20261015.d92c95a · audit A · 36 stars
learning-to-learn SKILL.md skill
health-525/courseraptor · skills/learning-to-learn/SKILL.md · Infuse learning strategies and metacognition into a concept-centered OpenMAIC classroom as a parallel goal. Use when…
git:20261015.d92c95a · audit A · 36 stars

Every file in health-525/courseraptor

Other files named understanding-by-design

understanding-by-design SKILL.md skill
thu-maic/openmaic · skills/agent-runtime/understanding-by-design/SKILL.md · Use Understanding by Design (UbD) to plan one OpenMAIC classroom or a course series around transferable conceptual…
git:20260827.0462157 · audit A · 41,208 stars

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