Kokoro TTS Health Check
Run 6 health checks to verify the Kokoro TTS engine installation.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Checks
| # | Check | Command |
|---|---|---|
| 1 | Venv exists | [[ -d ~/.local/share/kokoro/.venv ]] |
| 2 | Python 3.14 | ~/.local/share/kokoro/.venv/bin/python --version | grep 3.14 |
| 3 | mlx_audio import | python -c "from mlx_audio.tts.utils import load_model" |
| 4 | kokoro_common.py | [[ -f ~/.local/share/kokoro/kokoro_common.py ]] |
| 5 | tts_generate.py | [[ -f ~/.local/share/kokoro/tts_generate.py ]] |
| 6 | version.json | [[ -f ~/.local/share/kokoro/version.json ]] |
Execution
ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --health
Failure Recommendations
| Failure | Recommended Skill |
|---|---|
| Venv missing | install |
| Import fails | install or upgrade |
| Scripts missing | install |
| version.json | install |
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| All checks fail | Not installed | Run /kokoro-tts:install first |
| Only import fails | Venv corrupted | kokoro-install.sh --uninstall then --install |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.