learning-design-review

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.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "learning-design-review" with this command: npx skills add vishalsachdev/claude-skills/vishalsachdev-claude-skills-learning-design-review

Learning Design Review

Evaluate educational content against the Four Learning Design Pillars - an evidence-based framework synthesized from multimedia learning research, cognitive load theory, and UX best practices.

Skill Purpose

This skill provides structured reviews of educational content by evaluating it against 46 research-based principles organized into four pillars:

  1. Pillar 1: Clear, Purposeful Structure - Content organization, design consistency, learning path clarity, adaptive design
  2. Pillar 2: Active, Engaging Learning Content - Content design, multimedia elements, engagement techniques, quality standards
  3. Pillar 3: Continuous Practice & Feedback - Practice variety, feedback mechanisms, metacognition support
  4. Pillar 4: Simple, Intuitive UX - Navigation, accessibility, media controls

Usage

Invoke this skill when users say things like:

  • "Review this course against learning design principles"
  • "Evaluate my lesson plan"
  • "Check if my tutorial follows best practices"
  • "Analyze this e-learning module"
  • "Review this educational content"

Workflow

Step 1: Gather the Content

Ask the user to provide the educational content in one of these formats:

To review your content against the Four Learning Design Pillars, please provide it in one of these ways:

1. **File path** - Path to a document, HTML file, or course export
2. **URL** - Link to a publicly accessible course page or lesson
3. **Pasted text** - Copy and paste the content directly
4. **Description** - Describe the course structure and key elements

What would you like me to review?

Step 2: Load the Principles

Read the principles file to ensure access to all current principle definitions:

{SKILL_DIR}/../principles/learning-design-pillars.yaml

Note: {SKILL_DIR} refers to this skill's directory. When installed at ~/.claude/skills/learning-design-pillars/, the principles file is at ~/.claude/skills/learning-design-pillars/principles/.

This file contains the complete framework with 4 pillars, 13 categories, and 46 principles.

Step 3: Analyze Content Against Each Pillar

Evaluate the content systematically against each pillar. For each pillar, identify:

  • Strengths: What the content does well (cite specific principle IDs)
  • Areas for Improvement: Where the content falls short (cite specific principle IDs)
  • Evidence: Specific examples from the content supporting your assessment

Pillar 1: Clear, Purposeful Structure (Principles 1.1.1-1.4.2)

Evaluate:

  • Content segmentation and organization (1.1.x)
  • Design consistency and formatting (1.2.x)
  • Learning objectives and alignment (1.3.x)
  • Adaptive and learner-controlled elements (1.4.x)

Pillar 2: Active, Engaging Learning Content (Principles 2.1.1-2.4.4)

Evaluate:

  • Content presentation and visual design (2.1.x)
  • Multimedia and interactive elements (2.2.x)
  • Engagement and relevance techniques (2.3.x)
  • Quality, accuracy, and accessibility (2.4.x)

Pillar 3: Continuous Practice & Feedback (Principles 3.1.1-3.3.4)

Evaluate:

  • Practice variety and authenticity (3.1.x)
  • Feedback quality and timeliness (3.2.x)
  • Metacognition and reflection support (3.3.x)

Pillar 4: Simple, Intuitive UX (Principles 4.1.1-4.3.2)

Evaluate:

  • Navigation and orientation (4.1.x)
  • Accessibility and device optimization (4.2.x)
  • Media controls and time estimates (4.3.x)

Step 4: Calculate Scores

Score each pillar on a 1-5 scale:

ScoreRatingDescription
5ExemplaryConsistently demonstrates best practices across all principles
4StrongGood alignment with most principles, minor gaps
3DevelopingMeets basic requirements, notable improvement areas
2EmergingSignificant gaps, limited alignment with principles
1BeginningMajor redesign needed across most principles

Calculate an overall weighted score (equal weight per pillar).

Step 5: Generate the Review Report

Produce a structured report using this format:

# Learning Design Review

**Content Reviewed:** [Name/description of content]
**Review Date:** [Date]
**Overall Score:** [X.X/5.0] - [Rating]

---

## Executive Summary

[2-3 sentence overview of key findings]

---

## Pillar 1: Clear, Purposeful Structure
**Score: X/5**

### Strengths
- [Strength 1] (Principle X.X.X)
- [Strength 2] (Principle X.X.X)

### Areas for Improvement
- [Gap 1] (Principle X.X.X): [Specific recommendation]
- [Gap 2] (Principle X.X.X): [Specific recommendation]

---

## Pillar 2: Active, Engaging Learning Content
**Score: X/5**

### Strengths
- [Strength 1] (Principle X.X.X)
- [Strength 2] (Principle X.X.X)

### Areas for Improvement
- [Gap 1] (Principle X.X.X): [Specific recommendation]
- [Gap 2] (Principle X.X.X): [Specific recommendation]

---

## Pillar 3: Continuous Practice & Feedback
**Score: X/5**

### Strengths
- [Strength 1] (Principle X.X.X)
- [Strength 2] (Principle X.X.X)

### Areas for Improvement
- [Gap 1] (Principle X.X.X): [Specific recommendation]
- [Gap 2] (Principle X.X.X): [Specific recommendation]

---

## Pillar 4: Simple, Intuitive UX
**Score: X/5**

### Strengths
- [Strength 1] (Principle X.X.X)
- [Strength 2] (Principle X.X.X)

### Areas for Improvement
- [Gap 1] (Principle X.X.X): [Specific recommendation]
- [Gap 2] (Principle X.X.X): [Specific recommendation]

---

## Priority Recommendations

Ranked by impact and effort:

1. **[High Priority]** [Recommendation] (Addresses: X.X.X, X.X.X)
   - Why: [Rationale]
   - How: [Specific action steps]

2. **[Medium Priority]** [Recommendation] (Addresses: X.X.X)
   - Why: [Rationale]
   - How: [Specific action steps]

3. **[Lower Priority]** [Recommendation] (Addresses: X.X.X)
   - Why: [Rationale]
   - How: [Specific action steps]

---

## Quick Wins

Small changes with immediate impact:
- [ ] [Quick win 1]
- [ ] [Quick win 2]
- [ ] [Quick win 3]

Principle Reference Quick Guide

When citing principles, use the hierarchical ID system:

  • 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)

Example citations:

  • "Clear learning objectives at module start (1.3.1)"
  • "Short, focused video segments under 5 minutes (2.2.3)"
  • "Low-stakes practice quizzes with unlimited attempts (3.1.6)"
  • "Mobile-responsive layout (4.2.3)"

Notes

  • Always reference specific principle IDs to make feedback actionable
  • Prioritize recommendations by impact on learning outcomes
  • Consider the content's context (audience, constraints, platform)
  • Focus on actionable suggestions, not just critique
  • When in doubt about a rating, err toward constructive feedback

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Coding

paper-writing

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

chartjs-generator

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

infographic-generator-p5

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

map-generator

No summary provided by upstream source.

Repository SourceNeeds Review