Learning Design Review
Evaluate educational content against 46 research-based principles in four pillars.
Workflow
Step 1: Gather Content
Ask user to provide content as: file path, URL, pasted text, or description of course structure.
Step 2: Load Principles
Read: ~/.claude/skills/learning-design-pillars/principles/learning-design-pillars.yaml
This file contains 4 pillars, 13 categories, and 46 principles with verification checks.
Step 3: Analyze Against Each Pillar
For each pillar, identify Strengths, Gaps, and Evidence (specific examples). Always cite principle IDs.
- 1.x.x Structure — segmentation, consistency, objectives, adaptive design
- 2.x.x Content — presentation, multimedia, engagement, quality
- 3.x.x Practice — variety, feedback, metacognition
- 4.x.x UX — navigation, accessibility, media control
Step 4: Score
| Score |
Rating |
Description |
| 5 |
Exemplary |
Best practices across nearly all principles |
| 4 |
Strong |
Good alignment, minor gaps |
| 3 |
Developing |
Core requirements met, notable gaps |
| 2 |
Emerging |
Significant gaps |
| 1 |
Beginning |
Major redesign needed |
Overall = average of 4 pillar scores.
Step 5: Generate Report
# Learning Design Review
**Content:** [Name/description]
**Date:** [Date]
**Overall Score:** [X.X/5.0] - [Rating]
## Executive Summary
[2-3 sentences]
## Pillar 1: Clear, Purposeful Structure
**Score: X/5**
### Strengths
- [Finding] (Principle X.X.X)
### Areas for Improvement
- [Gap] (Principle X.X.X): [Specific recommendation]
[Repeat for Pillars 2-4]
## Priority Recommendations
1. **[High Priority]** [Action] (Addresses: X.X.X)
- Why: [Rationale]
- How: [Steps]
2. **[Medium Priority]** [Action] (Addresses: X.X.X)
## Quick Wins
- [ ] [Small change with immediate impact]
- [ ] [Small change with immediate impact]
Principle ID Reference
- 1.x.x = Structure (Organization, Consistency, Learning Path, Adaptive)
- 2.x.x = Content (Design, Multimedia, Engagement, Quality)
- 3.x.x = Practice (Variety, Feedback, Metacognition)
- 4.x.x = UX (Navigation, Accessibility, Media Control)
Notes
- Prioritize by impact on learning outcomes
- Consider content context (audience, constraints, platform)
1---2name: learning-design-review3description: Review educational content against the Four Learning Design Pillars framework. Use when users want to evaluate course materials, lessons, tutorials, e-learning modules, or any instructional content for alignment with evidence-based learning design principles. Provides structured feedback with specific principle references (e.g., 1.1.1, 2.3.4) and actionable recommendations. Triggers on "review this course", "evaluate my lesson", "check best practices", or "analyze this module".4---56# Learning Design Review78Evaluate educational content against 46 research-based principles in four pillars.910## Workflow1112### Step 1: Gather Content1314Ask user to provide content as: file path, URL, pasted text, or description of course structure.1516### Step 2: Load Principles1718Read: `~/.claude/skills/learning-design-pillars/principles/learning-design-pillars.yaml`1920This file contains 4 pillars, 13 categories, and 46 principles with verification checks.2122### Step 3: Analyze Against Each Pillar2324For each pillar, identify **Strengths**, **Gaps**, and **Evidence** (specific examples). Always cite principle IDs.2526- **1.x.x Structure** — segmentation, consistency, objectives, adaptive design27- **2.x.x Content** — presentation, multimedia, engagement, quality28- **3.x.x Practice** — variety, feedback, metacognition29- **4.x.x UX** — navigation, accessibility, media control3031### Step 4: Score3233| Score | Rating | Description |34|-------|--------|-------------|35| 5 | Exemplary | Best practices across nearly all principles |36| 4 | Strong | Good alignment, minor gaps |37| 3 | Developing | Core requirements met, notable gaps |38| 2 | Emerging | Significant gaps |39| 1 | Beginning | Major redesign needed |4041Overall = average of 4 pillar scores.4243### Step 5: Generate Report4445```markdown46# Learning Design Review4748**Content:** [Name/description]49**Date:** [Date]50**Overall Score:** [X.X/5.0] - [Rating]5152## Executive Summary53[2-3 sentences]5455## Pillar 1: Clear, Purposeful Structure56**Score: X/5**5758### Strengths59- [Finding] (Principle X.X.X)6061### Areas for Improvement62- [Gap] (Principle X.X.X): [Specific recommendation]6364[Repeat for Pillars 2-4]6566## Priority Recommendations67681. **[High Priority]** [Action] (Addresses: X.X.X)69 - Why: [Rationale]70 - How: [Steps]71722. **[Medium Priority]** [Action] (Addresses: X.X.X)7374## Quick Wins75- [ ] [Small change with immediate impact]76- [ ] [Small change with immediate impact]77```7879## Principle ID Reference8081- **1.x.x** = Structure (Organization, Consistency, Learning Path, Adaptive)82- **2.x.x** = Content (Design, Multimedia, Engagement, Quality)83- **3.x.x** = Practice (Variety, Feedback, Metacognition)84- **4.x.x** = UX (Navigation, Accessibility, Media Control)8586## Notes8788- Prioritize by impact on learning outcomes89- Consider content context (audience, constraints, platform)