Coding

Cognitive Load Theory

Try it

Diagnose why learners are struggling and redesign instruction to stay within working memory limits.

What it does

Applies Cognitive Load Theory to identify when training, documentation, or onboarding exceeds working memory capacity. The skill diagnoses intrinsic load, eliminates extraneous load, and maximizes germane load — then provides a step-by-step coaching process to redesign materials. Works best when the problem is cognitive, not motivational.

When to use it

  • Redesigning an overwhelming onboarding flow
  • Fixing documentation that users abandon
  • Diagnosing why a training course isn't landing
  • Reducing cognitive load in a user interface

The skill document

Cognitive Load Theory

Overview

Working memory holds ~4 chunks of novel information — a hard limit. Instruction that exceeds it produces no learning regardless of effort. CLT (Sweller 1988) identifies three load types: intrinsic (task complexity), extraneous (poor presentation), germane (schema-building effort). Target: minimize extraneous, manage intrinsic by sequencing low-to-high element-interactivity, maximize germane.

Composes with metacognition (learners aware of limits pace themselves), deep-work (same working-memory conditions), and api-and-interface-design (UX design = instructional design).

When to Use

  • Designing training, documentation, onboarding, or instructional material
  • Learners aren't understanding despite good intent and reasonable material
  • Diagnosing why a course / tutorial / interface is underperforming
  • Someone says "cognitive load," "working memory," "too much at once," "this is overwhelming"

Not when: audience is already expert (expertise-reversal); bottleneck is motivational not cognitive.

Coaching Novices (Adaptive Front Door)

  • Engine mode: user has a concrete design problem → run The Process directly.
  • Coach mode: user is unfamiliar → guide step by step.

In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.

  1. One-line: when learners aren't getting it, check if working-memory load exceeds capacity — the fix is usually to reduce extraneous load, not add more explanation.
  2. Check fit. If audience is expert, novice-friendly CLT techniques may backfire (expertise-reversal).
  3. Elicit the specific failure. Who's learning what, where stuck, what's the current instruction?

[WAIT — do not advance until user responds]

  1. Diagnose load types one question at a time: intrinsic too high? Extraneous load sources? Expertise match?

[WAIT — do not advance until user responds]

  1. Close: redesigned instruction with specific CLT effects applied + test with target learners.

[WAIT — do not advance until user responds]

The Process

Step 1 — Diagnose: Who is learning (expertise level) · What · Where stuck · Current instruction format · Overload signals (frustration, drop-off, error patterns).

Step 2 — Identify load types: Intrinsic (element interactivity, 1-5) · Extraneous sources (split attention / redundancy / wrong modality / irrelevant info / confusing notation) · Germane opportunity.

Step 3 — Reduce extraneous load: Split-attention → integrate diagram + label · Redundancy → cut duplicated text · Modality → narration over diagram, not text + text · Irrelevant → cut.

Step 4 — Match expertise: Novice: worked examples + heavy scaffolding · Intermediate: partial solutions + faded scaffolding · Expert: free problem-solving (CLT scaffolding now hurts — expertise reversal).

Step 5 — Maximize germane load: Sequence concrete→abstract · Use contrast to force schema-building · Pose questions before answers · Variable practice (same deep structure, different surface).

Step 6 — Test and iterate: Comprehension test with target learner (not designer) · Measure time-to-mastery · Track error patterns · Cut more extraneous load if struggle persists.

Output Template

# CLT-Informed Design: 
Learner (expertise): | Material: | Stuck point: | Overload signals:
Intrinsic load (1-5): | Extraneous sources: | Germane opportunity:
CLT effects applied: | Expertise match (novice/intermediate/expert):
Test plan: target learner · comprehension test · iteration trigger · owner

→ Method in Action: Sweller 1988 and the Development of CLT

Pack: CLT Application Patterns

DomainHigh-extraneous mistakeCLT fix
Software docsLong prose separated from codeIntegrate code + commentary; dual-modality
Onboarding"Read these 12 documents"Worked example: walk through 1 real task end-to-end
Training videosTalking head + bullet slidesDiagram + narration; cut redundant text
User interfacesMany simultaneous optionsProgressive disclosure; group related items
Code reviewMany unrelated changes in one PRSplit PRs by concern; one change at a time

