audio-quality-check

Analyze audio recordings for echo, loudness, speech intelligibility, and SNR.

32|2|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/tenequm/skills --skill audio-quality-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audio-quality-check
Source: https://github.com/tenequm/skills/tree/main/skills/audio-quality-check
Command: npx skills add https://github.com/tenequm/skills --skill audio-quality-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, soundfile, scipy, pyloudnorm, pesq, pystoi, librosa, ffmpeg, ffprobe, sox, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps diagnose and understand why audio recordings sound bad, identifying issues like echo, poor speech clarity, and excessive noise.

Core Features & Use Cases

  • Echo Detection: Identifies duplicated audio signals and acoustic echo.
  • Quality Metrics: Measures loudness (LUFS), speech quality (PESQ), and intelligibility (STOI).
  • Noise Analysis: Assesses signal-to-noise ratio (SNR) and spectral characteristics.
  • Use Case: You have a call recording where a participant's voice sounds distant and has a slight echo. This Skill can analyze the recording to pinpoint if the echo is due to acoustic feedback or a virtual audio processing loop, and quantify the speech intelligibility.

Quick Start

Run the bundled analysis script on a recording directory by typing: python <skill-path>/scripts/analyze_recording.py "/path/to/recording/directory".

Frequently Asked Questions about audio-quality-check

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

FAQPage Schema
How do I detect echo and measure speech intelligibility in a call recording?

To detect echo and measure speech intelligibility in call recordings, you analyze the audio to identify duplicated signals and quantify clarity using metrics like STOI. This process isolates acoustic feedback and assesses overall speech quality.

What is the best way to diagnose excessive noise and poor signal-to-noise ratio in M4A files?

Diagnosing excessive noise and poor SNR in M4A files involves spectral analysis to assess signal-to-noise ratio characteristics. This identifies background interference and evaluates why the recording sounds bad by quantifying noise levels.

How do I measure loudness in LUFS and speech quality using PESQ for audio analysis?

Measuring loudness in LUFS and speech quality using PESQ involves processing the recording to extract objective quality metrics. This quantifies the audio volume levels and evaluates the perceptual quality of the speech signal.

Can I analyze dual-track M4A files and AEC-processed audio recordings?

Yes, you can analyze dual-track M4A files and AEC-processed audio recordings. The diagnostic process handles both single-track and dual-track formats to identify issues like echo, poor clarity, and excessive noise across different recording setups.

Do I need Python and librosa to run audio recording diagnostics?

Yes, you need Python and libraries like librosa, numpy, scipy, and pyloudnorm to run audio recording diagnostics. These dependencies are required to execute the analysis scripts for measuring loudness, SNR, and detecting echo.