<< All versions

Skill v1.0.0

currentAutomated scan100/100
leeguooooo/prompt-language-coach/language-coach
──Details
PublishedSeptember 27, 2026 at 11:16 AM
Content Hashsha256:3ae376e2517d3f22...
Git SHAe40eed5c07f2
──Files
Files (1 file, 12.2 KB)
SKILL.md12.2 KBactive
SKILL.md · 417 lines · 12.2 KB

version: "1.0.0" name: language-coach description: Language coaching for every prompt. Use when the user runs /language-coach with any sub-command (setup, native, target, style, response, goal, mode, focus, band, level, status, off, on). Routes to the correct action based on the argument provided.


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:

bash
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:

bash
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:

bash
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:

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

For Codex users, also run:

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

For Cursor users, also run:

bash
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 <lang>

Run:

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

Confirm: Native language updated to: <lang>

target <lang>

Run:

bash
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 <lang>

Run:

bash
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 <lang>

Run:

bash
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:

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

Relay the printed target language list back to the user.

style <mode>

Valid values: teaching, concise, translate

Run:

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

Confirm: Style updated to: <mode>

response <mode>

Valid values: native, target

Run:

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

Confirm: Responses will use: <mode>

goal <mode>

Valid values: everyday, scored

Run:

bash
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 <mode>

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

Run:

bash
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 <mode>

Valid values: writing, speaking, both

Run:

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

focus remains available as a legacy alias.

estimate <value>

Examples: 6.5, N3, B1

Run:

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

level <text>

Examples: B1, band 5.5, upper-intermediate

Run:

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

status

Run:

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

Relay the formatted output back to the user.

install-hook

Codex or Cursor. Run:

bash
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:

bash
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:

bash
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:

bash
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.

bash
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).

bash
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 <language> 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:

bash
# 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 <language> <identifier>

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.

bash
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:

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

Confirm: Language coach paused.

on

Run:

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

Confirm: Language coach active.


Fallback Help

If no argument or the command is unknown, show:

text
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
All versions