Search

PythonReactSEOPDF
OpenClaw

music-analysis

Analyze music/audio files locally without external APIs. Extract tempo (BPM), key estimate, section boundaries, loudness dynamics, spectral/timbre descriptors, and temporal mood journeys. Use when asked to 'hear the music,' audit tracks, compare mixes, inspect structure, or generate producer-facing notes from audio files.

adam-researchh0 source installs☆ 0 Repository stars

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

SkillHub CLI

skillhub install adam-researchh/music-analysis

Inspect the source and compatibility requirements, then follow its installation steps.

Give your agent the source link and ask it to inspect instructions and dependencies before explaining the installation steps.

View source ↗Guides

Skill instructions

Music Analysis (Local, No External APIs)

Analyze audio files using signal processing. Two tools:

1. Quick Analysis — snapshot of the whole track

python3 skills/music-analysis/scripts/analyze_music.py /path/to/audio.mp3
python3 skills/music-analysis/scripts/analyze_music.py track.mp3 --json

Reports: duration, sample rate, tempo (BPM), key estimate, energy stats (RMS mean/std/p95), spectral summary (centroid, rolloff, contrast), coarse section boundaries.

2. Temporal Listen — experience the track as a journey

python3 skills/music-analysis/scripts/temporal_listen.py /path/to/audio.mp3
python3 skills/music-analysis/scripts/temporal_listen.py track.mp3 --json

Reports: sliding-window analysis (4s windows, 2s hops) producing a full timeline of:

  • Energy level (relative to track average)
  • Mood labels (simmering, soaring, erupting, full force, submerged, ethereal, etc.)
  • Transitions (drop hits, pulls back, shifts color, evolves)
  • Texture decomposition (harmonic/percussive ratio, onset density, roughness)
  • Tension model (sustained intensity tracking)
  • Narrative arc (mountain, ascending, descending, plateau, wave)
  • Peak moment, quietest moment, mood journey summary
How it works

No AI/ML models — pure signal processing via librosa:

  • RMS energy per window (relative to global average)
  • Spectral centroid (brightness), rolloff, flatness
  • Harmonic/percussive source separation (HPSS)
  • Onset detection (rhythmic activity density)
  • Zero-crossing rate (texture roughness)
  • Mood labels are rule-based mappings from these features
Mood vocabulary
Mood Condition
submerged Low energy, dark frequencies
ethereal Low energy, high harmonic ratio
breathing Low energy, other
simmering Mid-low energy, warm
restless Mid-low energy, high onset density
floating Mid-low energy, bright
driving Mid energy, percussive
soaring Mid energy, harmonic...

Source information

Source
github
Repository
openclaw/skills
Path
skills/adam-researchh/music-analysis
Version
—
Commit
0bb8b76709957eb159afa2889c11f35747f4abaa
Classification source
rules
Status
active
Visibility
public

These signals come from indexed source analysis and may lag behind changes. Check the current source files.

Extracted content

SKILL.md
# Music Analysis (Local, No External APIs)

Analyze audio files using signal processing. Two tools:

## 1. Quick Analysis — snapshot of the whole track

```bash
python3 skills/music-analysis/scripts/analyze_music.py /path/to/audio.mp3
python3 skills/music-analysis/scripts/analyze_music.py track.mp3 --json
```

**Reports:** duration, sample rate, tempo (BPM), key estimate, energy stats (RMS mean/std/p95), spectral summary (centroid, rolloff, contrast), coarse section boundaries.

## 2. Temporal Listen — experience the track as a journey

```bash
python3 skills/music-analysis/scripts/temporal_listen.py /path/to/audio.mp3
python3 skills/music-analysis/scripts/temporal_listen.py track.mp3 --json
```

**Reports:** sliding-window analysis (4s windows, 2s hops) producing a full timeline of:
- Energy level (relative to track average)
- Mood labels (simmering, soaring, erupting, full force, submerged, ethereal, etc.)
- Transitions (drop hits, pulls back, shifts color, evolves)
- Texture decomposition (harmonic/percussive ratio, onset density, roughness)
- Tension model (sustained intensity tracking)
- Narrative arc (mountain, ascending, descending, plateau, wave)
- Peak moment, quietest moment, mood journey summary

### How it works

No AI/ML models — pure signal processing via librosa:
- **RMS energy** per window (relative to global average)
- **Spectral centroid** (brightness), rolloff, flatness
- **Harmonic/percussive source separation** (HPSS)
- **Onset detection** (rhythmic activity density)
- **Zero-crossing rate** (texture roughness)
- Mood labels are rule-based mappings from these features

### Mood vocabulary

| Mood | Condition |
|------|-----------|
| submerged | Low energy, dark frequencies |
| ethereal | Low energy, high harmonic ratio |
| breathing | Low energy, other |
| simmering | Mid-low energy, warm |
| restless | Mid-low energy, high onset density |
| floating | Mid-low energy, bright |
| driving | Mid energy, percussive |
| soaring | Mid energy, harmonic...

Related skills

OpenClaw

bambu-studio-ai

heyixuan2

Bambu Lab 3D printer control and automation. Activate when user mentions: printer status, 3D printing, slice, analyze model, generate 3D, AMS filament, print monitor, Bambu Lab, or any 3D printing task. Full pi...

OpenClaw

humanpages

human-pages-ai

Search and hire real humans for tasks — photography, delivery, research, and more

OpenClaw

geo-optimization

capt-marbles

Generative Engine Optimization (GEO) for AI search visibility. Optimize content to appear in ChatGPT, Perplexity, Claude, and Google AI Overviews. Use when optimizing websites, pages, or content for LLM discove...