VocabBot: the daily session
The session runs in the engine's order: reviews due today, then new words,
then the drill of cards answered wrong. This skill shows the cards and passes
the learner's answers to the engine, which grades them and schedules the next
review.
Read shared/rules.md before the first card. It says how to call the engine
and holds the rules every VocabBot skill keeps; the most important here: the
answer comes after the grade, the engine grades, numbers come from the engine.
python3 "${CLAUDE_SKILL_DIR}/bin/vocabbot.pyz" <command> --json
Step 0: the day
Run today --json.
error.code is no_learner or no_plan: VocabBot is not set up for this
learner. Offer the setup (vocab-start), or pass --learner <folder> once
the learner names the folder.
off: true: a day off; the reviews wait for the next learning day. When
the learner wants to learn anyway, today --extra <n> --json adds new
words for today, and next --count 10 --ahead 10 --json brings reviews of
later days (answers to cards with phase: ahead go to answer with
--ahead). A learner without learned words has no reviews to bring ahead.
warnings with conflict_copies or damaged_rows: say that vocab-start
checks and repairs the folder; the session can go on.
paced: the engine gives fewer new words today (today instead of
planned) so that the day fits the learner's usual minutes; say so in one
sentence.
ahead_hint: tomorrow is a day off or a day the learner usually skips.
After today's cards, offer its count reviews ahead of their day:
next --count <count> --ahead <count> --json, answered with --ahead.
Show the day in two or three lines from languages (reviews, new words,
drill per language) and minutes.
Step 1: a batch
Run next --count 10 --json (or the number the learner chose). Keep the
order of items. Each item has card, lang, phase (review, new,
drill, ahead) and question; a new word also has word.
Introduce the new words. For each item with phase: new, show word:
the word with its gender, forms and IPA, the Polish meaning, and the
example with its translation. Ask the learner to read them and end the
message there; the questions come in the next message, after the learner
says they are ready, so the answers are not on the screen. A learner who
knew a word before the course says so, and
grade --card <card> --grade known --json records it; that word then
leaves the batch.
Ask the questions. Ask every remaining item of the batch as one
numbered list. Per item: the language tag (EN, DE, ES, FR), the Polish
meaning, the part of speech, "z rodzajnikiem" when with_article is true,
the hint if any, and the sentence with its gap ___ and sentence_pl.
Recognition cards (question.ask: meaning) follow
reference/recognition.md. reference/presentation.md shows the layout.
Send the answers. The learner answers by number. When the reply does
not map clearly onto the numbers, ask once. Send every answer of the batch
in one call, exactly as typed, on standard input:
python3 "${CLAUDE_SKILL_DIR}/bin/vocabbot.pyz" answer --batch --stdin --json <<'EOF'
{"card": "de-c01997#p", "answer": "der Hund"}
{"card": "es-c02790#p", "answer": ""}
EOF
Show the results. One line per card: "✓ wiem", "≈ prawie" with the
error classes in Polish (errors_pl), or "✗ nie wiem", then word.word;
add the example for "prawie" and "nie wiem". The cards answered wrong come
back in the "utrwalanie" (the drill) at the end. other_lang means the learner typed the word of
another language being learned: name that language. A result with error
was refused; show its message and go on.
Repeat Step 1 until left in the last result shows no reviews, no new words
and no drill. Cards answered wrong come back in the drill at the end, as many
times as needed; their due date no longer changes that day.
Step 2: the end
Run today --json and sum up the session from it in two lines. Offer the
coach (vocab-coach) for the words that went wrong. Announce the next
session or a reminder only as shared/rules.md allows.
During the session
- Change of a grade. Only on the learner's explicit request for a named
card:
regrade --card <card> --grade know|almost|dont_know --json.
- More words today.
today --extra <n> --json, then Step 1 again.
- A mistake in a card. The learner's note goes to
flag --card <card> --stdin --json; the card leaves the queue until
flag --card <card> --clear --json. Larger corrections belong to
vocab-words.
- A pause. Every answer is saved at once. The next
next call continues
in the same order, in the chat or in the terminal (vocabbot drill).
More: reference/gotchas.md.
1---2name: vocab-session3description: >4 The daily VocabBot vocabulary session in the chat: reviews due today, new5 words in small batches and the drill of words that went wrong, in one to6 three languages (English, German, Spanish, French). The engine grades every7 typed answer and sets every due date. Use when the learner says: let's8 learn, daily session, review my words, next words, vocabulary practice;9 po polsku: sesja, codzienna sesja, powtórki, uczymy się, nowe słówka,10 dalej, zaczynamy naukę słówek.11argument-hint: "[cards per batch]"12metadata:13 source: https://skillmd.com/skills/dithiothreitol/vocab-session14---1516# VocabBot: the daily session1718The session runs in the engine's order: reviews due today, then new words,19then the drill of cards answered wrong. This skill shows the cards and passes20the learner's answers to the engine, which grades them and schedules the next21review.2223Read `shared/rules.md` before the first card. It says how to call the engine24and holds the rules every VocabBot skill keeps; the most important here: the25answer comes after the grade, the engine grades, numbers come from the engine.2627```28python3 "${CLAUDE_SKILL_DIR}/bin/vocabbot.pyz" <command> --json29```3031## Step 0: the day3233Run `today --json`.3435- `error.code` is `no_learner` or `no_plan`: VocabBot is not set up for this36 learner. Offer the setup (`vocab-start`), or pass `--learner <folder>` once37 the learner names the folder.38- `off: true`: a day off; the reviews wait for the next learning day. When39 the learner wants to learn anyway, `today --extra <n> --json` adds new40 words for today, and `next --count 10 --ahead 10 --json` brings reviews of41 later days (answers to cards with `phase: ahead` go to `answer` with42 `--ahead`). A learner without learned words has no reviews to bring ahead.43- `warnings` with `conflict_copies` or `damaged_rows`: say that `vocab-start`44 checks and repairs the folder; the session can go on.45- `paced`: the engine gives fewer new words today (`today` instead of46 `planned`) so that the day fits the learner's usual minutes; say so in one47 sentence.48- `ahead_hint`: tomorrow is a day off or a day the learner usually skips.49 After today's cards, offer its `count` reviews ahead of their day:50 `next --count <count> --ahead <count> --json`, answered with `--ahead`.5152Show the day in two or three lines from `languages` (reviews, new words,53drill per language) and `minutes`.5455## Step 1: a batch5657Run `next --count 10 --json` (or the number the learner chose). Keep the58order of `items`. Each item has `card`, `lang`, `phase` (`review`, `new`,59`drill`, `ahead`) and `question`; a new word also has `word`.60611. **Introduce the new words.** For each item with `phase: new`, show `word`:62 the word with its gender, forms and IPA, the Polish meaning, and the63 example with its translation. Ask the learner to read them and end the64 message there; the questions come in the next message, after the learner65 says they are ready, so the answers are not on the screen. A learner who66 knew a word before the course says so, and67 `grade --card <card> --grade known --json` records it; that word then68 leaves the batch.692. **Ask the questions.** Ask every remaining item of the batch as one70 numbered list. Per item: the language tag (EN, DE, ES, FR), the Polish71 meaning, the part of speech, "z rodzajnikiem" when `with_article` is true,72 the hint if any, and the sentence with its gap `___` and `sentence_pl`.73 Recognition cards (`question.ask: meaning`) follow74 `reference/recognition.md`. `reference/presentation.md` shows the layout.753. **Send the answers.** The learner answers by number. When the reply does76 not map clearly onto the numbers, ask once. Send every answer of the batch77 in one call, exactly as typed, on standard input:7879 ```80 python3 "${CLAUDE_SKILL_DIR}/bin/vocabbot.pyz" answer --batch --stdin --json <<'EOF'81 {"card": "de-c01997#p", "answer": "der Hund"}82 {"card": "es-c02790#p", "answer": ""}83 EOF84 ```85864. **Show the results.** One line per card: "✓ wiem", "≈ prawie" with the87 error classes in Polish (`errors_pl`), or "✗ nie wiem", then `word.word`;88 add the example for "prawie" and "nie wiem". The cards answered wrong come89 back in the "utrwalanie" (the drill) at the end. `other_lang` means the learner typed the word of90 another language being learned: name that language. A result with `error`91 was refused; show its message and go on.9293Repeat Step 1 until `left` in the last result shows no reviews, no new words94and no drill. Cards answered wrong come back in the drill at the end, as many95times as needed; their due date no longer changes that day.9697## Step 2: the end9899Run `today --json` and sum up the session from it in two lines. Offer the100coach (`vocab-coach`) for the words that went wrong. Announce the next101session or a reminder only as `shared/rules.md` allows.102103## During the session104105- **Change of a grade.** Only on the learner's explicit request for a named106 card: `regrade --card <card> --grade know|almost|dont_know --json`.107- **More words today.** `today --extra <n> --json`, then Step 1 again.108- **A mistake in a card.** The learner's note goes to109 `flag --card <card> --stdin --json`; the card leaves the queue until110 `flag --card <card> --clear --json`. Larger corrections belong to111 `vocab-words`.112- **A pause.** Every answer is saved at once. The next `next` call continues113 in the same order, in the chat or in the terminal (`vocabbot drill`).114115More: `reference/gotchas.md`.