Most teaching time goes into fixing material you already have, not writing new material. This guide covers the three ways to change a lesson that already exists in Roshi: edit the blocks by hand, ask Roshi to change it, or re-level it against CLB.
Before you start
Open the lesson from Saved Lessons. Every change below is saved to the lesson you have open, so if you started from a curated lesson you are editing your own copy and the original is untouched.
1. Edit blocks by hand
A lesson is an ordered list of blocks: a reading, a vocabulary list, questions, a dialogue, an exercise. Adjusting a lesson is usually a matter of removing blocks rather than rewriting them.
Every block has a Menu in its top right. It contains:
Move to Top, Move Up, Move Down, Move to Bottom for reordering.
Hide Block, which keeps the block in your lesson but leaves it out of what students and printouts see. This is the quickest way to teach one lesson to two levels.
Duplicate, Copy to other lesson, and Delete.
Styles, and options specific to the block type, such as Audio Options, Create cloze exercise, Create matching exercise, Create fill-in-the-blank questions, and Print Flashcards.
Those last few are worth knowing: you can turn a reading you already have into a cloze exercise, or a vocabulary list into a matching exercise, without writing either from scratch.
To edit the words themselves, click into any text. Full walkthrough: Create and edit lesson segments.
2. Ask Roshi to change it
Ask Roshi is the AI panel on the left of the lesson editor.
Click Ask Roshi to help make edits. Roshi asks How would you like me to help? and offers three routes:
Edit a specific section, when you know which block is wrong.
Edit the lesson as a whole, for anything that spans blocks, like levelling or length.
Add CLB-based tasks, covered in Create an assessment.
The chat opens, showing what it is pointed at as a label such as Lesson: Field Trip. Type what you want in plain language. Be specific about the outcome, not the mechanics:
"Simplify the reading to a beginner level and keep it about the same length."
"Rewrite the questions so they are all multiple choice."
"Shorten this lesson to 30 minutes of class time."
"Change the names and places to a Canadian context."
Roshi replies with a Proposed plan, a numbered list of what it intends to do, before changing anything. If your request was ambiguous it says how it interpreted it, for example which of three similar readings it picked.
Read the plan, then click Execute plan. Or click Cancel, or add a correction in Type to add additional instructions and let it re-plan.
After the change runs, use Undo Changes on the result if it is not what you wanted. There is also an Undo control in the top bar.
Each block also has its own Ask Roshi to edit this block button, named for the block you are on, such as Ask Roshi to edit this dialogue or Ask Roshi to edit this vocabulary list. Use that when only one block is wrong; it saves you describing which one you mean.
Reset chat starts the conversation over if it has drifted.
The Auto-apply switch at the top of the panel skips the plan step for simple, unambiguous additions such as adding a vocabulary list. Anything broad, destructive, or ambiguous still asks you first, and you can always undo.
Full walkthrough: Intro to Ask Roshi panel.
3. Re-level a CLB lesson
If the lesson was built from a CLB template, the Ask Roshi panel offers a CLB Assistant button with two choices:
Add CLB-Based Tasks builds new tasks against the benchmarks you pick.
Modify with CLB re-levels the material you already have. Roshi proposes a Change Plan, one item at a time, each with an Include checkbox. Untick anything you do not want, add anything missing under Additional changes, then run it.
Set the level once, for every new lesson
If you keep asking for the same level, set it as a default instead. Roshi asks for a target level each time you start a new lesson, and you can set it permanently under Preferences on the Lessons page.
If something goes wrong
Roshi changed more than you asked. Use Undo Changes, then ask again using Ask Roshi to edit this block on the single block you meant.
The plan looks wrong. Click Cancel instead of Execute. Nothing has been changed yet.
Roshi picked the wrong block. It tells you which one it chose. Cancel, and either name the block in your request or use that block's own Ask Roshi button.
You want the original back. Curated lessons are never modified, so take a fresh copy from Collections > Lessons.