audio-injection-testing

Inject pre-recorded audio into virtual devices for wake word and STT testing.

Updated Nov 21, 2025
One-click install
npx skills add https://github.com/want2bet/BobTheSkull5 --skill audio-injection-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audio-injection-testing
Source: https://github.com/want2bet/BobTheSkull5/tree/main/.claude/skills/audio-injection-testing
Command: npx skills add https://github.com/want2bet/BobTheSkull5 --skill audio-injection-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables testing Bob The Skull using virtual audio devices, removing the need to repeatedly speak wake words. It helps validate wake word detection, STT accuracy, and the end-to-end conversation pipeline with automated audio injection and troubleshooting steps.

Core Features & Use Cases

  • Automated Wake Word Testing: Run hundreds of audio injections to verify wake word detection.
  • STT Accuracy Evaluation: Inject pre-recorded phrases and compare transcripts.
  • Full Pipeline Testing: Validate the entire pipeline from wake word to LLM response and TTS.
  • Troubleshooting Guidance: Provides setup, configuration, and debugging tips for common issues.

Quick Start

  • Run the virtual audio setup: python3 setup_combined_audio.py
  • Execute a test sequence: python3 test_wake_word_inject.py test --files audio/static/testing/wake_up_bob.mp3 audio/static/testing/hey_bob.mp3 --delay 2.0
  • Monitor logs for results: tail -f logs/bob.log

Frequently Asked Questions about audio-injection-testing

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

FAQPage Schema
How do I automate wake word detection testing without manually speaking commands repeatedly?

Audio injection testing automates wake word detection by injecting pre-recorded audio into virtual audio pathways instead of requiring manual speech. This enables running hundreds of test cycles on Linux and Windows to validate wake word detection accuracy and consistency without repetition.

Can I test speech-to-text accuracy with pre-recorded phrases?

Yes. This Skill injects pre-recorded audio files into virtual devices and captures transcription results, allowing you to compare STT output against known phrases and measure accuracy across test sequences with configurable delays and logging.

What setup is required to run audio injection testing on Linux and Windows?

Audio injection testing requires running virtual audio setup scripts, configuring devices by index or name, and preparing pre-recorded test audio files. The Skill provides setup automation, device configuration, test file sequencing, and cleanup procedures for repeatable, auditable testing across both platforms.

How do I validate an entire conversation pipeline from wake word detection through TTS response?

Execute test sequences injecting audio through the full pipeline: wake word detection triggers STT processing, which feeds the LLM, and TTS generates responses. Logging captures each stage, enabling end-to-end validation of wake word, transcription, and response generation in a single automated test run.

What audio formats and file types does audio injection testing support?

The Skill accepts pre-recorded audio files for injection testing. Supported formats include MP3 and other standard audio formats compatible with virtual audio device input on Linux and Windows, enabling flexible test asset management and sequencing.

Why use audio injection instead of live microphone input for testing?

Audio injection eliminates variability from ambient noise, microphone hardware, and repeated manual speech, enabling deterministic, reproducible test results. Virtual audio pathways ensure consistent input delivery, comprehensive logging, and scaled test execution without environmental interference.