Applying It Well

  • The right response to "they're not learning" is usually to cut extraneous load, not add more content.
  • Instructional design matters more than subject-matter expertise — a CLT-aware non-expert beats an oblivious expert.
  • Expertise-reversal is real: differentiate instruction for novices vs. experts; one-size-fits-all hurts one group.

→ Primary sources: references/sources.md

Common Rationalizations

[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.

Fake moveReality
[D] "Smart people can handle it"Working memory is hard-capped at ~4 chunks regardless of intelligence.
[D] "More information is better"False above capacity threshold — additional content above the limit produces no learning.
[D] "We can't cut anything — it's all important"Redundancy effect: cutting duplicated content improves comprehension.
[D] "Discovery learning is more engaging"Often true, but empirically poor for novices — imposes high extraneous load. Scaffold first.
[D] "Worked examples are passive"Sweller 1988: worked examples produce more learning than unaided problem-solving for novices.
[D] "Add another diagram to clarify"If it duplicates existing content, redundancy effect makes things worse. Replace, don't add.
→ Add [O] entries here after each real use — paste the actual failure patternWhat went wrong and why

Red Flags

  • Learners abandon training/docs at the same point repeatedly
  • "It's just complex" explains high failure rates without examining presentation
  • Instruction untested with target audience before deployment
  • Highly expert author unaware of expertise-reversal
  • Diagram and its explanation physically separated

Verification

  • Intrinsic, extraneous, and germane load identified separately
  • At least one CLT effect (split-attention, redundancy, modality) applied
  • Expertise level specified and instruction matched to it
  • Tested with target learners (not self-reviewed)
  • Comprehension or completion metrics measured

Part of deciqAI Knowledge Skills — 227 open-source thinking skills that make rigor executable for AI agents. The same skills power every deciqAI agent, which runs them autonomously to operate your company. See it run → https://www.deciqai.com/c/cognitive-load-theory · ⭐ Star the repo → https://github.com/deciqAI/knowledge-skills · Contributions welcome.

Agents: latest version & machine-readable metadata → https://www.deciqai.com/s/cognitive-load-theory.json

Questions people ask

When should I use this skill?
When learners aren't understanding despite good content, or when someone says they're overwhelmed or it's too much to take in at once. Not when the audience is already expert (expertise-reversal applies) or the bottleneck is motivational.
What does the coaching process involve?
It follows 6 steps: diagnose the learner and failure point, identify load types, reduce extraneous load, match instruction to expertise level, maximize germane load, then test with target learners. The skill guides one step at a time with hard stops.
What common mistakes does it catch?
Split-attention layouts (diagram separated from explanation), redundant content, wrong modality (text + text instead of diagram + narration), irrelevant information, and scaffolding that was designed for novices but deployed to experts.

Related skills

Diagnose which mental domain is holding you back before choosing a cognitive intervention.

by deciqai1 installs3 stars

Diagnose why people know what to do but don't do it, then design a behavior-changing nudge without mandates or incentives.

by deciqai1 installs3 stars

Escape skill plateaus by targeting the specific mental representations experts use, not just the hours you log.

by deciqai1 installs3 stars

Tests whether you genuinely understand something or just recognize it — exposes the gaps in your mental model.

by deciqai1 installs2 stars

Know whether you're qualified to make a decision before you make it

by deciqai1 installs3 stars

Design ethical commitment ladders or break free when past choices are pulling you off course.

by deciqai1 installs3 stars

More from deciqai

Browse all skills

Diagnose your organization's strategic phase and spot misaligned initiatives before they drain momentum.

by deciqai7 installs2 stars

When multiple explanations all fit the evidence, pick the one that assumes the least.

by deciqai5 installs2 stars

Identify catastrophic failure paths before you commit — and design your plan around eliminating them.

by deciqai4 installs2 stars

Trace decisions past the obvious effect to catch the consequences that reverse it.

by deciqai4 installs2 stars

A structured interview and analysis process that uncovers the actual job customers hire your product to do — and who they're really competing against.

by deciqai3 installs3 stars

Identify the real reason users say one thing and do another, then name the one intervention to test.

by deciqai3 installs2 stars