skills.rest
danielraffel
danielraffelCOMMUNITY
Explore all skills by this author →
GitHub

audio-harness

Generate test signals, calculate audio metrics, and assert signal properties.

1|Updated Jul 11, 2026
Search Tags:#audio analysis#audio validation#DSP testing#audio signal processing#audio debugging
One-click install
npx skills add https://github.com/danielraffel/burl --skill audio-harness
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audio-harness
Source: https://github.com/danielraffel/burl/tree/main/.agents/skills/audio-harness
Command: npx skills add https://github.com/danielraffel/burl --skill audio-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pulp::format::HeadlessHost, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive toolkit for analyzing and debugging audio signals, enabling precise measurement and validation of audio processors.

Core Features & Use Cases

  • Signal Generation: Create deterministic signals for testing audio processors.
  • Metrics Analysis: Calculate metrics like peak, RMS, DC, and frequency response.
  • Assertions: Make assertions about signal properties like silence, clipping, and frequency.
  • Offline Analysis: Perform detailed analysis on audio data without the need for real-time processing.
  • Use Case: When you need to verify the performance of an audio filter or compressor, you can use this Skill to generate test signals, measure the output, and assert against expected results.

Quick Start

Build and run the audio harness to analyze a specific audio processor by executing the following command:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu) --target \
  pulp-test-audio-support pulp-test-render-scenario pulp-test-audio-contracts \
  pulp-test-audio-doctor pulp-test-golden pulp-test-audio-matrix pulp-test-audio-tone-regression
ctest --test-dir build -R 'audio|golden|render|contract|doctor' --output-on-failure

Frequently Asked Questions about audio-harness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze and debug audio signals for a custom audio processor?▼

You can perform offline audio analysis by running a suite of test tools via CMake and CTest, executing build targets for audio support, scenario rendering, contracts, and golden tests to validate signal processors without real-time processing.

What metrics can I calculate during audio signal validation?▼

You can assert specific signal properties such as silence detection, clipping thresholds, and frequency characteristics to ensure your audio filter or compressor behaves as expected.

Do I need a headless audio environment for DSP testing?▼

The headless audio environment allows you to execute offline test scenarios and render audio matrices deterministically, ensuring accurate validation of audio processors in a controlled setup.

What is the best way to verify audio filter performance offline?▼

By leveraging offline analysis capabilities, you can perform detailed measurements on audio data and run tone regression tests to ensure your audio filter meets specified performance criteria.

Can I use this toolkit for audio debugging without real-time processing?▼

The offline analysis capability allows you to execute audio contracts and golden tests on pre-recorded or generated audio data, providing detailed validation metrics without the need for a live audio stream.

Related Skills

Explore More Software Engineering Skills→
danielraffeldanielraffel
1

stretch

Time-stretch and pitch-shift audio files offline with configurable quality settings.

Community
Advanced
dkyazzentwatwadkyazzentwatwa
86

audio-analyzer

Analyze audio tempo, key, loudness, and frequency with waveform and spectrogram visualizations.

Community
Intermediate
SpiralCloudOmegaSpiralCloudOmega
1

Modern CMake for Audio Software

Configure modern CMake builds for JUCE-based audio software with target-based commands.

Community
Advanced
melissa-pereira-deelmelissa-pereira-deel

Real-Time Audio Engineering

Build glitch-free real-time audio pipelines with AVAudioEngine and Core Audio.

Community
Advanced