DeutschDNA: a German tutor skill for Claude Code and Codex that remembers your mistakes and the hints that helped.
Python
0
11 commits
updated Sep 24, 2026
See what people are saying
README
DeutschDNA
A German coaching skill for Claude Code and Codex.
You learn German. Your tutor remembers what helped.
Your tutor remembers your mistakes, the hints that helped, and your progress across conversations.
Install and start · Actual conversation · 103 days later
Yesterday: with a hint. Today: a new sentence, without help.
Scripted learner inputs, real engine records. View the result without animation.
Install
Requires Python 3.10+ and Claude Code or Codex. No runtime packages, extra API key, server, or database to set up. Your existing model teaches; progress is stored locally in ~/.deutschdna.
Claude Code
git clone https://github.com/ahmtsahin/deutsch-dna.git "$HOME/.claude/skills/deutsch-dna"
Start a chat with /deutsch-dna.
Codex
git clone https://github.com/ahmtsahin/deutsch-dna.git "$HOME/.agents/skills/deutsch-dna"
Start a chat with $deutsch-dna.
The tutor gives you one small German task right away. You can ask for explanations in your own language. Your name and goals are optional.
The clone commands work in macOS/Linux terminals and PowerShell. For project-only installation, Python on Windows, or the one-time permission setup that lets the tutor save progress, see installation and permissions.
An actual conversation
A new chat remembers the old hint. This is a timed transcript replay of actual Claude Code replies to scripted learner messages. Both chats happened on the same day, using an isolated learning history. Displayed excerpts preserve the tutor's words; waiting time is compressed.
Full conversation · Captured replies and saved evidence · Static view
Every session starts with your board
Your patterns, what is due first, and which mistakes came back. The tutor then quotes one of your own sentences and puts it in a new situation. This board belongs to the scripted four-month learner and comes straight from the engine.
What you can do
| Say this | What happens |
|---|---|
| “Correct my German.” | Minimal corrections, with related mistakes grouped by their root cause. |
| “Give me a hint.” | You repair the sentence; the tutor remembers the help you needed. |
| “Let's review.” | Due patterns return in fresh situations. Copying the old answer cannot advance mastery. |
| “I have a meeting tomorrow.” | A roleplay can use your goal and a pattern you are practising. |
| “Let's practise words.” | Vocabulary from your scenes returns in spaced reviews. |
| “How am I doing?” | Your recorded progress, with the sentences behind it. |
| “That wasn't a mistake.” | The tutor can undo the correction and restore its schedule. |
During a roleplay, ordinary corrections wait until the debrief. Start with “Restoranda konuşalım” or “Roleplay Restaurant”; finish with “bitir” or “stop roleplay”. The reply includes up to three corrections and useful vocabulary.
Your first minute, roleplays, and more examples.
Memory over months
Your first mistake is still there when you need it. This scripted four-month story runs through the real engine. The callback, original sentence, and saved hint come from its records. Static view.
The first example and teaching milestones survive the rolling history limits. Progress scores describe tracked patterns, not overall German proficiency. Text practice works directly; microphone capture and pronunciation scoring are not included.
Try the engine
From the cloned skill folder:
python scripts/demo.py --learning-loop
This uses a fresh demo directory. For the four-month story, run python scripts/demo.py; for the restaurant scene, add --speak.
CLI guide · Command contract · Tests, recording, and GIF generation
Roadmap
- Planned: Goethe B1/B2, telc B1/B2, and telc Deutsch Beruf exam modes.
- Exploring: voice practice, pronunciation fingerprint, and a local dashboard.
License
Contributors
11 commits
Similar repos
Languages
Python
100.0%
DeutschDNA: a German tutor skill for Claude Code and Codex that remembers your mistakes and the hints that helped.
Python
0
11 commits
updated Sep 24, 2026
See what people are saying
README
DeutschDNA
A German coaching skill for Claude Code and Codex.
You learn German. Your tutor remembers what helped.
Your tutor remembers your mistakes, the hints that helped, and your progress across conversations.
Install and start · Actual conversation · 103 days later
Yesterday: with a hint. Today: a new sentence, without help.
Scripted learner inputs, real engine records. View the result without animation.
Install
Requires Python 3.10+ and Claude Code or Codex. No runtime packages, extra API key, server, or database to set up. Your existing model teaches; progress is stored locally in ~/.deutschdna.
Claude Code
git clone https://github.com/ahmtsahin/deutsch-dna.git "$HOME/.claude/skills/deutsch-dna"
Start a chat with /deutsch-dna.
Codex
git clone https://github.com/ahmtsahin/deutsch-dna.git "$HOME/.agents/skills/deutsch-dna"
Start a chat with $deutsch-dna.
The tutor gives you one small German task right away. You can ask for explanations in your own language. Your name and goals are optional.
The clone commands work in macOS/Linux terminals and PowerShell. For project-only installation, Python on Windows, or the one-time permission setup that lets the tutor save progress, see installation and permissions.
An actual conversation
A new chat remembers the old hint. This is a timed transcript replay of actual Claude Code replies to scripted learner messages. Both chats happened on the same day, using an isolated learning history. Displayed excerpts preserve the tutor's words; waiting time is compressed.
Full conversation · Captured replies and saved evidence · Static view
Every session starts with your board
Your patterns, what is due first, and which mistakes came back. The tutor then quotes one of your own sentences and puts it in a new situation. This board belongs to the scripted four-month learner and comes straight from the engine.
What you can do
| Say this | What happens |
|---|---|
| “Correct my German.” | Minimal corrections, with related mistakes grouped by their root cause. |
| “Give me a hint.” | You repair the sentence; the tutor remembers the help you needed. |
| “Let's review.” | Due patterns return in fresh situations. Copying the old answer cannot advance mastery. |
| “I have a meeting tomorrow.” | A roleplay can use your goal and a pattern you are practising. |
| “Let's practise words.” | Vocabulary from your scenes returns in spaced reviews. |
| “How am I doing?” | Your recorded progress, with the sentences behind it. |
| “That wasn't a mistake.” | The tutor can undo the correction and restore its schedule. |
During a roleplay, ordinary corrections wait until the debrief. Start with “Restoranda konuşalım” or “Roleplay Restaurant”; finish with “bitir” or “stop roleplay”. The reply includes up to three corrections and useful vocabulary.
Your first minute, roleplays, and more examples.
Memory over months
Your first mistake is still there when you need it. This scripted four-month story runs through the real engine. The callback, original sentence, and saved hint come from its records. Static view.
The first example and teaching milestones survive the rolling history limits. Progress scores describe tracked patterns, not overall German proficiency. Text practice works directly; microphone capture and pronunciation scoring are not included.
Try the engine
From the cloned skill folder:
python scripts/demo.py --learning-loop
This uses a fresh demo directory. For the four-month story, run python scripts/demo.py; for the restaurant scene, add --speak.
CLI guide · Command contract · Tests, recording, and GIF generation
Roadmap
- Planned: Goethe B1/B2, telc B1/B2, and telc Deutsch Beruf exam modes.
- Exploring: voice practice, pronunciation fingerprint, and a local dashboard.
License
Similar repos
Contributors
11 commits
Languages
Python
100.0%