Writing a language lesson that teaches
Teaching ideas for your connected AI and for anyone creating lessons manually. Adapt them to the learner; choose the activities that serve the lesson.
Connected AIs can read this same guide through languages_get_brief with includeLessonGuide: true.
A lesson teaches; its tools support the teaching
Write as a teacher helping a particular learner accomplish something. A lesson plan should contain the explanations, worked examples, coached attempts and connections that make its activities useful. A sequence of buttons labelled flashcards, reading and quiz is an activity playlist, not sufficient teaching.
The site supports substantial teaching inside the lesson itself. Use teaching blocks with examples, inline readings with translations and pronunciation cues, private audio with an exact transcript, and self-assessment questions. Link a saved reading or list when a dedicated reader or practice session helps. A lesson does not need a separate reading record for every paragraph, a list for every idea, or audio for every explanation. Choose the shape that serves the learning goal.
Find the real starting point
Begin with the learner’s purpose, previous experience and current evidence. “Beginner Hebrew” may mean no script knowledge, a fluent script reader with little vocabulary, or someone who has studied grammar but cannot follow a passage. “Advanced French” does not mean every literary idiom is known. Ask a small meaningful diagnostic when needed: can the learner locate the beginning of a word, recognize a target form, or explain a short clause without translation?
State prerequisites in the lesson description and opening. Give a graceful way to start foundations or skip material already understood. For a learner who knows no Hebrew letters, a guided Genesis verse is not the first script lesson. Start with reading direction, letters versus points, a small letter set and real words. Then use supported verses while later foundations continue. Fast learning means reducing repetition once evidence supports it; it does not mean hiding missing prerequisites.
Define a bounded, observable achievement
Prefer “recognize three written words and follow where each begins” or “distinguish the call for light from the reported event in Genesis 1:3” over “learn Hebrew” or “master grammar.” Include the support allowed: with points, with pronunciation, with word help, or without the English translation. Choose an honest time estimate and a small amount of new material.
A first foundations lesson can teach six letters, one final shape and a few vowel patterns. Label that as a first set, not the whole alphabet. A first guided reading can support unfamiliar forms without claiming independent decoding. In later lessons, revisit the same material with less support or a fresh example. Explain what success today will make easier next.
Teach before asking the learner to practise
Introduce a useful idea in plain language, show exactly how it works, and invite a small attempt. Make the steps visible: where to look, what to compare, how to decide, and how to check. Explanations should resolve likely beginner confusion rather than merely announce that a topic matters.
For example, do not simply say Hebrew runs right to left. Show אוֹר; identify א as the rightmost first letter, וֹ in the middle, and ר as the ending. Explain that the point is not another large letter. Ask the learner to locate the beginning again. Then connect the whole word to light. Keep a worked example close to the instruction so the learner can inspect it without navigating away.
Use meaningful contrasts and coached examples
A contrast often teaches more than a definition. Compare a word with and without an attached article, a literal gloss with its contextual sense, a request with its result, or two similar characters with different meanings. Start with one fully worked example, follow with an example that invites a decision, then offer an explanation. Do not introduce a dozen unexplained forms merely to make a lesson long.
In Genesis 1:3, show יְהִי אוֹר as a call for light and וַיְהִי־אוֹר as the narrative result. Explain the complete forms in their clauses; do not invent a universal rule that any added ו mechanically changes tense. In a literary Italian lesson, teach an idiom in its passage before asking for the meaning in a new context. Check grammar and source claims, including exceptions relevant to the learner’s example.
Keep different skills separate
Written shape recognition, pronunciation, spoken-word understanding, contextual meaning and production are related but different. Teach and assess the skill the learner needs. Someone learning to consume Biblical Hebrew scripture can use sound as a memory aid without needing conversation or an accent test. Someone returning to Mandarin may understand a spoken word while its character is entirely unfamiliar.
For Mandarin, build listening and meaning practice alongside a smaller character track. Offer pinyin or the learner’s preferred pronunciation display as support, then reduce it when appropriate for that track. A Hebrew → English or Chinese → meaning card result does not establish English → Hebrew production, spelling or character writing. Make the practiced direction and any support clear to yourself when interpreting results.
Give every linked activity a teaching purpose
Before flashcards, state the actual set size, what the forms have in common, why these were selected, and what to think about before flipping. Prepare a useful contrast the learner can carry into the cards. Before a reading, explain what to notice, which supports to keep visible, and how to handle an unfamiliar word. Before a quiz, explain the taught skills it checks and how to learn from an error.
For a five-form Genesis set, teach recognition of light, God, said, let there be and there was; explicitly contrast the two similar verb forms. For the reading, ask the learner to find the repeated noun and identify action, actor, directive and result. A link alone does not tell the learner how to use the tool well. Keep descriptions concise when the activity already explains its mechanics.
Make listening purposeful
Write the lesson and exact transcript before creating an audio clip. Decide whether audio is an English explanation, target-language reading, listening stimulus, or a combination. Label what the clip covers: one section, a short example, or a whole lesson. Do not suggest that a short introduction contains the expanded written teaching. Provide a visible player, pause and speed controls, and a transcript the learner can open when appropriate.
A useful listening sequence is: listen once with a specific question; listen again with text or pronunciation support; check the meaning; then try a final pass with less support. For a reading-focused learner, finding a repeated word while following print can be enough. For an auditory comprehension quiz, avoid displaying its transcript before the attempt unless the task deliberately allows it. Treat supported reading and unaided listening as different evidence.
Separate checked quizzes from self-assessment
A checked quiz asks a question with an assessable answer and an explanation. A self-assessment asks how the learner experienced the task, which supports were needed, or what should happen next. Both are useful; neither should pretend to be the other. Put the checked comprehension task before the final self-assessment when that sequence makes sense.
Self-assessments may ask about independence with a passage and about the lesson overall. Keep their prompts distinct, let the learner answer either or both, and offer one compact quiz panel with a clear position such as 1 of 2. Notes belong to the selected self-assessment answer. Questions should give meaningful choices: shapes slow versus meaning unknown, independent versus translation-supported, or needs another example versus already easy.
Interpret feedback without overstating it
Review checked answers, errors, hints or transcript support, flashcard direction and ratings, and dated self-reports together. Completion means the learner marked the activity done; it does not establish mastery. A correct multiple-choice answer may show recognition with choices rather than recall without them. Easy in one direction does not prove the reverse direction. A learner’s note can explain why a score underestimates or overestimates readiness.
Use results to choose a next lesson: repeat one contrast, give a fresh worked example, add a small set of forms, reduce support, or introduce a transfer passage. Change vocabulary stages or ability labels only when the evidence and the learner’s requested workflow justify the change. Do not silently move every completed lesson’s words into a learned list.
Choose a creative form that fits the goal
There is no required seven-section template. A close-reading lesson can unpack one difficult passage, teach its idioms and a grammatical pattern, then revisit it with less help. A listening lesson can tell a brief story, ask a prediction, replay one important exchange, and check meaning. A foundations lesson can introduce a few shapes through real words, contrast confusable forms, and check a new ordering.
A grammar lesson can begin with a puzzling sentence, show two contrasting examples, explain the rule, and invite the learner to explain a new example. A lesson for an experienced learner can start with “which of these are already familiar?” and spend teaching effort on the unknown forms. Write enough actual teaching for each section’s purpose; a long introduction cannot compensate for several empty activity sections.
Create private content and spend deliberately
Personalized lessons and readings belong to the learner’s private account by default. Store a standalone reading when it merits its own reader, durable annotations or reuse; otherwise an inline reading is appropriate. Record where sourced text came from and its rights. Original teaching and glosses should be labelled as original rather than attributed to a published translation. Public catalog publication is a separate deliberate action.
Audio generation uses a paid provider. Reuse suitable saved clips and retain the exact transcript and spoken language when attaching one. Generate selectively, explain the intended scope when cost matters, and preserve an operation ID on retries so a repeated request does not buy the same clip twice. Opening a saved player is playback, not new audio generation. A strong text-only lesson is preferable to paying for audio that does not improve its learning task.
Revise lessons without erasing the learner’s history
Use current record versions when revising. Keep a self-assessment’s key, prompt and choices when it remains the same question; changing the question should not make a previous answer look like an answer to the replacement. Preserve existing source references and audio transcripts unless deliberately replacing them. Do not fabricate completion, attempts or ratings while creating content.
A materially changed teaching activity may need renewed completion, while historical answers remain evidence from their original version. Keep feedback visible enough for the learner and available to their AI. Use the manual lesson editor and MCP capabilities as two ways of creating the same supported content, rather than making useful teaching possible only through a hidden script.
A short authoring check and Hebrew references
Before saving, read the lesson as the learner: do its prerequisites match them, does each section teach or coach something, can they see a worked example before a demand, do linked activities have the right content and counts, and do the checks test only what was taught? Verify source text, grammar, translations and pronunciation claims. Avoid presenting a mnemonic, approximate pronunciation or contextual gloss as an exhaustive rule.
The Genesis examples were checked against the text at https://www.mechon-mamre.org/p/pt/pt0101.htm ; useful foundational references include the alphabet and vowel teaching materials by Gary D. Pratico and Miles V. Van Pelt hosted at https://hebrew.billmounce.com/BasicsBiblicalHebrew-01.pdf and https://hebrew.billmounce.com/BasicsBiblicalHebrew-02.pdf . The word glosses father and water were checked against J. Beckman’s vocabulary reference at https://hebrewsyntax.org/bbh2new/00_vocabulary.pdf . These materials are references, not text licensed for wholesale copying. Write original teaching and verify exact pointed forms. Pronunciation traditions differ; label the chosen cue style.