audio-loop

Convert audio to gapless FLAC loops with Web Audio snippets.

2|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/coroboros/agent-skills --skill audio-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audio-loop
Source: https://github.com/coroboros/agent-skills/tree/main/skills/audio-loop
Command: npx skills add https://github.com/coroboros/agent-skills --skill audio-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, ffprobe, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Automates turning any audio clip into a seamless, web-ready loop by normalizing loudness, aligning stereo balance, and encoding to FLAC, plus providing a drop-in Web Audio snippet that unlocks on first user gesture.

Core Features & Use Cases

  • Auto balance stereo channels to center the image for two-channel inputs and correct audible bias above a 1 dB delta.
  • Normalize loudness to a target LUFS and encode to FLAC for truly gapless looping in browsers.
  • Output includes a ready-to-paste Web Audio snippet and an example integration demonstrating gesture-based unlock for autoplay constraints.
  • Use cases include ambient website backgrounds, hero sections, mood audio, and long-tail loops for interactive experiences.

Quick Start

Upload an audio clip and insert the emitted .flac file and the Web Audio snippet into your web page to enable a seamless, gesture-unlocked loop.

Frequently Asked Questions about audio-loop

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

FAQPage Schema
How do I create a seamless audio loop for web playback?

Creating a seamless audio loop involves normalizing loudness to a target LUFS, correcting stereo balance, and encoding to a gapless format like FLAC. The process outputs a drop-in Web Audio snippet to handle browser playback and gesture-based unlocking.

Why does my audio loop have a gap or click when playing in the browser?

Audio loops click in the browser due to gaps in compressed formats or misaligned audio segments. Encoding to a lossless FLAC format ensures truly gapless looping, while loudness normalization and true peak validation prevent audible popping at the loop point.

Do I need ffmpeg and ffprobe to normalize audio loudness for web loops?

Yes, ffmpeg and ffprobe are required dependencies to probe audio characteristics and encode the output. They handle the loudness normalization to a target LUFS, perform optional stereo balance correction, and execute the lossless FLAC encoding.

Can I use Web Audio API to autoplay background audio on a website?

Browsers block autoplaying Web Audio without a user gesture. The provided JavaScript snippet unlocks audio playback on the first user interaction, allowing seamless background loops for website hero sections and ambient mood audio.

What is LUFS normalization and true peak validation for audio processing?

LUFS normalization adjusts the perceived loudness of an audio clip to a specific target level, while true peak validation checks for inter-sample peaks to prevent clipping. These steps ensure the final FLAC loop plays smoothly without volume spikes.

How do I fix unbalanced stereo channels in an audio clip?

To fix unbalanced stereo channels, the audio is analyzed for channel bias, and correction is applied if the delta exceeds 1 dB. This auto-balancing centers the stereo image for two-channel inputs before encoding to the final FLAC loop.