| name | long-task-voice-progress |
| description | Emit clear progress updates by default for most non-trivial tasks and speak milestone status. Use whenever work has multiple phases, may include long-running commands or tests, involves waiting on tools or agents, or benefits from hands-free audible status. |
Long Task Voice Progress
Overview
Emit concise milestone updates aligned to real execution state so progress reports stay trustworthy.
Trigger Heuristics
Use this skill by default for non-trivial work, especially when any of the following are true:
- The task has
>=2 phases (for example: discovery, implementation, validation, completion).
- You are about to run commands or tests that may take
>30s.
- You are waiting on tools, background jobs, or sub-agents and progress may otherwise appear stalled.
Workflow
- Announce the interpreted task and first action.
- Announce each major phase transition (context, implementation, validation, completion).
- Announce blockers with the blocked step and immediate recovery action.
- Announce completion with what changed and what verification ran.
Message Rules
- Keep spoken messages short (target under 18 words).
- Use present-tense action verbs and include the next concrete action.
- Mention concrete artifacts when relevant (
file, service, test suite, migration).
- Avoid filler or generic status text.
Invocation
Run the helper script via Bash to emit an audible progress update:
bash scripts/say-progress.sh "Starting test suite for auth module"
The script path is relative to this skill directory. Use the full path when invoking from elsewhere:
The script always emits a [progress] text line to stdout regardless of audio availability, so progress is visible even when muted or on a headless machine.
