An interactive language learning system for Claude Code, powered by AI. Import your own textbooks, extract structured learning materials, and follow a personalized curriculum — all through natural conversation.
Three skills: /process-material (import & extract), /learn-language (learn & practice), and /practise (free conversation). Supports any language pair.
Read this in other languages:
English | 简体中文 | 繁體中文 | Español
- Trigger conditions — clear guidance on when to use each skill
- 16 examples — detailed input→output examples for all scenarios
- Quality checklists — self-verification after each skill use
- Error handling — graceful fallbacks for common failures
- Version history — track changes across releases
- Spaced repetition — vocabulary mastery scores and grammar review scheduling built in. Every 5th lesson is a review lesson.
- Unified state —
progress.json+course.jsonmerged into a singlestate.json. One file to rule them all. /practisemode — free conversation in your target language with real-time error correction.- Auto-continuation — returning to a course skips setup and shows your progress card immediately.
One-click install:
# Linux / Mac
bash <(curl -s https://raw.githubusercontent.com/mlkgrnt/Learn-Language/main/setup.sh)
# Windows (PowerShell)
irm https://raw.githubusercontent.com/mlkgrnt/Learn-Language/main/setup.py | python
# Or clone and run manually
git clone https://github.com/mlkgrnt/Learn-Language.git
cd Learn-Language
python setup.py # cross-platform
bash setup.sh # Linux / Mac
setup.bat # Windows- Place materials in
materials/input/(PDF, Word, Excel, CSV, etc.) - Open Claude Code and run
/process-materialto extract vocabulary, grammar, and passages - Run
/learn-languageto start interactive lessons - Use
/practiseanytime for free conversation practice
Import raw teaching materials and convert them to structured data.
When to use:
- You have textbooks (PDF, Word, Excel) to process
- You want to extract vocabulary, grammar, or reading passages
- You are setting up a new learning project
Interactive lessons with spaced repetition and progress tracking.
When to use:
- You want to learn a new language
- You want to continue a previous learning session
- You want structured vocabulary, grammar, reading, writing, or culture lessons
Free-form conversation in your target language with real-time correction.
When to use:
- You want to practice speaking/writing
- You want informal conversation practice
- You want to test your skills in a low-pressure setting
Each skill handles common failures gracefully:
- Encoding detection failure → Falls back to common encodings (UTF-8, GBK, Shift-JIS)
- PDF conversion failure → Suggests alternative methods (OCR, online tools)
- State file corruption → Auto-recovers from backup or starts fresh
- Missing materials → Suggests running
/process-materialfirst
- Cyber-Eros.skill — Immersive roleplay system by the same author
MIT