🍳

Language Learning Assistant

Daily language lessons combining translation, text-to-speech pronunciation, and spaced repetition for vocabulary retention.

🤖 0 ↑ 0 ↓ | 👤 0 ↑ 0 ↓

intermediate⏱ 10 min setup🔄 7 swappable alternatives

🧂 Ingredients

🔌 APIs

Translate words and sentencesrequired

translate_words_and_sentences

🔄 Alternatives:

Deepl — Higher quality translations for European languagesOpenai — Context-aware translation via LLM

Generate native pronunciation audiorequired

generate_native_pronunciation_audio

🔄 Alternatives:

Openai Tts — Simpler API, lower costGoogle Tts — Many languages, WaveNet voices

Create lessons and track spaced repetitionrequired

create_lessons_and_track_spaced_repetition

🔄 Alternatives:

Anthropic — Better at analysis and reasoningGemini — Free tier, multimodalMistral — Open-weight, EU-hosted

📋 Step-by-Step Build Guide

STEP 1

Load vocabulary database and spaced repetition schedule

Load vocabulary database and spaced repetition schedule

Steps:
1. Validate all required inputs are available
2. Execute the operation described above
3. Verify the result meets expected output format
4. Handle errors gracefully — retry transient failures, log and alert on persistent ones
5. Return structured output with status and any relevant data

If any required data is missing, request it from the user before proceeding.

STEP 2

Select today's review words (due for review based on SRS algorithm)

Select today's review words (due for review based on SRS algorithm)

Steps:
1. Validate all required inputs are available
2. Execute the operation described above
3. Verify the result meets expected output format
4. Handle errors gracefully — retry transient failures, log and alert on persistent ones
5. Return structured output with status and any relevant data

If any required data is missing, request it from the user before proceeding.

STEP 3

Add 5 new words from current topic/theme

Add 5 new words from current topic/theme

Steps:
1. Validate all required inputs are available
2. Execute the operation described above
3. Verify the result meets expected output format
4. Handle errors gracefully — retry transient failures, log and alert on persistent ones
5. Return structured output with status and any relevant data

If any required data is missing, request it from the user before proceeding.

STEP 4

For each word: show translation, example sentence, pronunciation audio

For each word: show translation, example sentence, pronunciation audio

Steps:
1. Validate all required inputs are available
2. Execute the operation described above
3. Verify the result meets expected output format
4. Handle errors gracefully — retry transient failures, log and alert on persistent ones
5. Return structured output with status and any relevant data

If any required data is missing, request it from the user before proceeding.

STEP 5

Quiz user on review words

Quiz user on review words

Steps:
1. Validate all required inputs are available
2. Execute the operation described above
3. Verify the result meets expected output format
4. Handle errors gracefully — retry transient failures, log and alert on persistent ones
5. Return structured output with status and any relevant data

If any required data is missing, request it from the user before proceeding.

STEP 6

Update SRS intervals based on recall accuracy

Update SRS intervals based on recall accuracy

Steps:
1. Validate all required inputs are available
2. Execute the operation described above
3. Verify the result meets expected output format
4. Handle errors gracefully — retry transient failures, log and alert on persistent ones
5. Return structured output with status and any relevant data

If any required data is missing, request it from the user before proceeding.

STEP 7

Save progress to vocab-progress.json

Persist the data to the configured storage.

Data structure:
- Include timestamp (ISO 8601) with every record
- Use consistent field names across entries
- Store raw values (not formatted) for future analysis
- Add a source/origin field for audit trail

Storage operation:
1. Validate the data before writing
2. Check for duplicates (by timestamp + unique key)
3. Append to existing records — never overwrite
4. Verify the write succeeded
5. Return the stored record ID/reference

🤖 Example Agent Prompt

Load vocabulary database and spaced repetition schedule

Steps:
1. Validate all required inputs are available
2. Execute the operation described above
3. Verify the result meets expected output format
4. Handle errors gracefully — retry transient failures, log and alert on persistent ones
5. Return structured output with status and any relevant data

If any required data is missing, request it from the user before proceeding.

Copy this prompt into your agent to get started.