| name | polyglot |
| description | Manual controls for the polyglot language learning system. Use this skill to switch languages, adjust difficulty, add vocabulary, or check progress. Vocabulary injection happens automatically via hooks. |
| user-invocable | true |
Polyglot Language Learning Skill
This skill provides manual controls for the polyglot language learning system. Vocabulary injection happens automatically in the background via hooks - this skill is for when users want to explicitly manage their learning.
Available Commands
When a user invokes this skill or asks about language learning, help them with these commands:
Switch Language
User says: "Switch to Spanish", "Learn French now", "Change language to Japanese"
Action: Update the config file with the new language code:
CONFIG_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/polyglot/config.json"
jq '.language = "es"' "$CONFIG_FILE" > tmp.$$.json && mv tmp.$$.json "$CONFIG_FILE"
Language codes: ru (Russian), es (Spanish), de (German), fr (French), ja (Japanese)
Adjust Difficulty
User says: "Make it easier", "Set difficulty to 8", "I want more immersion"
Action: Update the difficulty level (1-10) in config:
CONFIG_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/polyglot/config.json"
jq '.difficulty = 8' "$CONFIG_FILE" > tmp.$$.json && mv tmp.$$.json "$CONFIG_FILE"
Difficulty levels:
- 1-3 (Beginner): Translation-first - "the function (функция)"
- 4-6 (Intermediate): Target language with anchor - "the функция (function) returns"
- 7-10 (Advanced): Immersive - "создайте новую функцию for processing"
Add Vocabulary
User says: "Add the word 'database' to my vocabulary", "Add 'recursion' in Russian"
Action: Run the add script:
bash "${CLAUDE_PLUGIN_ROOT}/skills/polyglot/scripts/add" <language> "<term>" "<translation>"
Example:
bash "${CLAUDE_PLUGIN_ROOT}/skills/polyglot/scripts/add" ru "база данных" "database"
Check Progress
User says: "How's my Russian?", "Show my Spanish progress", "What vocabulary have I learned?"
Action: Run the stats script:
bash "${CLAUDE_PLUGIN_ROOT}/skills/polyglot/scripts/stats" <language>
Example output:
Language: ru
Total vocabulary: 120
Seen at least once: 45
Familiar (mastery ≥3): 18
Mastered (mastery 5): 5
Total exposures: 234
Top 10 most reviewed:
функция: 23x (mastery: 4)
переменная: 19x (mastery: 4)
массив: 15x (mastery: 3)
Get Due Terms
User says: "What words should I review?", "What's due for practice?"
Action: Run the get_due script:
bash "${CLAUDE_PLUGIN_ROOT}/skills/polyglot/scripts/get_due" <language>
Initialize Config
User says: "Set up polyglot", "Initialize my config"
Action: Run the init script:
bash "${CLAUDE_PLUGIN_ROOT}/skills/polyglot/scripts/init"
This creates ~/.config/polyglot/config.json with default settings.
How Always-On Learning Works
The polyglot plugin uses hooks for automatic vocabulary injection:
- SessionStart hook: Loads your config and fetches due vocabulary terms
- UserPromptSubmit hook: Injects vocabulary naturally into every response
- Stop hook: Records which terms you were exposed to for spaced repetition
You don't need to do anything - vocabulary appears naturally as you code. Use this skill only when you want to change settings or check progress.
Vocabulary Tracking
The system tracks:
- Count: Number of times you've seen each term
- Last seen: When you last encountered the term
- Mastery: Level 1-5 based on total exposures
Terms reappear based on spaced repetition intervals:
- Mastery 1 (new): After 1 hour
- Mastery 2: After 6 hours
- Mastery 3 (familiar): After 1 day
- Mastery 4: After 3 days
- Mastery 5 (mastered): After 7 days
Script Locations
All scripts are in ${CLAUDE_PLUGIN_ROOT}/skills/polyglot/scripts/:
init - Initialize user configurationget_due - Fetch terms due for reviewrecord - Record vocabulary exposureadd - Add new vocabulary termstats - Show progress statistics
