VocalerMusic Skills

Music Skills / Music production / BPM Finder

Music production·bpm-finder

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-finder

When 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

You ask

Delay times for 128 BPM?

The agent answers (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

What it does, step by step

  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 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-finder

Claude 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-skills

Claude.ai & desktop

Settings → Capabilities → Skills → Upload, then choose the zip.

https://skills.vocaler.ai/dist/bpm-finder.zip

OpenAI 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`

More music production skills