transcription-debugger

Diagnose VoiceLite transcription failures by tracing event chains and testing Whisper processes.

12|3|Updated Sep 24, 2025
One-click install
npx skills add https://github.com/mikha08-rgb/VoiceLite --skill transcription-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: transcription-debugger
Source: https://github.com/mikha08-rgb/VoiceLite/tree/main/.claude/skills/transcription-debugger
Command: npx skills add https://github.com/mikha08-rgb/VoiceLite --skill transcription-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill quickly identifies and resolves common VoiceLite transcription failures, such as silent errors, missing text output, or Whisper process issues, restoring reliable voice typing for users.

Core Features & Use Cases

  • Event Chain Verification: Traces the audio recording and transcription event flow to pinpoint where failures occur.
  • Whisper Process Testing: Provides commands to manually test the whisper.exe subprocess and diagnose its behavior.
  • Logging Analysis: Guides on how to inspect VoiceLite logs for critical diagnostic patterns and error messages.
  • Use Case: If a user reports that VoiceLite records audio but no text appears, use this skill to guide through checking event subscriptions, verifying the Whisper executable, and analyzing logs to quickly identify if the AudioFileReady event is firing or if the Whisper process is hanging.

Quick Start

Debug a VoiceLite transcription issue where no text appears after speaking, focusing on the AudioFileReady event and Whisper process status.

Frequently Asked Questions about transcription-debugger

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

FAQPage Schema
How do I fix VoiceLite transcription when audio records but no text appears?

Diagnose transcription failures by verifying the AudioFileReady event fires during recording, confirming the Whisper executable runs without hanging, and inspecting VoiceLite logs for error patterns. Trace the event chain from recording through transcription to isolate where the failure occurs.

What causes silent failures in voice transcription and how do I detect them?

Silent failures occur when the audio processing pipeline completes without errors but produces no text output. Enable comprehensive logging across all builds and validate event subscriptions to detect when critical lifecycle events fail to trigger or propagate.

How do I test if the Whisper process is working correctly?

Manually execute the whisper.exe subprocess with test audio files and inspect its output and error streams. This isolates whether transcription failures stem from the Whisper model, file integrity issues, or event-chain problems upstream.

What should I check when Whisper errors occur during transcription?

Verify the Whisper executable exists and is accessible, confirm audio files are valid WAV or MP3 format with proper permissions, check system resources, and review Whisper process logs for model loading or decoding errors.

Can I use this to debug voice typing failures across different audio formats?

Yes. The debugging scope covers recording and transcription across the full VoiceLite pipeline regardless of input source. Diagnostic guidance applies to any scenario where voice typing produces no output or fails silently.

Why does my audio recording succeed but transcription never starts?

This typically indicates the AudioFileReady event isn't firing or isn't triggering the Whisper subprocess. Validate event subscriptions, check the event chain for broken links, and verify the transcription handler is properly registered in your lifecycle configuration.