voice-state-machine

Orchestrate on-device voice command workflows with XState state-machine transitions.

Updated Jan 18, 2026

Search Tags:#voice #mobile #whisper #xstate #state-machine #wake-word #vad

Ready to run

npx skills add https://github.com/333-333-333/iris --skill voice-state-machine

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: voice-state-machine
Source: https://github.com/333-333-333/iris/tree/main/skills/voice-state-machine
Command: npx skills add https://github.com/333-333-333/iris --skill voice-state-machine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing on-device voice assistants requires reliable coordination between wake word detection, speech recognition, command execution, and output with robust recovery. This Skill provides a state-machine pattern (XState) to orchestrate listening, processing, and speaking, simplifying development, testing, and maintenance across mobile apps.

Core Features & Use Cases

Deterministic transitions among IDLE, LISTENING, PROCESSING, SPEAKING, ERROR, and RECOVERING states.
Seamless wake word detection integration, command parsing, and error recovery paths.
Modular integration with Whisper-based recognizers and VAD-driven control for on-device or hybrid setups.

Quick Start

Start the voice state machine on your device to begin listening and processing user input.

Frequently Asked Questions about voice-state-machine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I coordinate wake word detection and speech recognition in a mobile voice assistant?▼

Coordinate wake word detection and speech recognition using a state-machine pattern that enforces deterministic transitions between listening, processing, and speaking states for robust on-device voice flows.

What is the best way to handle error recovery in on-device voice command workflows?▼

Handle error recovery in on-device voice command workflows by defining explicit ERROR and RECOVERING states within a state machine, ensuring deterministic transitions and robust handling across mobile contexts.

Can I use Whisper and VAD together for voice activity detection on mobile?▼

Yes, you can integrate Whisper and VAD together for voice activity detection on mobile through the state machine's modular integration, enabling on-device or hybrid setups for speech recognition and control.

How does a state machine pattern improve mobile voice assistant development?▼

A state machine pattern improves mobile voice assistant development by orchestrating listening, processing, and speaking phases with deterministic transitions, simplifying testing and maintenance across mobile apps.

What states are needed for a robust on-device voice processing state machine?▼

A robust on-device voice processing state machine requires IDLE, LISTENING, PROCESSING, SPEAKING, ERROR, and RECOVERING states to coordinate wake word detection, command parsing, and audio output.

Does XState work for managing wake word detection and listening states on mobile?▼

XState works for managing wake word detection and listening states on mobile by providing a state-machine pattern that enforces deterministic transitions and modular integration across voice command workflows.