teaching-notes-writing
Installation
SKILL.md
Teaching Notes Writing
This is a portable writing skill: usable standalone, and loaded by openpress-create-pages when page content is learner-facing teaching material (handouts, worksheets, study guides, tutorial chapters). openpress-create-pages owns the trigger and conflict-resolution rules.
Teaching notes are for learners who are still building the mental model. This skill provides suggested content skeletons, explanation strategies, examples, practice ideas, and answer-flow guidance. It does not mandate one rigid chapter template.
Responsibilities
- Start from the learner's likely mental model.
- Compare nearby ideas before introducing formal rules.
- Show procedures step by step with visible state changes.
- Put reasons, warnings, and interpretation in prose rather than overloading figures.
- Suggest practice surfaces that match the chapter content.
- Put answers after the learner has had a chance to try.
- Suggest when a structure, relationship, or state change should become a diagram; use
openpress-diagram-drawingfor the actual diagram semantics.