Upgrade Kokoro model, bot dependencies, or TTS components. TRIGGERS - upgrade kokoro, update model, upgrade bot, update dependencies, version bump, component update.
From tts-tg-syncnpx claudepluginhub terrylica/cc-skills --plugin tts-tg-syncThis skill is limited to using the following tools:
references/evolution-log.mdreferences/upgrade-procedures.mdGuides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Optimizes cloud costs on AWS, Azure, GCP via rightsizing, tagging strategies, reserved instances, spot usage, and spending analysis. Use for expense reduction and governance.
Upgrade individual components of the TTS + Telegram bot stack without rebuilding the entire system.
Platform: macOS (Apple Silicon)
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.
tts_generate.py from the plugin bundleuv installed (brew install uv)mise installed and configuredfull-stack-bootstrap first if not installed)| Component | Command | What It Does |
|---|---|---|
| Kokoro TTS engine | kokoro-install.sh --upgrade | Upgrades Python deps, re-downloads model, updates version.json |
| Bot dependencies | cd ~/.claude/automation/claude-telegram-sync && bun update | Updates Bun packages per package.json |
| tts_generate.py | Re-copy from plugin scripts/ to ~/.local/share/kokoro/ | Updates the TTS generation script |
| Bun runtime | mise use bun@latest | Updates the Bun version in mise.toml |
Ask the user which component to upgrade using AskUserQuestion. Present the four options above.
# Run health check to establish baseline
~/.local/share/kokoro/../../eon/cc-skills/plugins/tts-tg-sync/scripts/kokoro-install.sh --health
# Record current versions
cat ~/.local/share/kokoro/version.json
Run the appropriate upgrade command for the selected component.
# Health check again
kokoro-install.sh --health
# Generate test audio to verify TTS still works
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py \
--text "Upgrade verification test" --voice af_heart --lang en-us --speed 1.0 \
--output /tmp/kokoro-tts-upgrade-test.wav
If bot dependencies or Bun runtime were upgraded, restart the bot:
pkill -f 'bun.*src/main.ts' || true
cd ~/.claude/automation/claude-telegram-sync && bun --watch run src/main.ts
1. [Identify] Present upgradeable components via AskUserQuestion
2. [Preflight] Run health check on target component
3. [Backup] Note current versions (version.json, package.json)
4. [Upgrade] Execute upgrade command
5. [Verify] Run post-upgrade health check
6. [Test] Generate test audio to verify TTS still works
7. [Restart] Restart bot if needed
8. [Report] Show before/after versions
| Problem | Likely Cause | Fix |
|---|---|---|
| Upgrade fails | No internet or PyPI issue | Check connectivity, retry |
| Model download slow | First-time ~400MB, subsequent cached | Wait for download to complete |
| Version mismatch | Stale version.json | Re-run kokoro-install.sh --health to check, --upgrade to fix |
| MLX-Audio import fails | mlx-audio version incompatibility | kokoro-install.sh --upgrade reinstalls mlx-audio |
| Bot won't start after upgrade | Dependency conflict | cd ~/.claude/automation/claude-telegram-sync && bun install |
After this skill completes, reflect before closing the task:
Do NOT defer. The next invocation inherits whatever you leave behind.