무료GitHub에 공개

audio-numerics-review

Reviews audio DSP code for numerical correctness. Use when the user asks to review, audit, or check DSP code for correctness issues — filters, feedback loops, fixed-point arithmetic, accumulation loops, or any numeric computation in audio code. Trigger on "check this filter for NaN", "why does my reverb blow up?", "is this numerically stable?", "why do I hear DC in my output?". Pairs with audio-dsp-review (realtime safety); this skill covers numeric correctness. Flag issues proactively.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

kunitoki/sonic-skills

설치 방법 보기

포함된 파일(2)

SKILL.md3.2 KB
references/numerics-pitfalls.md21.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Audio Numerics Review

Floating-point is not real math. IEEE 754 edge cases — denormals, NaN propagation, catastrophic cancellation, precision loss — silently produce wrong audio output without crashing. You won't find them with a debugger; you find them by knowing where to look.

Step 1 — Find numeric-critical paths

Locate every function doing floating-point or integer DSP: filter state loops, feedback delay lines, envelope followers, RMS/energy accumulators, pitch detectors, fixed-point paths (CMSIS-DSP, SIMD int16/int32), any division whose denominator may be zero.

Step 2 — Scan for violations

Violation	Where to look	Symptom
Denormal floats	IIR state vars, reverb tanks, delay feedback	Sudden 100× CPU spike when signal decays
NaN / Inf	Divisions, `sqrt`, `acos`/`asin`, peak normalizers	Silence or noise that can't be traced
Catastrophic cancellation	DC-blocking filters, near-Nyquist biquads, first-order diff	Noise floor jumps, loss of precision
Fixed-point overflow	Q15/Q31 multiply, CMSIS paths, SIMD int16	Audible distortion / wrapping
Precision loss	RMS/energy sums, mixing buses, long loops	Accumulated DC offset, incorrect levels
FTZ/DAZ absent	`prepareToPlay`/stream-open — no mode setup	Denormals hit on some hosts but not others

For code examples and platform-specific notes see references/numerics-pitfalls.md.

Step 3 — Write the review

## Audio Numerics Review: `[file / function]`

### Verdict
[Safe | Has critical violations | Warnings only] — one sentence summary

### Critical Violations
**[Category]: [description]**
`file:line` — `offending code`
Why: one sentence on the numeric risk
Fix: concrete suggestion

### Warnings
[same format]

### What's Done Well
[guarded divisions, double accumulators, FTZ setup, etc.]

### Recommended Fixes (priority order)
1. ...

Quick fix table

Violation	Safe alternative
Denormal in feedback	`ScopedNoDenormals`; FTZ+DAZ in `prepareToPlay`; DC-offset clamp
Division by zero	`(denom > 1e-6f) ? num/denom : fallback`
`sqrt`/`acos`/`asin` unclamped	`std::sqrt(std::max(0.f, x))`, `std::clamp` inputs
NaN propagating silently	`assert(!std::isnan(y))` in debug; validate at entry points
Cancellation in coefficients	Compute coefficients in `double`; use numerically stable forms
Fixed-point overflow	Promote to wider type before multiply; `__SSAT`, CMSIS saturating ops
Precision loss in long sum	`double` accumulator or Kahan compensated summation
FTZ/DAZ absent	Set explicitly in `prepareToPlay`; use `ScopedNoDenormals` per-block

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

au-review

무료

Reviews AudioUnit v2/v3 plugin implementations for spec compliance, thread safety, and correctness. Use when the user asks to review an AudioUnit plugin, check an AUv3 app extension, audit property or parameter handling, or asks "is my AUComponent thread-safe?" or "why does my AU crash in Logic?". Trigger on phrases like "review my AudioUnit", "check my AUv3", "is my render block safe?", or when you see AURenderCallback, internalRenderBlock, kAudioUnitProperty_*, or AUAudioUnit in the code.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

kunitoki/sonic-skills222026년 5월 21일 업데이트

audio-artifacts-debug

무료

