AI Lesson Generation

Who this is for

Teachers who want to draft lesson content quickly with AI and then refine it in the Lex Editor.

What this page answers

• Which AI entry point should I use?
• How do I prepare a generation brief?
• What should I review before publishing the result?

Prerequisites

• a course or lesson where you can generate content
• enough token balance to start generation

AI generation happens inside the editor. Use it to create a full lesson draft, add a single section, or start from a preset and customize the result.

Choose the right entry point

Configure Special Sections

Some sections expose extra controls before generation:

• Pronunciation — add teacher-supplied target words or short phrases when you want the drill to use your exact vocabulary. Speakly uses the course language automatically.
• Category Sort — can be generated as its own section and can include items that fit more than one valid category when the ambiguity is intentional.
• Handwriting Check — set the student instructions, maximum number of uploaded images, and the mistake categories teachers should review.
• Teacher annotations — template notes are for teacher guidance. They help you organize the lesson draft, but they are not inserted into the AI prompt as hidden student instructions.

Configure lesson style

The Lesson Builder includes a Lesson Style field. Use it to tell the generator what kind of lesson document you need before sections are written.

Common styles include:

• teacher-led one-to-one lesson
• communicative practice
• narrative self-study
• task-based flow

Choose the style before generation. It affects the shape of instructions, transitions, activity pacing, and how much teacher scripting the draft includes.

1. Write a focused brief

The quality of the result depends on how specific you are. Include:

• the lesson theme
• CEFR level
• target and native language
• lesson length or scope
• notes about what to include or avoid

Good prompts are narrow and instructional, for example:

• Spanish A2 lesson on reflexive verbs in morning routines
• English B1 reading lesson about travel delays with vocabulary and comprehension practice

2. Generate the draft

Fill in the form and start generation. Generation runs in two visible phases:

1. Planning — the system prepares the lesson structure from your brief.
2. Generating — the system writes the lesson content. The progress UI shows a timer and the number of generated characters so you can see that generation is still moving.

There is no separate lesson-plan preview in the current UI. Course-correct before generation by making the brief specific, then review the generated draft carefully afterward. If you realize during generation that the brief was wrong, use Stop and re-run with a tighter prompt.

Generate one section instead of a full lesson

Use AI Generate Section when the lesson already exists and you only need one missing part. This is the fastest way to add a warm-up, vocabulary block, reading task, pronunciation drill, writing task, game, brain break, or summary without replacing the whole lesson.

1. Place the cursor where the section should go.
2. Open AI Generate Section or Section Insert.
3. Choose the section type and configure its options.
4. Add a focused instruction if the section must match a specific text, vocabulary set, or exam part.
5. Generate, review, and edit before saving.

Use this workflow after a live class when you noticed a gap, or when Ask AI produced a good idea that needs to become a structured block.

3. Review before you trust the result

Treat the generated lesson as a strong first draft, not finished teaching material. Always review:

• accuracy of grammar, translation, and examples
• level fit for your students
• exercise answer quality
• answer explanations and teacher annotations
• tone and clarity
• widget configuration, generated media, and AI-created audio

Fast widget review

Use Enter widget edit mode to review generated exercises quickly. This toolbar button switches all exercise widgets in the lesson document into edit mode so you can scan correct answers, options, instructions, scoring settings, and generated widget content without opening each widget one by one.

After checking, click the same button again to exit widget edit mode and return the lesson to normal student-facing behavior. Do not leave the lesson with all widgets still in edit mode.

Finish generated media widgets

Some generated widgets intentionally appear in edit mode after generation. This is expected for content that needs teacher approval before the final asset is created, such as:

• image prompts
• audio dialogues
• other widgets that expose a Generate action

Open the widget, review the prompt or script, make corrections if needed, then click Generate. If you skip this step, the widget remains an editable placeholder instead of becoming finished lesson content.

Prepare AI audio before assigning

Some widgets, including Pronunciation, may need teacher-side clicks during lesson preparation so AI audio such as text-to-speech is generated and cached before the lesson is assigned.

This matters when the lesson uses a policy where the student pays for AI content. If the student has no token balance, student-side AI actions can be blocked. Prepare and cache required AI audio as the teacher before assigning the lesson when you want the student to receive a ready-to-use activity.

4. Edit it in the Lex Editor

Once the draft is in the editor, make it yours:

• rewrite explanations in your teaching voice
• remove sections you do not need
• add media, comments, or extra practice
• reorder sections to fit your lesson flow
• use Clear answers to reset all test responses before assigning the lesson to students

5. Save, publish, and track reuse

After review:

1. save the lesson
2. set the lesson status you want
3. publish the course content only when it is ready for students
4. check Generation History if you need to review earlier outputs

Related pages

• Lex Editor Guide
• Lesson Builder & Lesson Blocks
• Materials Library
• Exam Preparation
• Billing & Tokens