How do I install the Augment skill?

Run npx skillmds add terrylica/augment in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Augment safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Augment?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Augment free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Augment?

terrylica (@terrylica) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Augment by terrylica — Agent Skill

Name: Augment
Rating: 4.2 (5 reviews)
Author: terrylica

File contents

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

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

Post-Execution Reflection

After this skill completes, reflect before closing the task:

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

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

---name: augmentdescription: Augment Kokoro TTS engine — upgrade dependencies and model. Renamed from 'upgrade' to avoid clashing with Claude Code's built-in.--- # 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 ```bash ROOT="$(cc-plugin-root kokoro-tts)" bash "$ROOT/scripts/kokoro-install.sh" --health cat ~/.local/share/kokoro/version.json ``` ### Step 2: Execute upgrade ```bash 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 ```bash 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: ```bash 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 | 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 | ## Post-Execution Reflection After this skill completes, reflect before closing the task: 0. **Locate yourself.** — Find this SKILL.md's canonical path before editing. 1. **What failed?** — Fix the instruction that caused it. 2. **What worked better than expected?** — Promote to recommended practice. 3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality. 4. **Log it.** — Evolution-log entry with trigger, fix, and evidence. Do NOT defer. The next invocation inherits whatever you leave behind.

Frequently asked questions