settings-and-tuning

Original：🇺🇸 English

Translated

Configure TTS voices, speed, timeouts, queue depth, and bot settings. TRIGGERS - configure tts, change voice, tts speed, queue depth, tts timeout, bot config, tune settings, adjust parameters.

2installs

Sourceterrylica/cc-skills

Added on2026-02-28

NPX Install

npx skill4agent add terrylica/cc-skills settings-and-tuning

SKILL.md Content

View Translation Comparison →

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:

bash

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`	Generation and playback timeouts
TTS Queue	`TTS_MAX_QUEUE_DEPTH` , `TTS_STALE_TTL_MS` , `TTS_MAX_TEXT_LEN`	Queue limits and staleness
TTS Signal	`TTS_SIGNAL_SOUND`	Signal sound path (empty to disable)
Rate Limiting	`NOTIFICATION_MIN_INTERVAL_MS` , `SUMMARIZER_*`	Notification and summarizer throttling
Prompt Executor	`PROMPT_*`	Prompt execution throttling and circuit breaker
Session Picker	`SESSION_*`	Session scanning and display limits
Audit	`AUDIT_RETENTION_DAYS`	Log retention period
Model	`HAIKU_MODEL`	Claude model for Agent SDK calls

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: