clean-component-removal_skill

Overview

This skill performs an orderly teardown of TTS (Kokoro) and Telegram bot components on macOS (Apple Silicon). It sequences stop, uninstall, and file-removal steps to avoid orphaned processes and stale locks. User confirmation is required before any destructive action.

How this skill works

The skill inspects running processes, stops the Telegram bot, uninstalls the Kokoro virtual environment, and removes symlinks and temporary TTS files. It preserves large or reusable artifacts (model cache, bot source, config, logs) by default and offers an explicit option to remove secrets. Each removal step outputs status so you can verify success.

When to use it

• You want to fully uninstall the Kokoro TTS engine
• You need to remove the Telegram bot process before reconfiguration
• You want to clean TTS temporary files and symlinks to resolve failures
• You plan a full teardown before reinstalling or upgrading components
• You want to selectively remove only specific components (bot, venv, symlinks, temp, or secrets)

Best practices

• Ask for explicit confirmation before running destructive commands
• Stop the bot process first to avoid orphaned audio processes or lock contention
• Preserve model cache and source code unless you need to reclaim disk space
• List files (symlinks, temp, secrets) before removing to confirm targets
• Run verification checks after removal (pgrep, ls) and report results back to the user

Example use cases

• Full teardown prior to a clean reinstall of TTS and Telegram sync
• Remove only the Kokoro venv and symlinks to reset the TTS runtime
• Stop the bot process when it misbehaves or respawns unexpectedly
• Clean temporary WAV and lock files to fix stuck audio jobs
• Optionally purge Telegram secrets when rotating credentials or deprovisioning a bot