skills/media/songsee/SKILL.md
Generate spectrograms and audio feature visualizations (mel, chroma, MFCC, tempogram, etc.) from audio files via CLI. Useful for audio analysis, music production debugging, and visual documentation.
npx skillsauth add aum08desai/hermes-research-agent songseeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Generate spectrograms and multi-panel audio feature visualizations from audio files.
Requires Go:
go install github.com/steipete/songsee/cmd/songsee@latest
Optional: ffmpeg for formats beyond WAV/MP3.
# Basic spectrogram
songsee track.mp3
# Save to specific file
songsee track.mp3 -o spectrogram.png
# Multi-panel visualization grid
songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux
# Time slice (start at 12.5s, 8s duration)
songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg
# From stdin
cat track.mp3 | songsee - --format png -o out.png
Use --viz with comma-separated values:
| Type | Description |
|------|-------------|
| spectrogram | Standard frequency spectrogram |
| mel | Mel-scaled spectrogram |
| chroma | Pitch class distribution |
| hpss | Harmonic/percussive separation |
| selfsim | Self-similarity matrix |
| loudness | Loudness over time |
| tempogram | Tempo estimation |
| mfcc | Mel-frequency cepstral coefficients |
| flux | Spectral flux (onset detection) |
Multiple --viz types render as a grid in a single image.
| Flag | Description |
|------|-------------|
| --viz | Visualization types (comma-separated) |
| --style | Color palette: classic, magma, inferno, viridis, gray |
| --width / --height | Output image dimensions |
| --window / --hop | FFT window and hop size |
| --min-freq / --max-freq | Frequency range filter |
| --start / --duration | Time slice of the audio |
| --format | Output format: jpg or png |
| -o | Output file path |
ffmpegvision_analyze for automated audio analysisdevelopment
Use when you have a spec or requirements for a multi-step task. Creates comprehensive implementation plans with bite-sized tasks, exact file paths, and complete code examples.
development
Use when implementing any feature or bugfix, before writing implementation code. Enforces RED-GREEN-REFACTOR cycle with test-first approach.
development
Use when encountering any bug, test failure, or unexpected behavior. 4-phase root cause investigation — NO fixes without understanding the problem first.
development
Use when executing implementation plans with independent tasks. Dispatches fresh delegate_task per task with two-stage review (spec compliance then code quality).