harness-runner

Automates WaveCap-SDR regression testing and parameter sweeps, outputting JSON/text reports.

1|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/TobiasWooldridge/WaveCap-SDR --skill harness-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-runner
Source: https://github.com/TobiasWooldridge/WaveCap-SDR/tree/main/.claude/skills/harness-runner
Command: npx skills add https://github.com/TobiasWooldridge/WaveCap-SDR --skill harness-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually testing SDR configurations, hardware, and demodulation performance is repetitive and time-consuming. This skill automates the execution of the WaveCap-SDR test harness, including parameter sweeps and reporting, saving you significant QA effort.

Core Features & Use Cases

  • Automated Testing: Run regression tests, validate audio quality, and benchmark demodulation performance across various settings.
  • Parameter Sweeps: Automatically test different gain, bandwidth, or frequency offset values to find optimal configurations.
  • Reporting: Generates detailed JSON and text reports with pass/fail status and audio quality metrics for easy analysis.
  • Use Case: After a code change, you need to ensure that all existing presets still produce clear audio. Use this skill to run a quick smoke test with the fake driver across all presets and generate a report.

Quick Start

Use the harness-runner skill to run a test with the 'kexp' preset for 3 seconds using the fake driver, sweeping gain values of 10, 20, 30, and 40.

Frequently Asked Questions about harness-runner

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

FAQPage Schema
How do I automate regression testing for SDR hardware configurations?

Regression testing for SDR configurations is automated by executing controlled test runs across multiple presets, drivers, devices, and parameter sweeps. This skill starts the harness server, configures captures and channels, runs parameter sweeps, measures RMS and peak metrics, then outputs JSON and text reports with pass/fail status and audio quality validation.

Can I run parameter sweeps across different gain, bandwidth, and frequency offset values?

Yes. Parameter sweeps automatically test multiple gain, bandwidth, or frequency offset values in a single run. The skill executes each sweep configuration, collects performance metrics, and generates comprehensive reports so you can identify optimal settings without manual reconfiguration.

What metrics does SDR testing produce and how are they reported?

Testing produces RMS and peak audio quality metrics alongside pass/fail validation status. Results are exported as both JSON and text reports for easy analysis, comparison, and integration into QA workflows or performance tracking systems.

How do I quickly validate all presets after code changes?

Run a smoke test across all presets using the fake driver for rapid validation without hardware dependency. The skill executes the test harness on each preset, collects metrics, and generates a report showing which presets produce clear audio and which require investigation.

Does this work with both offline and live SDR testing?

Yes. The skill supports both offline and live SDR testing modes across multiple presets, drivers, and devices. You can switch modes and drivers without changing your test configuration, making it flexible for development, CI/CD, and production validation scenarios.

What do I need to set up before running automated tests?

Start the WaveCap-SDR harness server and configure your test parameters: preset selection, test duration, driver type (fake or hardware), device settings, and parameter ranges. The skill then handles channel configuration, sweep execution, and metric collection automatically.