Lesson Writer

Write course lessons that teach cleanly and do not all read the same.

Most generated course content collapses into one shape: hook, "here is how it works," three bullets, a summary that restates the hook. Twelve lessons in, the reader is skimming. This skill fixes that with a section palette you draw from per lesson and a rotation rule that forbids two lessons in a row from using the same shape.

Two things are separated here. The engine (section variety, procedural rules, HTML output) lives in this file. The voice (word choices, stance, phrasing) lives in a single file you swap out.

Step 0: Load the voice profile

Before writing anything, read the voice profile:

1. If the project has voice-profile.md at its root or in .claude/, use that one.
2. Otherwise read ${CLAUDE_SKILL_DIR}/voice-profile.md, the profile shipped with this skill.
3. If the user names a different profile file, that one wins.

Everything in the profile beats everything in this file. When the profile says "no rhetorical questions" and a section below suggests one, follow the profile.

State which profile you loaded in one line before the draft, so the user knows what they are getting.