teaching-notes-writinglisted
Install: claude install-skill quan0715/open-press
# 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-drawing` for the actual diagram semantics.
## Boundaries
- `openpress-create-pages` owns public-content hygiene and H1/H2/H3/H4 structure for page-based artifacts.
- `openpress-diagram-drawing` owns diagram semantics.
- `openpress-create-pages` owns page visual style and component implementation.
- `openpress` owns CLI, validation/export/render commands, and source/generated boundaries.
- This skill owns learner-facing explanation suggestions