Language Coach

You are the language-coach command handler. Read the sub-command and run the matching bundled CLI command.

Default platform: use the current host platform.

• In Codex, use --platform codex
• In Claude Code, use --platform claude
• In Cursor, use --platform cursor

If the host platform is ambiguous, ask which platform the user is currently running before writing config.

Resolve the script path relative to this skill directory:

• Skill path: skills/language-coach/SKILL.md
• Bundled CLI path: ../../scripts/manage_language_coach.py

All commands below should call that bundled script path directly:

python3 ../../scripts/manage_language_coach.py --platform <claude|codex|cursor> ...

Setup

Ask these questions one at a time:

1. What is your native language? (for example: Chinese, Japanese, Spanish)
2. What language are you learning? (for example: English, French, German)
3. What is your main goal? (everyday / scored)
4. Which coaching style do you want? (teaching / concise / translate)
5. Which response language should I use after coaching? (native / target)

If the user chooses scored, ask these follow-ups one at a time:

1. Which scored mode do you want? (scored-writing / scored-speaking)
2. What scoring focus should I store? (writing / speaking / both)
3. What target estimate are you aiming for? (optional)
4. What is your current level? (optional)

Then run the matching commands in order:

python3 ../../scripts/manage_language_coach.py --platform <platform> native "<native>"
python3 ../../scripts/manage_language_coach.py --platform <platform> target "<target>"
python3 ../../scripts/manage_language_coach.py --platform <platform> goal "<goal>"
python3 ../../scripts/manage_language_coach.py --platform <platform> style "<style>"
python3 ../../scripts/manage_language_coach.py --platform <platform> response "<response>"

For Codex users, set <platform> to codex on every command in the setup flow. For Cursor users, set <platform> to cursor on every command in the setup flow. Do not imply that the default shared setup writes Codex or Cursor config unless you are explicitly running that platform variant.

If goal is scored, also run:

python3 ../../scripts/manage_language_coach.py --platform <platform> mode "<scored-mode>"
python3 ../../scripts/manage_language_coach.py --platform <platform> focus "<focus>"
python3 ../../scripts/manage_language_coach.py --platform <platform> estimate "<target-estimate>"
python3 ../../scripts/manage_language_coach.py --platform <platform> level "<current-level>"

Finish by running:

python3 ../../scripts/manage_language_coach.py --platform <platform> status

For Codex users, also run:

python3 ../../scripts/manage_language_coach.py --platform codex install-hook
python3 ../../scripts/manage_language_coach.py --platform codex status

For Cursor users, also run:

python3 ../../scripts/manage_language_coach.py --platform cursor install-hook
python3 ../../scripts/manage_language_coach.py --platform cursor status

The Cursor install-hook writes to ~/.cursor/hooks.json (the top-level location). Plugin-manifest hooks are unreliable on some Cursor releases, so the top-level entry is what actually fires.

This ensures automatic coaching is installed immediately after setup.

Confirm with a short summary of the stored configuration.

Sub-commands

native

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> native "<lang>"

Confirm: Native language updated to: <lang>

target

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> target "<lang>"

Behavior depends on whether multi-target profiles are configured:

• Single target (targets[] empty): sets the language the coach practices. Confirm: Target language updated to: <lang>.
• Multi-target mode (targets[] non-empty):
  • If <lang> matches an existing profile, that profile becomes primary.
  • If <lang> is not in targets[], only the fallback language updates; coaching still uses the existing profiles. Use target-add <lang> to actually coach a new language.

Multi-target management

Use these commands to manage the targets list for auto-detected coaching across multiple target languages:

target-add

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> target-add "<lang>"

This appends a new target profile using the current shared coaching settings as defaults.

target-remove

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> target-remove "<lang>"

This removes the matching target profile from the multi-target list.

target-list

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> target-list

Relay the printed target language list back to the user.

style

Valid values: teaching, concise, translate

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> style "<mode>"

Confirm: Style updated to: <mode>

response

Valid values: native, target

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> response "<mode>"

Confirm: Responses will use: <mode>

goal

Valid values: everyday, scored

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> goal "<mode>"

Notes:

• goal everyday resets the active mode to everyday
• goal scored keeps the shared config in scored mode

mode

Valid values: everyday, scored-writing, scored-speaking, review

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> mode "<mode>"

Notes:

• scored modes automatically set goal to scored
• mode everyday switches goal back to everyday

practice-focus

Valid values: writing, speaking, both

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> practice-focus "<mode>"

focus remains available as a legacy alias.

estimate

Examples: 6.5, N3, B1

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> estimate "<value>"

level

Examples: B1, band 5.5, upper-intermediate

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> level "<text>"

status

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> status

Relay the formatted output back to the user.

install-hook

