CtrlK
BlogDocsLog inGet started
Tessl Logo

understanding-by-design

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.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-crafted, token-efficient instruction skill: a clearly sequenced three-stage backward-design workflow with explicit checkpoints, a per-page validation heuristic, a quality-gate checklist, and clean integration with sibling skills. The only gap is the absence of worked examples — a sample enduring understanding, essential question, GRASPS task, or a brief template would make the otherwise concrete guidance fully copy-paste ready.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — it gives concrete counts ("用 1–3 句声明持久理解", "写出 1–2 个基本问题"), page-type mappings, and terse WHERETO breakdowns without ever explaining what UbD is or padding with background Claude already knows. Every line instructs, matching the anchor-5 example of assuming competence.

5 / 5

Actionability

Guidance is highly concrete and executable: the six GRASPS elements are spelled out and mapped to page types ("在 OpenMAIC 中优先落到 pbl 页"), and a numbered six-step default page rhythm (slide → slide → interactive → quiz/interactive → pbl → quiz/slide) covers the common case. It falls short of anchor 5 only because there are no worked examples — no sample enduring understanding, essential question, or GRASPS task, and no brief template despite instructing "把它们写进页面 brief".

4 / 5

Workflow Clarity

The backward-design sequence is clearly ordered (scope → Stage 1 desired results → Stage 2 assessment evidence → Stage 3 learning experiences → page rhythm), with an explicit user-confirmation checkpoint ("先得到用户对单元蓝图的确认,再逐节起稿"), a per-page validation test with remediation ("每一页都能回答……答不出的页面删除或改写"), and a closing quality-gate checklist — matching the anchor for explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The skill has no bundle files, and the compact (~64 line) body keeps all content appropriately in SKILL.md with clear section headers; nothing here warrants a separate reference file. References to sibling skills (stage-design, pro-editing, pptx-import) are one level deep and clearly signaled, satisfying the simple-skill standard.

5 / 5

Total

19

/

20

Passed

Description

90%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit what and when with concrete, natural trigger terms including synonyms and abbreviations, plus explicit negative triggers that cleanly separate it from adjacent style/import skills. The only weakness is that the skill's concrete actions are compressed into a single "plan" verb, with the framework terms serving as trigger objects rather than enumerated capabilities.

DimensionReasoningScore

Specificity

The description names the domain ("Understanding by Design (UbD)" for OpenMAIC classrooms) and one concrete action — "plan one OpenMAIC classroom or a course series around transferable conceptual understanding" — but the enumerated items in the when-clause (backward design, enduring understandings, GRASPS, WHERETO) are user wants rather than additional skill actions, so coverage of what the skill does is not comprehensive. It sits at anchor 3 rather than 4 because only one explicit action verb is present, versus the several specific actions anchor 4 requires.

3 / 5

Completeness

It explicitly answers both questions: what ("plan one OpenMAIC classroom or a course series around transferable conceptual understanding") and when ("Use when the user wants backward design, enduring understandings, essential questions, GRASPS performance evidence, WHERETO learning experiences, or a concept-centered lesson"), with concrete trigger phrases and an explicit negative trigger ("Do not use for visual style cloning, teacher-style imitation, or direct PPT import").

5 / 5

Trigger Term Quality

Natural term coverage is comprehensive: full name and abbreviation ("Understanding by Design (UbD)"), the phrase practitioners actually use ("backward design"), framework-specific terms ("enduring understandings", "essential questions", "GRASPS performance evidence", "WHERETO learning experiences"), and a plain-language synonym ("concept-centered lesson rather than a list of facts"). A user wanting this skill would almost certainly use one of these terms.

5 / 5

Distinctiveness Conflict Risk

The niche is distinct (UbD concept-centered lesson design for OpenMAIC) with framework-specific triggers unlikely to fire for other skills, and the explicit exclusions ("Do not use for visual style cloning, teacher-style imitation, or direct PPT import") route adjacent requests to the correct sibling skills, minimizing conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
THU-MAIC/OpenMAIC
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.