full-stack-bootstrap_skill

This skill bootstraps the full TTS and Telegram stack on macOS, configuring secrets, environment, and symlinks for a ready-to-run system.

TypeScript

14

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill terrylica/cc-skills --skill full-stack-bootstrap

SKILL.md8.0 KB

Overview

This skill performs a one-time full-stack bootstrap of a Kokoro TTS engine, the Telegram bot via BotFather, and the sync between them on Apple Silicon macOS. It automates prerequisites checks, installs Kokoro with Python 3.13 in a venv, stores Telegram secrets securely, configures environment variables, and creates convenient shell symlinks. The goal is a reproducible, verified TTS + Telegram workflow ready for production or local development.

How this skill works

The skill runs a preflight checklist for Bun, mise, uv, and Python 3.13, then executes a bundled kokoro-install.sh to create a venv, install pinned Python deps, and download the Kokoro-82M model. It helps you create or verify a BotFather token, saves secrets under a secure directory, updates mise.toml environment entries, and symlinks TTS helper scripts into ~/.local/bin. Finally it verifies the stack by generating a test WAV and checking the Telegram bot API.

When to use it

First-time setup of the tts-telegram-sync plugin on an Apple Silicon Mac
After a clean OS reinstall or hardware migration to restore the full stack
Setting up a new development machine with Kokoro TTS + Telegram bot
Recovering from a broken install (after running kokoro-install.sh --uninstall)
Before running automated workflows that rely on KOKORO_VENV and bot secrets

Best practices

Run the preflight checks and install any missing system tools via Homebrew before bootstrapping
Keep ~/.claude/.secrets directory permissions restricted (700 for dir, 600 for files)
Use uv to install and pin Python 3.13 so the kokoro venv is reproducible
Ensure Apple Silicon MPS acceleration is available; Kokoro relies on MPS for performance
Add .mise.local.toml to .gitignore so secrets never enter source control

Example use cases

Set up a personal TTS Telegram bot that converts clipboard text to speech locally
Provision a new Mac for a teammate to run the same TTS + bot stack reliably
Recover a damaged environment by uninstalling then re-running the full bootstrap
Automate a CI step that validates the Kokoro installation and model availability
Create shell shortcuts to drive local TTS actions (speed controls, clipboard reads)

FAQ

No. The bootstrap targets Apple Silicon macOS because Kokoro uses MPS acceleration; Intel or other OSes are not supported by this installer.

Where are Telegram tokens stored and how are they protected?

Tokens are stored in ~/.claude/.secrets/ccterrybot-telegram with directory mode 700 and file mode 600. A .mise.local.toml references that file so the runtime loads secrets without committing them.