claude-teacher

Use this when a course under authoring/outputs is fully designed and needs to be compiled into a runnable pack under runtime/courses. Transforms DSL into the runtime layout without inventing content.

Interview a course author and fill in the course-level section of course.yaml for a new claude-teacher course. Use this as the first step of authoring a new course, before any modules or lessons are designed. Outputs a course.yaml skeleton that /design-module and /design-lesson will extend.

Deep-dive interview to design a single lesson within a claude-teacher course. Produces the lesson.md body, rubric.md, hints.md (with a graduated hint ladder), and examples.md. Use after /design-course and /design-module, when the author is ready to flesh out a specific lesson.

Use this when a course already has course-level goals in course.yaml and the author needs to break it into thematically-focused modules before designing individual lessons.

Use this as a QA pass before shipping a compiled course. Checks hint ladders, rubric signals, lesson length, submission paths, and completion criteria, then files a report. Does not auto-fix.

Mid-lesson progress check for claude-teacher. Compares the learner's current artifacts against the lesson rubric, updates the progress file, and tells the learner what's still missing. Does NOT mark the lesson complete — that is /review-submission. Use when the learner says "I think I'm done", "can you check where I am", or when they run this directly.

Start a claude-teacher course. Run this once, in the Teacher Terminal, before the learner begins. Verifies the course exists, checks prerequisites, initialises the progress directory, and proposes the first lesson. Use when a learner says they want to "start a course", "begin learning X", or when they run this command directly.

Reveal the next hint level for the current claude-teacher lesson. Hints are a ladder — this skill reveals exactly one rung higher than the learner's current hint_level_max, never skips. Use when the learner is stuck, says "give me a hint", "I'm blocked", or asks for help beyond what the lesson already says.

Start a specific lesson within a claude-teacher course. Run from the Teacher Terminal. Loads the lesson definition, creates the lesson's progress file, proposes the first prompt the learner should type in the Work Terminal, and initialises a Claude Code task list for in-session UI. Use when a learner wants to begin or resume a specific lesson.

Capture a learner's own-words reflection on a completed (or nearly completed) claude-teacher lesson. Writes it to the submissions directory and updates the progress file's self-reliance signals. Use after /review-submission, or when a learner says "I want to write up what I learned", or when they run this directly.

Formal review and close-out of a claude-teacher lesson. Runs the full rubric, produces a written review for the learner, and — if and only if every rubric item passes — marks the lesson complete in the progress and course-state files. Use when the learner says they want to "submit", "finish the lesson", or "close this out", or when they run this directly.