Codex or Cursor. Run:

python3 ../../scripts/manage_language_coach.py --platform codex install-hook
# or
python3 ../../scripts/manage_language_coach.py --platform cursor install-hook

Confirm: Codex hook installed: <path> or Cursor hook installed: <path>

remove-hook

Codex or Cursor. Run:

python3 ../../scripts/manage_language_coach.py --platform codex remove-hook
# or
python3 ../../scripts/manage_language_coach.py --platform cursor remove-hook

Confirm: Codex hook removed: <path> or Cursor hook removed: <path>

hook-status

Codex or Cursor. Run:

python3 ../../scripts/manage_language_coach.py --platform codex hook-status
# or
python3 ../../scripts/manage_language_coach.py --platform cursor hook-status

Relay installed or not installed back to the user.

progress [language]

Show raw estimate history for all languages (or a single language).

Run:

python3 ../../scripts/manage_language_coach.py --platform <platform> progress
# or for a specific language:
python3 ../../scripts/manage_language_coach.py --platform <platform> progress "<language>"

Relay the output back to the user. For full statistics (velocity, streak, projection), suggest /language-coach:language-review instead.

vocab on | off

Toggle the vocab focus feature (tracks gap / correction / upgrade words that need practice). Only active when mode is scored-writing or scored-speaking.

python3 ../../scripts/manage_language_coach.py --platform <platform> vocab on
# or
python3 ../../scripts/manage_language_coach.py --platform <platform> vocab off

Confirm: Vocab focus enabled. or Vocab focus disabled.

vocab [language]

Show the current active vocab focus list (and the most recent mastered entries).

python3 ../../scripts/manage_language_coach.py --platform <platform> vocab
# or for a specific language:
python3 ../../scripts/manage_language_coach.py --platform <platform> vocab "<language>"

Relay the printed output back to the user.

track-vocab gap|correction|upgrade ...

Silently invoked by the coaching prompt when vocabFocus is on. Users do not typically run this directly — the model calls it after each coaching turn. Signatures:

# native-language fallback inside a target-language message (strongest signal)
python3 ../../scripts/manage_language_coach.py --platform <platform> track-vocab <lang> gap \
  --native "<native-word>" --target "<target-word>" [--context "<C>"] [--note "<N>"]

# user wrote a wrong target-language word that coaching corrected
python3 ../../scripts/manage_language_coach.py --platform <platform> track-vocab <lang> correction \
  --wrong "<wrong>" --right "<right>" [--context "<C>"] [--note "<N>"]

# user wrote a low-band target-language word that coaching upgraded (mixed-language messages only)
python3 ../../scripts/manage_language_coach.py --platform <platform> track-vocab <lang> upgrade \
  --from "<from>" --to "<to>" [--context "<C>"] [--note "<N>"]

mark-vocab-mastered

Silently invoked by the coaching prompt when a focus entry is used correctly in the current message. Three correct uses promote the entry into the mastered audit list.

python3 ../../scripts/manage_language_coach.py --platform <platform> mark-vocab-mastered <lang> "<identifier>"

<identifier> is the target / right / to field of the original focus entry.

off

Run:

python3 scripts/manage_language_coach.py --platform <platform> off

Confirm: Language coach paused.

on

Run:

python3 scripts/manage_language_coach.py --platform <platform> on

Confirm: Language coach active.

Fallback Help

If no argument or the command is unknown, show:

Usage: /language-coach <command>

Commands:
  setup              Run the setup wizard
  native <lang>      Set your native language
  target <lang>      Set the language you are learning
  target-add <lang>  Add a target language profile to the multi-target list
  target-remove <lang>
                     Remove a target language profile from the multi-target list
  target-list        List the configured multi-target languages
  style <mode>       Set coaching style: teaching / concise / translate
  response <mode>    Set response language: native / target
  goal <mode>        Set the coaching goal: everyday / scored
  mode <mode>        Set the coaching mode: everyday / scored-writing / scored-speaking / review
  practice-focus <mode>
                     Set scoring focus: writing / speaking / both
  focus <mode>       Legacy alias for practice-focus
  estimate <value>   Set target estimate
  band <score>       Legacy alias for estimate
  level <text>       Set current level
  status             Show current configuration
  progress [lang]    Show raw estimate history (use /language-coach:language-review for full stats)
  vocab on|off       Toggle vocab focus tracking (scored modes only)
  vocab [lang]       Show active vocab focus list
  install-hook       Install the Codex UserPromptSubmit hook
  remove-hook        Remove the Codex UserPromptSubmit hook
  hook-status        Show whether the Codex hook is installed
  off                Pause coaching
  on                 Resume coaching

See also: /language-coach:language-review  — analyze your progress data with stats and AI commentary