mcpField
A
augment

augment

github.com/terrylicaDevelopment139 installsUpdated 1d ago
Repository

About augment

augment is a maintenance skill for the Kokoro TTS plugin. It upgrades MLX-Audio dependencies, refreshes model weights and bundled scripts, verifies synthesis, and documents rollback steps.

Key features

  1. 01Check installation health
  2. 02Upgrade Python packages
  3. 03Re-download model weights
  4. 04Refresh bundled scripts
  5. 05Verify speech synthesis
  6. 06Uninstall and reinstall for rollback

Use cases

  1. 01Update Kokoro TTS dependencies and model
  2. 02Check the installation after an upgrade
  3. 03Restore TTS after an incompatible upgrade

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/terrylica/cc-skills --skill augment

After installing, type/augmentin Claude Code to confirm it loaded.

Details

From the project README

Augment Kokoro TTS

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

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.

Workflow

Step 1: Pre-upgrade health check
ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json
Step 2: Execute upgrade
ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/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
ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/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:

ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --uninstall
bash "$ROOT/scripts/kokoro-install.sh" --install

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

Troubleshooting

IssueCauseSolution
Upgrade failsNo internet or PyPI downCheck connectivity, retry
Import error aftermlx-audio incompatibilityClean reinstall: --uninstall then --install
Model download slowLarge downloadWait for HuggingFace download to complete

Post-Execution Reflection

After this skill completes, reflect before closing the task:

  1. Locate yourself. — Find this SKILL.md's canonical path before editing.
  2. What failed? — Fix the instruction that caused it.
  3. What worked better than expected? — Promote to recommended practice.
  4. What drifted? — Fix any script, reference, or dependency that no longer matches reality.
  5. Log it. — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

Comments

Markdown supported