本文へ移動
cccskills
無料GitHub で公開

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.

インストール方法を見る

含まれるファイル(2)

  • SKILL.md4.0 KB
  • references/artifact-patterns.md8.8 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Audio Artifacts Debug

Audio artifacts have diagnostic signatures — match the symptom to the root cause before touching code.

Step 1 — Characterize the artifact

Ask these questions before reading any code.

Artifact typeQuestions to ask
Clicks / popsRegular or random? On buffer boundaries? At note on/off? After channel strip toggle?
Crackling / distortionConstant or load-dependent? Does it correlate with signal level? Worse on silent decay?
Silence / dropoutImmediate or gradual? Only under load? After a specific number of voices? Recovers?
DC offsetConstant or drift? Present from first sample? Appears only after long silence?
AliasingAudible as high-frequency mirror tones? Pitch-dependent? Present at all sample rates?
Phase issuesStereo image collapse in mono? Comb filtering? Only on parallel paths or mid-side?
LatencyDAW reports wrong delay compensation? Wet/dry misaligned? Only at certain buffer sizes?

Step 2 — Narrow to root cause

SymptomLikely causeSkill / check to apply
Click at fixed buffer-length intervalsBuffer boundary discontinuity — uninitialized tail, missing sample-accurate fadeaudio-dsp-review: check process entry/exit
Click correlates with xrun logCPU overload — audio thread missed deadlineaudio-dsp-review: scan for allocations, locks, I/O
Crackling scales with signal amplitudeClipping or fixed-point overflowaudio-numerics-review: overflow, Q-format multiply
Crackling on silent decayDenormal floats — FTZ absentaudio-numerics-review: denormal section
Dropout / silence under loadxrun, NaN propagation, or buffer too small for latencyaudio-dsp-review + audio-numerics-review: NaN guards
Silence after large valueNaN propagated from unclamped sqrt / divisionaudio-numerics-review: NaN / Inf section
DC offset from first sampleUninitialized filter state or delay lineaudio-numerics-review: precision loss / state init
DC offset after long silenceFTZ leaving near-zero state; missing high-passaudio-numerics-review: denormal / FTZ section
Aliasing pitch-tracks with noteOscillator not bandlimited; no anti-alias before downsamplingaudio-numerics-review: check sample-rate handling
Stereo collapses to monoUnmatched processing on L/R; phase inversionaudio-dsp-review: check parallel path symmetry
Comb filtering on monoLatency mismatch on parallel pathsPlugin reports incorrect getLatencySamples()
Latency wrong at buffer-size changePlugin caches latency at init only; not updated on reconfigureaudio-dsp-review: check prepareToPlay reset

Step 3 — Structured diagnosis report

## Audio Artifact Diagnosis: `[file / symptom]`

### Artifact characterization
Type: [clicks | crackling | silence | DC | aliasing | phase | latency]
Observed: [when / under what conditions]
Reproducible: [always | intermittent | load-dependent]

### Root cause hypothesis
Likely cause: [one sentence]
Evidence: [what in the code supports this]
Skill to apply: [audio-dsp-review | audio-numerics-review | both]

### Specific checks to run
1. [file:line] — [what to inspect]
2. ...

### Recommended fix
[Concrete action — no placeholder text]

For artifact-specific diagnostic questions and check-by-check references see references/artifact-patterns.md.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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日 更新

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日 更新

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日 更新

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-skills222026年5月21日 更新

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日 更新

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 のスキルをすべて見る

このスキルの問題を報告する