Systematic checklist for diagnosing audio artifacts. Use when the user describes a sound quality problem — clicks, pops, crackling, silence, DC offset, aliasing, phase issues, or latency problems. Trigger on phrases like "why do I hear clicks?", "my output has DC offset", "there's aliasing in my oscillator", "phase is wrong in mono", "dropout when CPU spikes". Pairs with audio-dsp-review (realtime safety) and audio-numerics-review (numeric correctness) — use those to fix once the cause is found.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

kunitoki/sonic-skills222026년 5월 21일 업데이트

audio-dsp-review

무료

Reviews audio DSP and audio processing code for realtime safety violations. Use whenever the user asks to review, audit, or check audio processing code — including plugin process callbacks, audio engine render functions, DSP implementations, or any code that runs on the audio thread. Trigger on phrases like "review my processBlock", "check this DSP code", "is this safe for the audio thread?", "review my JUCE plugin", or when you see an audio callback and spot potential realtime violations. Flag issues proactively even when the user hasn't explicitly asked for a review.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

kunitoki/sonic-skills222026년 5월 21일 업데이트

audio-math-explainer

무료

Explains DSP math concepts to developers who need the theory behind an algorithm. Use whenever the user asks how a signal-processing concept works, wants intuition behind a formula, or hits a math-shaped bug. Trigger on phrases like "how does a Fourier transform work", "explain z-transforms", "what is convolution", "why does my biquad ring", "what is windowing for", "what causes aliasing", or "how do I convert gain to dB". Also trigger when the user pastes DSP code and asks why it behaves a certain way.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

kunitoki/sonic-skills222026년 5월 21일 업데이트

audio-performance-debug

무료

Profiling strategy for audio CPU issues — xruns, spikes, and buffer underruns. Use when the user reports CPU overload, audio glitches under load, or performance regressions. Trigger on phrases like "I'm getting xruns", "my plugin causes CPU spikes", "dropouts under high voice count", "audio thread is too slow", "how do I profile my DSP". References audio-numerics-review for denormal slowdown and audio-dsp-review for lock contention.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

kunitoki/sonic-skills222026년 5월 21일 업데이트

audio-signal-flow-explainer

무료

Traces and documents signal paths, bus/aux architecture, and sidechain connections in audio systems. Surfaces hidden coupling between audio components. Use when the user asks to trace a signal chain, explain audio routing, understand an audio graph, locate sidechain sources, or describe how audio flows through a plugin or engine. Trigger on phrases like "trace this signal chain", "explain this audio routing", "what calls what in this audio graph", "where does the sidechain come from", "how does audio flow through this plugin".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

kunitoki/sonic-skills222026년 5월 21일 업데이트

kunitoki의 스킬 모두 보기

이 스킬의 문제 신고

설치

명령으로 설치

npx skills add https://github.com/kunitoki/sonic-skills --skill audio-numerics-review

터미널에 붙여 넣고 실행합니다(Node.js 필요). Claude Code, Codex 등 설치할 에이전트를 고를 수 있습니다.

에이전트에게 부탁하기

다음 Agent Skill을 설치해 주세요.
https://github.com/kunitoki/sonic-skills/tree/main/skills/audio-numerics-review

먼저 SKILL.md와 첨부 파일의 내용을 확인해 수상한 처리(외부 전송, 인증 정보 읽기 등)가 없는지 확인한 뒤 Claude Code는 ~/.claude/skills/audio-numerics-review/, Codex는 ~/.agents/skills/audio-numerics-review/ 에 배치해 주세요.

이 문장을 그대로 Claude Code나 Codex에 보내면 내용을 확인한 뒤 설치해 줍니다.

GitHub에서 소스 보기

저장소: kunitoki/sonic-skills
스타: 22
포크: 2
카테고리: 동영상·이미지·음성
라이선스: Unlicense
원문 언어: 영어
최종 업데이트: 2026년 5월 21일

스킬은 에이전트를 위한 지시와 스크립트의 묶음입니다. cccskills는 내용의 안전성을 보증하지 않습니다. 설치하기 전에 내용을 확인하세요.