multimedia-audio-expert

Diagnoses Android 15+ multimedia pipeline issues using AudioFlinger, SurfaceFlinger, MediaCodec, and camera HAL diagnostics.

40|7|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/jonaschen/Android-Software --skill multimedia-audio-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multimedia-audio-expert
Source: https://github.com/jonaschen/Android-Software/tree/main/skills/L2-multimedia-audio-expert
Command: npx skills add https://github.com/jonaschen/Android-Software --skill multimedia-audio-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Prevents context-bloating hallucinations by keeping the agent inside verified multimedia paths when diagnosing audio, display, camera, and MediaCodec issues on Android 15+ devices, providing clear signals for underrun, compositor, or HAL failures.

Core Features & Use Cases

  • Targeted path scope ensures guidance only touches frameworks/av, surfaceflinger, and hardware interface HALs, so fixes stay in the right subsystem.
  • Diagnostic architecture intelligence explains AudioFlinger buffer flows, SurfaceFlinger composition decisions, camera request pipelines, and MediaCodec handshakes with actionable checks for timeouts, dropped frames, and codec negotiations.
  • Tool calls and handoff rules instruct using dumpsys, logcat, and systrace, then escalate any SELinux, build, kernel, or HAL interface problems to their owning skills with [L2 MEDIA → HANDOFF].
  • Use case: When a playback session janks, the Skill correlates AudioFlinger buffer waits, SurfaceFlinger composition mode, and Camera HAL metadata delays to pinpoint whether the issue lives in the HAL driver, scheduler, or codec negotiation.

Quick Start

Ask multimedia-audio-expert to analyze AudioFlinger, SurfaceFlinger, and MediaCodec dumps to highlight playback bottlenecks and provide diagnostic next steps.

Frequently Asked Questions about multimedia-audio-expert

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

FAQPage Schema
How do I diagnose Android audio playback jank using AudioFlinger buffer waits?

To diagnose audio playback jank, analyze AudioFlinger buffer states to identify HAL write blocking or underrun conditions. The Skill correlates AudioFlinger buffer waits with SurfaceFlinger composition modes and HAL pipeline delays to pinpoint whether the bottleneck originates in the driver, scheduler, or codec negotiation.

What causes MediaCodec handshake failures during Android video capture?

MediaCodec handshake failures during video capture stem from codec negotiation timeouts or HAL pipeline blockages. The Skill traces MediaCodec pipeline states and camera request pipelines to detect dropped frames, metadata delays, and timeout conditions, providing actionable checks for HAL driver or codec negotiation faults.

How do I troubleshoot SurfaceFlinger composition mode issues on Android 15?

Troubleshoot SurfaceFlinger composition issues by analyzing compositor states and surface buffer flows on Android 15+. The Skill examines SurfaceFlinger composition decisions and correlates them with AudioFlinger buffer waits and HAL metadata delays to isolate whether display jank originates in the scheduler, HAL, or codec layer.

Can I use dumpsys and systrace to debug Android camera HAL request pipeline delays?

Yes, dumpsys and systrace are used to debug camera HAL request pipeline delays on Android 15+. The Skill instructs using dumpsys, logcat, and systrace to capture HAL metadata delays, dropped frames, and timeout conditions, then escalates SELinux, kernel, or HAL interface problems to owning skills with handoff rules.

Why does my Android multimedia playback session drop frames across the HAL and codec layers?

Frame drops occur when HAL write blocking, codec negotiation failures, or SurfaceFlinger composition bottlenecks disrupt the multimedia pipeline. The Skill correlates AudioFlinger buffer waits, SurfaceFlinger composition modes, and Camera HAL metadata delays to identify whether the issue lives in the HAL driver, scheduler, or MediaCodec handshake.

Does this Skill handle SELinux or kernel-level audio HAL diagnostic issues?

This Skill scopes diagnostics to frameworks/av, surfaceflinger, and hardware interface HALs for Android 15+ multimedia paths. SELinux, build, kernel, or HAL interface problems outside multimedia pipelines are escalated to their owning skills using designated handoff rules rather than diagnosed directly.