sounds-on-the-web

Audit UI code for audio feedback best practices and accessibility violations.

3|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/langgenius/due-date-hq-jwl --skill sounds-on-the-web-langgenius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sounds-on-the-web
Source: https://github.com/langgenius/due-date-hq-jwl/tree/main/.claude/skills/sounds-on-the-web
Command: npx skills add https://github.com/langgenius/due-date-hq-jwl --skill sounds-on-the-web-langgenius

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? UI sound effects are often implemented without accessibility safeguards, appropriate use cases, or correct playback handling, leading to annoying or inaccessible experiences. This Skill audits your UI code against a structured rule set and reports every violation with file and line references. ## Core Features & Use Cases - Rule-Based Auditing: Checks code against 15 rules across four categories: accessibility (a11y-), appropriateness (appropriate-), implementation (impl-), and weight matching (weight-). - Precise Findings Output: Reports each issue in file:line - [rule-id] description format plus a severity summary table. - Use Case: Before shipping a feature that plays sounds on button clicks and form submissions, run this audit to catch missing sound toggles, missing prefers-reduced-motion checks, sounds on high-frequency interactions like typing, and audio that is not preloaded. ## Quick Start Ask the AI to audit the sound implementation in your components directory using the sounds-on-the-web rules and list all findings.

Frequently Asked Questions about sounds-on-the-web

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

FAQPage Schema
How do I audit UI sound effects for accessibility?

Run this audit against your component files to check accessibility rules like visual equivalents for every audio cue, a settings toggle to disable sounds, prefers-reduced-motion respect, and independent volume control. Findings are reported with file and line numbers.

When should web apps play sound effects on interactions?

Sound is appropriate for significant confirmations like payments, form submissions, errors, and notifications. It should be avoided for high-frequency interactions like typing, hover, scroll, and navigation, and for purely decorative moments with no informational value.

Should web audio respect prefers-reduced-motion?

Yes. The a11y-reduced-motion-check rule treats prefers-reduced-motion as a proxy for sound sensitivity. Code should check window.matchMedia("(prefers-reduced-motion: reduce)") and skip playback when the user has enabled that preference.

Why does my audio not replay on rapid repeated clicks?

An Audio element will not restart while it is still playing. Reset audio.currentTime to 0 before calling play() so the sound can retrigger immediately, which is what the impl-reset-current-time rule checks for.

What are the limitations of a rule-based sound audit?

The audit only inspects code patterns against its 15 defined rules; it cannot judge subjective sound design quality or actual audio content. It also requires you to specify which files or patterns to review.