extract-beat-grid

Generate a beat-grid JSON file from audio or video using librosa.

6|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/gooseworks-ai/gooseworks-ads-skills --skill extract-beat-grid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extract-beat-grid
Source: https://github.com/gooseworks-ai/gooseworks-ads-skills/tree/main/skills/atoms/audio-editing/extract-beat-grid
Command: npx skills add https://github.com/gooseworks-ai/gooseworks-ads-skills --skill extract-beat-grid

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill analyzes audio or video files and generates a beat-grid.json file containing rhythmic information, enabling synchronization of cuts, captions, or sound effects to a musical grid.

Core Features & Use Cases

  • Beat Detection: Detects beats, bars, downbeats, onsets, and BPM from audio or video files.
  • Output File: Produces a beat-grid.json file with the rhythmic skeleton of the track.
  • Use Case: Ideal for ad production, where synchronization to a musical beat is crucial for pacing and rhythm.

Quick Start

Run the extract-beat-grid skill with the path to your audio/video file and the desired output directory.

Frequently Asked Questions about extract-beat-grid

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

FAQPage Schema
How do I extract a beat grid from an audio file for video editing?

You can extract a beat grid from an audio file to generate a beat-grid.json file containing rhythmic data. This allows you to synchronize video cuts, captions, or sound effects directly to the musical grid.

Can I detect BPM and beats directly from a video file without separating the audio first?

Yes, you can detect BPM and beats directly from a video file. The process utilizes ffmpeg internally to extract the audio stream, followed by librosa for beat and onset detection to map the rhythm.

What rhythmic data is included in a generated beat-grid JSON file?

A generated beat-grid JSON file includes the rhythmic skeleton of the track. It contains detected beats, bars, downbeats, onsets, and BPM data extracted from the source audio or video file.

Do I need ffmpeg and librosa installed to run audio analysis for beat detection?

Yes, you need ffmpeg and librosa installed. Librosa handles the audio analysis for beat and onset detection, while ffmpeg is required specifically for extracting audio from video files.

What is the best way to synchronize ad production cuts to a musical beat?

The best way to synchronize ad production cuts is by generating a beat-grid.json file from your track. This provides a precise rhythmic skeleton, enabling accurate pacing and synchronization of cuts to the music.