av-peripheral-repair

Diagnose USB, Bluetooth, audio, and camera enumeration issues on macOS and Windows.

Updated May 6, 2026
One-click install
npx skills add https://github.com/idemeum/skills --skill av-peripheral-repair
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: av-peripheral-repair
Source: https://github.com/idemeum/skills/tree/main/av-peripheral-repair
Command: npx skills add https://github.com/idemeum/skills --skill av-peripheral-repair

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes A/V and peripheral connectivity issues when external monitors aren’t detected, USB hubs/docks don’t enumerate, Bluetooth audio disconnects, or microphones/cameras fail to appear in apps.

Core Features & Use Cases

  • Device discovery and triage: Enumerates USB devices, Bluetooth devices, audio routing endpoints, and video/camera endpoints to map what the OS can see vs. what the user expects.
  • Corrective guidance with verification: Guides users through targeted physical actions (cable swap, port change, dock power-cycle, wake/power-on, battery replacement, re-pairing) and re-checks state after changes.
  • Last-resort Bluetooth radio reset (guarded): Performs a consent-gated, scope-bound Bluetooth module reset only when the radio is on and reconnect attempts are warranted, minimizing disruption.

Quick Start

Run av-peripheral-repair to diagnose your missing or disconnected external monitor, USB-C dock/hub, Bluetooth headset, keyboard/mouse, webcam, or microphone and follow the OS-based findings to apply the least risky fixes first.

Frequently Asked Questions about av-peripheral-repair

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

FAQPage Schema
Why does my USB-C dock or hub fail to enumerate on Windows and macOS?

USB hubs fail to enumerate when the operating system cannot detect the connected device. This Skill diagnoses USB enumeration failures by listing readable device endpoints, guiding you through port changes, cable swaps, and dock power-cycle procedures to restore connectivity.

How do I troubleshoot a missing external monitor or webcam in video apps?

Troubleshoot a missing external monitor or webcam by enumerating video and camera endpoints to verify OS-level detection. This Skill maps detected video endpoints against expected devices and provides corrective guidance for physical connections.

Can I fix Bluetooth pairing dropouts and audio routing mismatches without a full system reboot?

Fix Bluetooth pairing dropouts and audio routing mismatches by enumerating active audio endpoints and Bluetooth devices. This Skill checks connection states and performs a consent-gated Bluetooth radio reset only when guard conditions are met.

Does this peripheral troubleshooting approach support both macOS and Windows?

Yes, this peripheral troubleshooting approach supports both macOS and Windows. It uses read-only device listing tools to detect USB, Bluetooth, audio, and camera endpoints across both operating systems to isolate hardware and software mismatches.

What is the safest way to reset a Bluetooth radio when headphones or keyboards disconnect?

The safest way to reset a Bluetooth radio is a scope-bound, consent-gated module reset. This Skill performs the reset only when the radio is on and reconnection attempts are warranted, minimizing disruption to other peripherals.

What should I do if my microphone or audio output is not showing up in app settings?

If your microphone or audio output is missing, enumerate audio routing endpoints to identify OS detection gaps. This Skill maps visible audio devices against expected inputs and guides you through physical reconnection and re-pairing steps.