BPM Finder
Finds the tempo of a track, suggests the right BPM for a genre and does the tempo math: delay times, bar lengths and durations.
npx skills add Vocaler-AI/music-skills --skill bpm-finderWhen your agent uses it
Finds and works with tempo: estimates BPM from an audio file (with the bundled script when code execution is available), from tap timings or from a description, gives genre tempo ranges, and converts BPM into delay times, bar lengths and durations. Use when the user asks for the BPM of a song or file, the right tempo for a genre, or tempo math.
- The user has an audio file and wants its tempo.
- Choosing a tempo for a genre or use.
- Delay/reverb times, bar lengths, or song duration at a BPM.
Example
Delay times for 128 BPM?
1/4 = 468.75 ms · 1/8 = 234.38 · 1/8 dotted = 351.56 · 1/16 = 117.19 · 1/4 triplet = 312.5 · one bar = 1.875 s
What it does, step by step
- If there is an audio file and you can run code, run `python scripts/detect_bpm.py <file>` (needs librosa) and report the estimate.
- If the user tapped beats, BPM = 60 / average interval in seconds; drop outliers first.
- Check half-time and double-time: a detected 140 might be felt as 70; say which fits the genre.
- For tempo math: one beat = 60000 / BPM ms; a 4/4 bar = 4 beats; dotted = x1.5; triplet = x2/3.
- Never invent the BPM of a specific released song from memory; say it needs the audio or a trusted database.
Rules it follows
- Show the formula with the numbers.
- Round BPM to one decimal place for detection, whole numbers for production choices.
Install
Any agent (skills CLI)
Installs into every agent it finds on your machine.
npx skills add Vocaler-AI/music-skills --skill bpm-finderClaude Code
Personal skills folder. Use .claude/skills/ inside a project to share it with your team.
git clone https://github.com/Vocaler-AI/music-skills && cp -r music-skills/skills/bpm-finder ~/.claude/skills/Claude Code plugin
The whole library as one plugin.
/plugin marketplace add Vocaler-AI/music-skills
/plugin install music-skills@vocaler-music-skillsClaude.ai & desktop
Settings → Capabilities → Skills → Upload, then choose the zip.
https://skills.vocaler.ai/dist/bpm-finder.zipOpenAI Codex
Codex reads skills from your Codex home folder.
git clone https://github.com/Vocaler-AI/music-skills && cp -r music-skills/skills/bpm-finder ~/.codex/skills/More harnesses: Gemini CLI, Copilot, Cursor, any chatbot
The SKILL.md
Show the full file (2,257 characters)
--- name: bpm-finder description: "Finds and works with tempo: estimates BPM from an audio file (with the bundled script when code execution is available), from tap timings or from a description, gives genre tempo ranges, and converts BPM into delay times, bar lengths and durations. Use when the user asks for the BPM of a song or file, the right tempo for a genre, or tempo math." license: MIT metadata: author: Vocaler version: "1.0.0" category: music-production homepage: https://skills.vocaler.ai/bpm-finder/ repository: https://github.com/Vocaler-AI/music-skills --- # BPM Finder Finds the tempo of a track, suggests the right BPM for a genre and does the tempo math: delay times, bar lengths and durations. ## When to use - The user has an audio file and wants its tempo. - Choosing a tempo for a genre or use. - Delay/reverb times, bar lengths, or song duration at a BPM. ## What to look for in the request - An audio file path, tap timestamps, or a description. - Genre. Do not interview the user. If something is missing, make a sensible assumption, state it in one line, and deliver. Ask only when the answer would change the result completely. ## Workflow 1. If there is an audio file and you can run code, run `python scripts/detect_bpm.py <file>` (needs librosa) and report the estimate. 2. If the user tapped beats, BPM = 60 / average interval in seconds; drop outliers first. 3. Check half-time and double-time: a detected 140 might be felt as 70; say which fits the genre. 4. For tempo math: one beat = 60000 / BPM ms; a 4/4 bar = 4 beats; dotted = x1.5; triplet = x2/3. 5. Never invent the BPM of a specific released song from memory; say it needs the audio or a trusted database. ## Rules - Show the formula with the numbers. - Round BPM to one decimal place for detection, whole numbers for production choices. ## Output format ```markdown **Tempo:** n BPM (feel: ...) · **Confidence:** ... | Note | ms | (1/4, 1/8, 1/8 dotted, 1/16, 1/4 triplet) **Bar length:** n s ``` ## Example **Request:** Delay times for 128 BPM? **Response (abridged):** ``` 1/4 = 468.75 ms · 1/8 = 234.38 · 1/8 dotted = 351.56 · 1/16 = 117.19 · 1/4 triplet = 312.5 · one bar = 1.875 s ``` ## Bundled files - `scripts/detect_bpm.py`