Diagnose which mental domain is holding you back before choosing a cognitive intervention.
Coding
Cognitive Load Theory
Try itDiagnose 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.
- 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.
- Check fit. If audience is expert, novice-friendly CLT techniques may backfire (expertise-reversal).
- Elicit the specific failure. Who's learning what, where stuck, what's the current instruction?
[WAIT — do not advance until user responds]
- Diagnose load types one question at a time: intrinsic too high? Extraneous load sources? Expertise match?
[WAIT — do not advance until user responds]
- 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
| Domain | High-extraneous mistake | CLT fix |
|---|---|---|
| Software docs | Long prose separated from code | Integrate code + commentary; dual-modality |
| Onboarding | "Read these 12 documents" | Worked example: walk through 1 real task end-to-end |
| Training videos | Talking head + bullet slides | Diagram + narration; cut redundant text |
| User interfaces | Many simultaneous options | Progressive disclosure; group related items |
| Code review | Many unrelated changes in one PR | Split 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 move | Reality |
|---|---|
| [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 pattern | What 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 why people know what to do but don't do it, then design a behavior-changing nudge without mandates or incentives.
Escape skill plateaus by targeting the specific mental representations experts use, not just the hours you log.
Tests whether you genuinely understand something or just recognize it — exposes the gaps in your mental model.
Know whether you're qualified to make a decision before you make it
Design ethical commitment ladders or break free when past choices are pulling you off course.
More from deciqai
Browse all skillsDiagnose your organization's strategic phase and spot misaligned initiatives before they drain momentum.
When multiple explanations all fit the evidence, pick the one that assumes the least.
Identify catastrophic failure paths before you commit — and design your plan around eliminating them.
Trace decisions past the obvious effect to catch the consequences that reverse it.
A structured interview and analysis process that uncovers the actual job customers hire your product to do — and who they're really competing against.
Identify the real reason users say one thing and do another, then name the one intervention to test.