worked-example-fading-designer

Installation
SKILL.md

Worked Example Designer with Completion Fading

What This Skill Does

Designs a complete scaffold sequence that moves students from studying a fully worked example through progressively faded completion problems to independent practice. For a given procedure or skill, it produces: (1) a worked example with annotated reasoning at each step, (2) a series of completion problems where successive steps are removed, and (3) independent practice problems. AI is specifically valuable here because effective worked examples require expert-level annotation of reasoning (not just showing steps, but explaining why each step is taken), and the fading sequence requires careful calibration of which steps to remove and in what order — a task requiring deep knowledge of both the subject content and the cognitive load research.

Evidence Foundation

Sweller & Cooper (1985) demonstrated that novice learners who studied worked examples learned more effectively than those who attempted problem-solving, because worked examples reduce extraneous cognitive load — students can focus on understanding the procedure rather than searching for a solution path. Atkinson et al. (2000) synthesised the worked examples research and identified key design principles: examples must include explanatory annotations (not just steps), and the transition from examples to independent practice should be gradual. Renkl (2014) refined the theory, showing that self-explanation prompts embedded in worked examples significantly enhance learning because they promote germane processing. The fading approach — where worked examples gradually omit steps, creating "completion problems" — was shown by van Merriënboer & Kirschner (2018) to be more effective than an abrupt transition from examples to problems. Critically, Kalyuga et al. (2003) demonstrated the expertise reversal effect: worked examples that help novices become counterproductive for advanced learners, who learn better from problem-solving. This means fading must be calibrated to student expertise.

Input Schema

The teacher must provide:

  • Skill to teach: The specific procedure or skill. e.g. "Solving simultaneous equations by elimination" / "Writing a topic sentence for an analytical paragraph" / "Balancing chemical equations"
  • Student level: Year group and expertise. e.g. "Year 9, first encounter (novice)" / "Year 11 revision (developing)"
  • Steps in procedure: Approximate number of steps. e.g. 5

Optional (injected by context engine if available):

  • Common errors: Known errors students typically make. e.g. ["Forgetting to multiply both sides", "Sign errors when subtracting equations"]
Related skills
Installs
10
GitHub Stars
216
First Seen
Apr 2, 2026