Review workshop content for pedagogical effectiveness
Purpose: Review workshop content for pedagogical effectiveness, learning progression, and instructional design.
When to use: After grammar review is complete and content is ready for pedagogical review.
Prerequisites:
This skill performs a pedagogical review that checks:
This review focuses on HOW WELL the workshop teaches, not grammar/formatting.
MUST READ:
- WORKSHOP-PLAN.md (intended design)
- HOW-TO-BUILD-WORKSHOPS.md (methodology)
- asciidoc/courses/how-we-teach/modules/1-introduction/lessons/2-pedagogy/lesson.adoc
- CONTENT_GUIDELINES.md
REFERENCE:
- All lesson.adoc files in workshop
- All module.adoc files
Create PEDAGOGY-REVIEW-PROGRESS.md:
# Pedagogy Review Progress
**Workshop:** [Name]
**Reviewer:** Pedagogy Review Skill
**Date:** [Date]
## Overall Structure
**Modules:** [N]
**Lessons:** [N] total ([X] required, [Y] optional)
**Duration:** [X] hours core, [Y] hours with optional
## Building Block Progression
- [ ] Module 2: "[Building block 1]" ✓
- [ ] Module 3: "[Building block 2]" ✓
- [ ] Module 4: "[Building block 3]" ✓
- [ ] Module 5: "[Final integration]" ✓
## Review Checklist
### Module 1: [Name]
- [ ] Lesson 1: Pedagogical review
- [ ] Lesson 2: Pedagogical review
- [ ] Lesson 3: Pedagogical review
[Continue for all modules...]
## Issues Found
- Issue: [Description]
- Issue: [Description]
## Review Complete
- Scaffolding verified: Yes/No
- Building blocks stack: Yes/No
- Duration realistic: Yes/No
Required structure:
Module 1: Setup and Introduction (15-20 min)
├── Lesson 1: Workshop Overview (REQUIRED - explains goal)
├── Lesson 2-3: Environment setup
└── Lesson 4: Tool overview (SOURCE OF TRUTH for mechanics)
Modules 2-N: Building Blocks (20-30 min each)
├── Learn: Concept lesson
├── Do: Challenge lesson
├── Verify: Validation/query lesson
└── Practice: Optional practice (marked :optional: true)
Final Module: Integration and Review (15-20 min)
├── Integration lesson or final query
├── Knowledge check quiz (REQUIRED)
└── Triggers completion modal
Check:
:optional: true?Verify each module completes a clear transformation:
Module 2: "Products exist in graph" ✓
└─> Module 3: Uses products, adds "Customer→Order path" ✓
└─> Module 4: Uses both, adds "Customer→Order→Product path" ✓
└─> Module 5: Combines all for "Recommendation query" ✓
Check:
Example good building block markers:
This completes **Building Block 1**: "Products exist in the graph" ✓
This completes **Building Block 2**: "Customer→Order path complete" ✓
Issues to flag:
Module N: [Building Block]
├── Lesson 1: [Concept] (Learn) - 3-5 min
│ └─> Teaches 1-2 concepts
├── Lesson 2: [Challenge] (Do) - 7-12 min
│ └─> Applies concepts from Lesson 1
├── Lesson 3: [Validation] (Verify) - 3-5 min
│ └─> Queries what was built in Lesson 2
│ └─> Shows SQL comparison
└── Lesson 4: [Optional Practice] - 5-15 min (optional)
└─> Additional practice on same structure
Check:
Issues to flag:
For each concept lesson, verify:
Opening scaffolding:
Content:
Summary:
Issues to flag:
For each challenge lesson, verify:
Structure:
Pedagogy:
Connection:
Issues to flag:
For each validation lesson, verify:
Structure:
Pedagogy:
SQL Comparisons:
Issues to flag:
For each optional practice lesson, verify:
Metadata:
:optional: trueOpening:
Content:
Issues to flag:
:optional: trueFor each quiz lesson, verify:
Metadata:
:type: quiz:sequential: true (if questions build on each other)Questions:
[.question] marker (NOT .freetext)Pedagogy:
Final Lesson:
Issues to flag:
.freetext instead of .question)For each lesson, check:
Does it reference what came before?
Does it prepare for what comes next?
Is the difficulty progression smooth?
Issues to flag:
By lesson type:
By module:
Total workshop:
Issues to flag:
Check each lesson for:
Does it state WHY this matters for the goal?
Can you trace from lesson to final goal?
Example good connections:
You can now traverse Customer → Order → Product paths.
To build a recommendation query, you'll extend this pattern: find customers who bought similar products, then recommend products they haven't purchased yet.
This multi-hop traversal pattern is the foundation for collaborative filtering.
Issues to flag:
Ideal flow:
Check:
Issues to flag:
Update PEDAGOGY-REVIEW-PROGRESS.md with results:
# Pedagogy Review Complete
**Workshop:** [Name]
**Date Completed:** [Date]
## Summary Assessment
### Overall Structure: ✅ Pass / ❌ Fail
- First lesson is overview: [Yes/No]
- Building blocks stack: [Yes/No]
- Learn → Do → Verify pattern: [Yes/No]
- Final lesson triggers completion: [Yes/No]
### Scaffolding: ✅ Pass / ❌ Fail
- Lessons build on previous: [Yes/No]
- Smooth difficulty progression: [Yes/No]
- Concepts before application: [Yes/No]
### Duration: ✅ Pass / ❌ Fail
- Core path ≈ 2 hours: [Actual: X hours]
- Individual lessons appropriate: [Yes/No]
- Pacing balanced: [Yes/No]
### Goal Connection: ✅ Pass / ❌ Fail
- Goal clearly stated: [Yes/No]
- All lessons connect to goal: [Yes/No]
- Goal achieved in final lesson: [Yes/No]
## Issues Found
### Critical Issues (Must Fix)
1. [Issue description]
2. [Issue description]
### Moderate Issues (Should Fix)
1. [Issue description]
2. [Issue description]
### Minor Issues (Nice to Fix)
1. [Issue description]
2. [Issue description]
## Recommendations
1. [Recommendation]
2. [Recommendation]
3. [Recommendation]
## Ready for Next Review Phase
✅ Pedagogy review complete
**Next step:** Use `workshop-review-technical` skill for technical accuracy review.