🇺🇸English
Settings and Tuning
Configure all adjustable parameters for the TTS engine, Telegram bot, and supporting infrastructure. All settings are centralized in the mise.toml SSoT.
Platform : macOS (Apple Silicon)
When to Use This Skill
- Changing TTS voice (English, Chinese, or macOS
say voices)
- Adjusting speech speed
- Tuning TTS timeouts or queue depth
- Configuring notification rate limiting or circuit breakers
- Adjusting prompt executor throttling
- Modifying session picker limits
- Changing audit log retention
Requirements
| Component | Required | Installation |
|---|
| mise | Yes | brew install mise (for env loading) |
| Bot running | Recommended | Changes to TTS/queue settings require bot restart |
Workflow Phases
Phase 0: Read Current Configuration
Read the current mise.toml to see all active settings:
cat ~/.claude/automation/claude-telegram-sync/mise.toml
All configurable values live in the [env] section. The file is the single source of truth for the entire stack.
Phase 1: Identify What to Change
Present the config groups to the user via AskUserQuestion. Config groups:
| Group | Settings | Description |
|---|
| TTS Voice | TTS_VOICE_EN, TTS_VOICE_ZH, TTS_VOICE_SAY_EN, TTS_VOICE_SAY_ZH | Voice selection per language |
| TTS Speed | TTS_SPEED | Speech rate multiplier |
| TTS Timeouts | TTS_GENERATE_TIMEOUT_MS, TTS_SAY_TIMEOUT_MS |
Phase 2: Edit Configuration
Edit the appropriate line(s) in ~/.claude/automation/claude-telegram-sync/mise.toml. Use the Edit tool to make precise changes to specific values.
Phase 3: Validate and Apply
- Verify the edited value is within the valid range (see Config Reference)
- If TTS, queue, or rate limiting settings changed, restart the bot:
# Option A: If using mise tasks
cd ~/.claude/automation/claude-telegram-sync && mise run bot:restart
# Option B: Manual restart
pkill -f "bun.*main.ts" && cd ~/.claude/automation/claude-telegram-sync && bun --watch run src/main.ts
- Confirm new settings are active by checking bot logs or testing the affected feature
TodoWrite Task Templates
Template: Settings Adjustment
1. [Read] Read current mise.toml configuration
2. [Identify] Present config groups to user via AskUserQuestion
3. [Select] User selects setting category to modify
4. [Edit] Update mise.toml with new values
5. [Validate] Verify values are in valid range
6. [Apply] Restart bot to apply changes (if TTS or queue settings changed)
7. [Verify] Confirm new settings are active
Post-Change Checklist
After modifying this skill:
- Verify all config groups in SKILL.md match current mise.toml
- Update config-reference.md if new env vars were added
- Test that changed settings take effect after bot restart
- Update
references/evolution-log.md with change description
Troubleshooting
| Issue | Cause | Solution |
|---|
| Settings not taking effect | Bot not restarted | Restart bot after changing mise.toml |
| mise.toml parse error | Invalid TOML syntax | Check for missing quotes or unescaped chars |
| Voice not found | Invalid voice name | Check voice catalog (Kokoro voices are case-sensitive) |
| Speed too fast/slow | Value out of range | Use 0.5 to 2.0 range for TTS_SPEED |
| Circuit breaker stuck open | Too many failures | Wait for breaker timeout or restart bot |
| Timeout too short | TTS generation slow on first run | Model warmup takes longer; increase timeout |
Reference Documentation
- Config Reference - Full reference table with all env vars, defaults, valid ranges, and component ownership
- mise.toml Reference - Hub/spoke mise architecture, secret loading, and task file structure
- Evolution Log - Change history for this skill
Weekly Installs
47
Repository
terrylica/cc-skills
GitHub Stars
24
First Seen
Feb 17, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
amp46
github-copilot46
codex46
kimi-cli46
gemini-cli46
cursor46
