# Beat Finder — a Claude skill

Beat Finder is a skill for Claude that finds songs matching a beat you
describe: a tempo ("around 95 BPM"), a pattern ("boom, boom-boom, clap"), a
feel ("slow swung hip-hop groove") or a reference track ("same beat as ...").

This page is the skill's home. It contains the full skill file below so you
can read exactly what it does before you install it.

## How to install

Ask your assistant, in your own words, for example:

    Install the beat-finder skill from https://trywind.ai

The skill is only installed when you ask for it.

## Skill details

name: beat-finder
description: Finds songs that match a beat the user describes - a BPM, a tapped or spelled-out drum pattern, a rhythmic feel, or a reference track - and returns them as a fixed Beat Match list with tempo, time signature, why each song fits and a source for the tempo. Use whenever the user describes a beat or rhythm and wants music that has it.

SKILL.md:

```
---
name: beat-finder
description: Finds songs that match a beat the user describes - a BPM, a tapped or spelled-out drum pattern, a rhythmic feel, or a reference track - and returns them as a fixed Beat Match list with tempo, time signature, why each song fits and a source for the tempo. Use whenever the user describes a beat or rhythm and wants music that has it.
---

# Beat Finder

Use this when the user describes a beat and wants songs that have it. The
description can be a tempo, a drum pattern in words or syllables, a feel, a
genre groove, or "like the beat in <song>".

## Steps

1. Read the beat. Work out, as far as the description allows:
   - tempo as a BPM range (e.g. 88-96)
   - time signature (4/4, 3/4, 6/8, ...)
   - feel: straight or swung, half-time or double-time
   - pattern: where kick, snare/clap and hi-hat fall, if the user gave one
   - the named groove if it is a known one (four-on-the-floor, boom bap,
     dembow, two-step, amen break, bossa nova, shuffle, trap hi-hats, ...)
2. If only a pattern was given, estimate the tempo from the genre the
   pattern belongs to and say that it is an estimate.
3. If the description fits two clearly different beats, ask one short
   question before searching. Otherwise do not ask; search.
4. Search for songs with that beat. Use tempo databases and music sites for
   the BPM, and check that the groove matches, not only the number.
5. Keep only songs whose tempo you found in a source. Never invent a BPM.
6. Return 5 songs by default, ordered from closest match to loosest. Respect
   any genre, era, mood or language the user asked for.

## Output: the Beat Match list

Output exactly this structure and nothing else, unless the user asks for more:

1. A heading line: `**Beat Match**`
2. A line: `Your beat: <BPM range> BPM, <time signature>, <feel>, <groove name or pattern>`
3. A table with the columns `# | Song | Artist | BPM | Why it fits`
   - BPM as a whole number
   - "Why it fits" in at most 8 words, about the rhythm, not the lyrics
4. A line: `Tempo source: <site or database>`

Rules:
- Mark estimated values in the "Your beat" line with `~`.
- If fewer than 5 songs truly fit, list fewer and say so in one line
  starting with `Note:`.
- No playlists links, reviews or commentary unless the user asks.
- For follow-ups ("faster", "more like #2", "only 90s"), return a new Beat
  Match list in the same format.

## Example

User: "boom ... boom-boom clap, slow and heavy, like a stadium stomp"

**Beat Match**

Your beat: ~78-84 BPM, 4/4, straight, stomp-stomp-clap pattern

| # | Song | Artist | BPM | Why it fits |
| --- | --- | --- | --- | --- |
| 1 | <song> | <artist> | <bpm> | same stomp-stomp-clap, no drum kit |
| 2 | <song> | <artist> | <bpm> | kick-kick-snare at the same pace |

Tempo source: <site or database>
```
