---
name: lernluchs-lektionen
description: Create and check lesson files (.lernluchs) for the Lernluchs flashcard app for German school students (vocabulary, maths tasks, fact questions, dictation, picture words). Use when asked to write Karteikarten, Lernkarten, Vokabeln, Lektionen or a lesson for Lernluchs, to turn a textbook page or worksheet into Lernluchs cards, or to review, fix or translate an existing .lernluchs file.
license: Free to use and share. Written for lernluchs.app.
---

# Lernluchs lessons

Lernluchs is an iPhone and iPad app in which a child practises flashcards in short rounds (and can lock chosen apps until a round is done). A **lesson** is one JSON file with the ending `.lernluchs`. Opening it on the device ("In Lernluchs öffnen", AirDrop, Messages, Mail, Files) shows the cards for review, and the child or parent saves them. This skill makes you write such files correctly and **check them before handing them over**, because the app checks every typed answer automatically by comparing text: a card with two right answers, a wrong result or an answer a child cannot type is worse than no card.

Cards and lessons are written in **German** (the foreign side of vocabulary and foreign-language picture words in the language taught).

## Workflow

1. **Find out what is needed**, asking only what is missing: subject, grade (Klassenstufe 1 to 13), topic or source (a photo, a vocabulary list, a worksheet, a chapter), number of cards (10 to 30 is a good lesson), kinds of cards if the user cares. A photographed page can only be used if you can see images; otherwise ask for the text.
2. **Choose the kinds** that fit the subject (table below). Read `references/cards.md` for the exact shapes and the rules for good cards.
3. **Write the cards** in the card JSON format below, in a file `cards.json`.
4. **Build and check**: `python3 scripts/lernluchs_lektion.py build cards.json -o "<Lesson name>.lernluchs" --strict`. It writes the file only if there are no errors (and, with `--strict`, no warnings), and tells you what the app would drop, refuse or get wrong. Fix and repeat. To check a file you did not write: `python3 scripts/lernluchs_lektion.py check file.lernluchs`.
5. **Review yourself** with `references/review-checklist.md`. The script cannot know whether a fact is true or a question is clear: re-derive every number and every fact independently, leave a card out rather than risk a wrong answer.
6. **Deliver** the `.lernluchs` file and say how to open it (below). Mention what you were unsure about.

No code execution available? Write the final file directly (format in `references/format.md`) and run the checklist by hand, including recomputing every number card.

## Which kinds for which subject

| Subject | Kinds | Notes |
|---|---|---|
| Foreign language (Englisch, Französisch, Latein, ...) | `word`, `sentence`, `dictation`, `spelling`, `fact` | `question` is the foreign side, `answer` the German side. `dictation` and `spelling` words in the foreign language, nouns with its article (Spanisch "el perro"; Englisch and Latein without article). |
| Deutsch | `dictation`, `spelling`, `fact` | Grades 1 to 4: words that practise spelling patterns (ie, ck, tz, ß, Dehnungs-h, St/Sp, ä). Nouns with article: "die Biene". |
| Mathe and other number subjects | `number`, `fact` | Every task with one number as the answer is `number`. |
| Biologie, Geschichte, Physik, Erdkunde, ... | `fact` (and `number` where it is a calculation) | One short, unambiguous answer. |

## Card JSON (what you write)

`cards.json`: `{"lesson": "Short German title", "subject": "Biologie", "cards": [ ... ]}`. The subject applies to the whole lesson and decides the voice language for dictation and picture words, so set it.

```json
{"kind": "number", "question": "7 · 8", "work": "7 · 8 = 56; 56 : 8 = 7", "answer": "56"}
{"kind": "fact", "question": "In welchem Teil der Zelle findet die Zellatmung statt?", "answer": "(in den) Mitochondrien", "alternatives": ["Mitochondrium"], "wrong": ["im Zellkern", "in den Ribosomen", "in den Chloroplasten"]}
{"kind": "word", "question": "(to) go", "answer": "gehen"}
{"kind": "sentence", "question": "How much is it?", "answer": "Wie viel kostet das?"}
{"kind": "dictation", "answer": "die Biene", "emoji": ""}
{"kind": "spelling", "emoji": "🐶", "answer": "der Hund"}
```

- **number**: `answer` is only the number, digits with a German decimal comma (`3,5`), a minus sign if negative, no unit, no thousands separator. Name the unit in the question. `work` is for you: compute step by step and check with the inverse operation before writing `answer` (the script recomputes plain expressions and rejects a wrong result).
- **fact**: `answer` at most four words, no comma, no full sentence. Words the child may leave out in round brackets, especially the article: `(die) Fotosynthese`. `alternatives` for equally right spellings or synonyms. `wrong` exactly three wrong options of the same type and length, plausible but clearly wrong: while the card is new, the child picks from four options.
- **word** / **sentence**: foreign-language vocabulary only. Several German meanings separated by `;`, optional parts in brackets. A sentence is compared as one text.
- **dictation**: one word the app reads aloud and the child writes (exact spelling, capitals included). `emoji` normally empty; only for words that sound alike (Meer / mehr) one emoji that shows which one is meant.
- **spelling**: a picture word. `emoji` is the picture (one emoji that shows exactly this thing); the card is exact like a dictation. A card without an emoji needs a drawn picture, which you cannot make: use only things an emoji shows, or leave it to the Werkstatt (below).

## How the app checks answers (so you write answers that can be typed)

- `word`, `fact`, `sentence`: case, spaces and punctuation do not matter; contractions are equal ("I'm" = "I am"); parts in round brackets are optional; for `word` and `fact` several accepted answers separated by `,` `;` `/`; small typos are forgiven in words of five letters or more. `;` is the separator for synonyms.
- `number`: compared by value ("3,5" = "3.5" = "7/2"), no typo forgiven.
- `dictation` and `spelling`: exact, capitals and every letter, only `;` separates alternatives.

## Delivering

Name the file after the lesson (`Einmaleins mit 7.lernluchs`). On the iPhone: tap the file, then "In Lernluchs öffnen" (from a Mac: AirDrop, Messages or Mail to the phone; from a cloud drive: the Files app). The app shows the cards for review and only saves them after "Speichern". If the user wants to edit many cards, add pictures or have the voice Mia record the words, they can open the file in the **Werkstatt** at https://lernluchs.app/werkstatt/ (a web page; opening, editing and downloading need no account).

Never put the child's name, school or other personal data into cards or the lesson name.

## Files in this skill

- `scripts/lernluchs_lektion.py`: `build` and `check` (Python 3, standard library only)
- `references/format.md`: the exact file format
- `references/cards.md`: kinds in detail, subject guidance, German spelling patterns
- `references/review-checklist.md`: what to verify before delivering
- `examples/`: finished lessons for maths, biology, English and German, and the card JSON of one of them
