Agent-Skills.md

Agent Skills: Upgrade Kokoro TTS

Upgrade Kokoro TTS engine dependencies and model. TRIGGERS - upgrade kokoro, update tts, kokoro update, update mlx-audio.

UncategorizedID: terrylica/cc-skills/upgrade

Repository

terrylica/cc-skills
terrylicaLicense: MIT
264

Install this agent skill to your local

pnpm dlx add-skill https://github.com/terrylica/cc-skills/tree/HEAD/plugins/kokoro-tts/skills/upgrade

Skill Files

Browse the full folder contents for upgrade.

Download Skill

Loading file tree…

plugins/kokoro-tts/skills/upgrade/SKILL.md

Skill Metadata

Name
upgrade
Description
"Upgrade Kokoro TTS engine dependencies and model. TRIGGERS - upgrade kokoro, update tts, kokoro update, update mlx-audio."

Upgrade Kokoro TTS

Upgrade MLX-Audio dependencies, re-download the model, and update bundled scripts.

Workflow

Step 1: Pre-upgrade health check

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json

Step 2: Execute upgrade

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --upgrade

This upgrades:

  • Python packages: mlx-audio, soundfile, numpy
  • Model weights: re-downloaded from mlx-community/Kokoro-82M-bf16
  • Bundled scripts: kokoro_common.py and tts_generate.py re-copied from plugin
  • version.json: rewritten with new versions

Step 3: Post-upgrade verification

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json

# Test synthesis
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py \
  --text "Upgrade verification" --voice af_heart --lang en-us --speed 1.0 \
  --output /tmp/kokoro-upgrade-test.wav && echo "OK"

Rollback

If upgrade breaks TTS, do a clean reinstall:

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --uninstall
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --install

Model cache is preserved across uninstall, so reinstall reuses the cached model.

Troubleshooting

| Issue | Cause | Solution | | ------------------- | ------------------------- | ----------------------------------------------- | | Upgrade fails | No internet or PyPI down | Check connectivity, retry | | Import error after | mlx-audio incompatibility | Clean reinstall: --uninstall then --install | | Model download slow | Large download | Wait for HuggingFace download to complete |