health

Original：🇺🇸 English

Translated

Health check for TTS and Telegram bot subsystems. TRIGGERS - tts health, kokoro status, telegram bot check, tts diagnostics.

2installs

Sourceterrylica/cc-skills

Added on2026-02-28

NPX Install

npx skill4agent add terrylica/cc-skills health

SKILL.md Content

View Translation Comparison →

TTS Telegram Sync Health Check

Run 10 subsystem health checks to verify the full TTS + bot stack.

Checks


pgrep -la 'bun.*src/main.ts'
curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getMe" | jq .ok
[[ -d ~/.local/share/kokoro/.venv ]]
~/.local/share/kokoro/.venv/bin/python -c "import kokoro"
python -c "import torch; assert torch.backends.mps.is_available()"
/tmp/kokoro-tts.lock
pgrep -x afplay
[[ -f ~/.claude/.secrets/ccterrybot-telegram ]]
find /tmp -name "kokoro-tts-*.wav" -mmin +5
[[ -L ~/.local/bin/tts_kokoro.sh ]]

#	Check	Command
1	Bot process	`pgrep -la 'bun.*src/main.ts'`
2	Telegram API	`curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getMe" \| jq .ok`
3	Kokoro venv	`[[ -d ~/.local/share/kokoro/.venv ]]`
4	Kokoro import	`~/.local/share/kokoro/.venv/bin/python -c "import kokoro"`
5	MPS available	`python -c "import torch; assert torch.backends.mps.is_available()"`
6	Lock state	Check `/tmp/kokoro-tts.lock` mtime and PID
7	Audio processes	`pgrep -x afplay` / `pgrep -x say`
8	Secrets file	`[[ -f ~/.claude/.secrets/ccterrybot-telegram ]]`
9	Stale WAVs	`find /tmp -name "kokoro-tts-*.wav" -mmin +5`
10	Shell symlinks	`[[ -L ~/.local/bin/tts_kokoro.sh ]]`

Execution

Quick Health Check

bash

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/tts-telegram-sync}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health

Full Stack Check

Run all 10 checks and display results as

[OK]

/

[FAIL]

table. For each failure, suggest the appropriate skill to fix it:

Failure	Recommended Skill
Bot not running	bot-process-control
Kokoro issues	full-stack-bootstrap
Lock stuck	diagnostic-issue-resolver
Secrets missing	full-stack-bootstrap
Symlinks broken	full-stack-bootstrap

Troubleshooting

Issue	Cause	Solution
All checks fail	Not set up yet	Run `/tts-telegram-sync:setup` first
Only Kokoro fails	Venv corrupted	`kokoro-install.sh --uninstall` then `--install`
Lock stuck	Heartbeat died	See diagnostic-issue-resolver skill