didactic-notes

Document pedagogical design decisions in LaTeX materials using \ltnote commands.

1|1|Updated Nov 4, 2025
One-click install
npx skills add https://github.com/dbosk/claude-skills --skill didactic-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: didactic-notes
Source: https://github.com/dbosk/claude-skills/tree/main/didactic-notes
Command: npx skills add https://github.com/dbosk/claude-skills --skill didactic-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires didactic.

What problem does it solve?

Educators often create materials without explicitly documenting the pedagogical reasoning behind their design choices. This skill helps you embed "didactic notes" directly into LaTeX educational content, making the "why" of teaching explicit for future instructors, authors, and researchers, saving time in understanding and adapting materials.

Core Features & Use Cases

  • Pedagogical Documentation: Guides the use of the \ltnote{...} command from the didactic LaTeX package to document learning objectives, theoretical connections, and design rationale.
  • Learning Theory Integration: Ensures notes connect to established learning principles like Variation Theory, Try-First Pedagogy, and Cognitive Load Theory, providing a robust theoretical foundation.
  • Audience-Specific Views: Allows toggling notes on/off (\ltnoteon/\ltnoteoff) for different audiences (instructors vs. students), streamlining content delivery.
  • Use Case: When designing a LaTeX lecture on recursion, you can add a \ltnote next to an activity to explain, "This activity uses try-first pedagogy to activate prior knowledge before we formally define the concept."

Quick Start

I am writing a LaTeX document for a course. Guide me on how to add didactic notes using the \ltnote command to explain my pedagogical design choices.

Frequently Asked Questions about didactic-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document pedagogical reasoning directly in LaTeX educational materials?

Use the `\ltnote{...}` command from the didactic LaTeX package to embed pedagogical notes explaining your design choices, learning objectives, and theoretical connections directly into your educational content. Notes appear as margin annotations and can be toggled on or off for different audiences.

How do I add pedagogical design notes to LaTeX course materials using the didactic package?

Load the didactic package with `\usepackage[marginparmargin=outer]{didactic}`, then wrap pedagogical explanations in `\ltnote{...}` commands next to activities, exercises, or content. Use `\ltnoteon` and `\ltnoteoff` to control visibility for instructors versus students.

Can I toggle pedagogical notes on and off for different audiences in LaTeX?

Yes. The didactic package supports `\ltnoteon` and `\ltnoteoff` commands to enable or disable pedagogical notes globally, letting you show detailed design rationale to instructors while presenting clean student-facing materials without notes.

What learning theory frameworks can I reference in pedagogical notes for LaTeX materials?

Didactic notes support connections to established frameworks including Variation Theory, Try-First Pedagogy, and Cognitive Load Theory. Document which principle justifies your sequencing, example choice, or exercise design by citing the theory explicitly in your `\ltnote{...}` annotations.

Do I need prior knowledge of LaTeX to use pedagogical notes in educational materials?

You need working LaTeX knowledge to edit educational documents and include packages. The didactic package itself requires only basic command syntax—adding `\ltnote{...}` and toggling commands—making it accessible once you're comfortable with your LaTeX workflow.

Why document pedagogical design choices separately from student-facing content?

Separating pedagogical justification into `\ltnote{...}` margin notes preserves clean student materials while creating an explicit record of your design rationale for future instructors, authors, and researchers—reducing time spent reverse-engineering why content is structured a particular way.