BPM Finder Agent Skill for Openclaw

A precision tool for estimating BPM through tap intervals, audio file analysis, and tempo conversion within an AI agent workflow.

wsgtcyx
v1.0.0
Mar 7, 2026
0
711
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install bpm-finder

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install bpm-finder using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is BPM Finder Agent Skill?

The BPM Finder skill is a specialized utility designed to handle practical tempo-related tasks directly within your coding environment. As a key component of the Openclaw Skills library, it enables developers to estimate beats per minute from manual tap sequences, convert tempo into millisecond values for production, and analyze local audio files using command-line scripts. It provides a lightweight alternative to full-scale web applications for quick musical calculations.

This skill is particularly effective for users who need immediate feedback on track speed without leaving their IDE. By integrating Openclaw Skills into your development process, you gain access to powerful CLI-based logic that handles tempo normalization and audio processing via standard tools like ffmpeg.

BPM Finder Agent Skill Use Cases

  • Estimating the BPM of a song using manual tap intervals or timestamps.
  • Performing local audio file analysis to determine tempo and analysis confidence.
  • Converting BPM to milliseconds per beat or bar for precise music production timing.
  • Normalizing half-time or double-time readings into a standard 70-180 BPM range.
  • Deciding when to route complex batch analysis tasks to a browser-based interface.

How BPM Finder Agent Skill Works

  1. The agent classifies the incoming request to determine if it requires math, CLI script execution, or external routing.
  2. For manual input, the agent processes tap arrays or timestamps through the bundled scripts/tap-tempo.js utility.
  3. For file-based requests, it utilizes the CLI to analyze local audio paths and extract metadata like beat offset and duration.
  4. It applies normalization logic to ensure the reported BPM fits within practical musical ranges.
  5. The final output is delivered with clear metrics including confidence scores and analysis windows.

BPM Finder Agent Skill Setup

To get started with this addition to your Openclaw Skills, ensure you have Node.js and ffmpeg installed in your environment. Use the following commands to interact with the local scripts:

# Run tap tempo analysis using intervals
node scripts/tap-tempo.js --intervals 500,502,498,500

# Analyze a local audio file
node scripts/tap-tempo.js --audio-file /path/to/track.mp3 --min-tempo 80 --max-tempo 160

BPM Finder Agent Skill Data Schema & Taxonomy

The skill generates structured data based on the type of analysis performed. These metrics help in maintaining high accuracy within the Openclaw Skills ecosystem.

Property Description Source
bpm The calculated beats per minute All
averageIntervalMs Mean time between detected beats Taps
confidence Statistical certainty of the analysis Audio File
analysisWindow The specific audio segment processed Audio File
beatOffsetSeconds The time offset of the first detected beat Audio File

BPM Finder Agent Skill Advanced Features

  • Intelligent half-time and double-time normalization for practical tempo ranges.
  • Support for both interval-based and timestamp-based manual tap arrays.
  • Local audio analysis with customizable minimum and maximum tempo constraints.
  • Seamless hand-off logic to browser-based tools for batch file processing.
  • Precision tempo math for calculating millisecond values per beat and bar.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*