audio-debugging

Diagnose audio playback and Web Audio API issues across browsers and devices.

Updated Nov 20, 2025
One-click install
npx skills add https://github.com/Slaiaa/claude-agent-command-templates --skill audio-debugging-slaiaa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audio-debugging
Source: https://github.com/Slaiaa/claude-agent-command-templates/tree/main/templates/music-app/.claude/specialized/skills/audio-debugging
Command: npx skills add https://github.com/Slaiaa/claude-agent-command-templates --skill audio-debugging-slaiaa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers quickly identify and resolve audio-related problems in the VSSK‑shadecn music practice web app, such as playback failure, pitch distortion, speed control issues, caching problems, and service‑worker conflicts.

Core Features & Use Cases

  • Systematic Issue Identification: Guides you through asking the right questions about expected behavior, actual symptoms, and environment.
  • Diagnostic Checks: Provides checklists for common audio problems, including context state, network errors, CORS, and cache status.
  • Platform‑Specific Guidance: Offers tailored advice for iOS Safari, Chrome Android, and other browsers, plus ready‑to‑copy JavaScript snippets for debugging and fixing.

Quick Start

Ask the audio-debugging skill to investigate why the app’s audio playback is not working and receive a step‑by‑step diagnosis and fix.

Frequently Asked Questions about audio-debugging

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

FAQPage Schema
How do I debug Web Audio API playback issues in a browser?

To debug Web Audio API playback issues, systematically check the audio context state, network requests, CORS headers, and cache status. This diagnostic process identifies missing audio, pitch distortion, or service-worker conflicts across browsers and devices.

Why does audio playback fail on iOS Safari but work on desktop?

Audio playback on iOS Safari often fails due to strict media autoplay policies requiring user interaction to initialize the AudioContext. Platform-specific guidance and JavaScript console checks help diagnose and resolve these mobile browser audio issues.

How do I fix service-worker caching conflicts with web audio?

Fix service-worker caching conflicts with web audio by inspecting the cache status and network requests via browser APIs. Diagnostic commands help identify if stale cached audio files are causing playback failure or pitch distortion.

What causes pitch distortion in JavaScript web audio applications?

Pitch distortion in web audio applications is typically caused by incorrect sample rate settings or playback speed control issues. Systematic diagnostic checks of the AudioContext and playback nodes identify the source of the frequency distortion.

Can I use browser console commands to troubleshoot missing audio in my web app?

You can use browser console commands and JavaScript APIs to troubleshoot missing audio by checking the AudioContext state and network errors. Ready-to-copy diagnostic snippets provide step-by-step remediation for audio playback failures.