polyglot - SKILL.md Agent Skill

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"
# Read current config, update language, write back
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 configuration
get_due - Fetch terms due for review
record - Record vocabulary exposure
add - Add new vocabulary term
stats - Show progress statistics