didactic-notes
Didactic Notes: Literate Pedagogy
This skill documents pedagogical design decisions in educational materials, analogous to how literate programming documents code design decisions.
Reference Files
This skill includes detailed references in references/:
| File | Content | Search patterns |
|---|---|---|
latex-examples.md |
Restatable LOs, citations, complete examples | restatable, \cref{}, biblatex |
beamer-patterns.md |
Mode splits, overlays, verbose environments | \mode<article>, uncoverenv, \textbytext |
semantic-environments.md |
Environment selection, generalizations | definition, remark, example, block |
Core Principle
Document not just what you teach, but why you teach it that way.
Just as literate programming makes code reasoning explicit, didactic notes make pedagogical reasoning explicit using \ltnote{...} from the LaTeX didactic package.
More from dbosk/claude-skills
latex-writing
|
147literate-programming
CRITICAL: ALWAYS activate this skill BEFORE making ANY changes to .nw files. Use proactively when: (1) creating, editing, reviewing, or improving any .nw file, (2) planning to add/modify functionality in files with .nw extension, (3) user asks about literate quality, (4) user mentions noweb, literate programming, tangling, or weaving, (5) working in directories containing .nw files, (6) creating new modules/files that will be .nw format. Trigger phrases: 'create module', 'add feature', 'update', 'modify', 'fix' + any .nw file. Never edit .nw files directly without first activating this skill to ensure literate programming principles are applied. (project, gitignored)
6variation-theory
Apply variation theory of learning to structure instructional content using contrast, generalization, and fusion patterns. Variation must target the critical aspects of the learning objective. Use when writing educational materials, explanations, tutorials, literate programming documentation (.nw files), structuring lecture slides, designing exercises, or when user mentions variation theory, learning theory, pedagogy, or critical aspects of learning. Works alongside the literate-programming skill for .nw files.
5canvas-quiz
|
5try-first-tell-later
Structure educational content using try-first-tell-later pedagogy where students predict, attempt, or reflect before receiving explanations. Creates active learning through cognitive engagement and variation theory's contrast patterns. Use when writing educational materials, designing exercises, creating lecture notes, structuring tutorials, writing teaching examples with LaTeX/Beamer, developing problem sets, or when user mentions try-first, predict-first, productive failure, Socratic method, question-before-answer, exercise-driven learning, or inquiry-based teaching.
5canvas-info
|
4