Skip to content
Skills Library
Other · Analysis

usb-debugging

/usb-debugging

Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.

Licence
MIT
Last repository change
15.10.2026

Assessment and security

91/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content26 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 15.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.

Original author description

Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.

How it works

SKILL.md has no level-two headings · 30 lines, 197 words

SKILL.md preview
---
name: usb-debugging
description: Diagnose embedded USB enumeration, descriptors, CDC/REPL ports and intermittent disconnects. Use when requests involve a missing USB device, wrong interface, native USB versus serial bridge, endpoint failures or conflicting monitors.
metadata: {triggers: "USB Debugging, embedded diagnosis"}
---

# USB Debugging

Read [the shared embedded contract](../../docs/arduino-skill-contract.md) and
keep source/build, device and physical evidence separate.

Read [USB diagnosis](references/workflow.md). Identify connector, data-capable
cable, power path, native USB controller versus UART bridge, VID/PID, interfaces,
serial identity and host OS. Record enumeration before and after the event;
a changing port name is not necessarily a different physical board.

Separate no electrical connection, failed enumeration, missing driver/interface,
port ownership and application protocol. Record descriptors, endpoint types,
configuration and host logs with credentials/private serials redacted in public
reports. Check D+/D- wiring, clock/PHY/VBUS expectations and power externally
only against the exact board design.

Close conflicting serial monitors before a selected REPL/debug session.
MicroPython raw REPL and auto-reset tools can change runtime state. Native
USB may disappear during reset, breakpoint halt or firmware reconfiguration;
a UART bridge can remain enumerated while the MCU is stopped.

Use the matching platform skill for USB stack configuration. Deliver the layer
where evidence stops, a reproducible host check and the next targeted test.
Do not erase firmware or reinstall arbitrary drivers to fix an unidentified
transport symptom.

See [platform coverage](../../docs/platform-support.md) for the exact tested
combination. A source procedure is not a claim that every target was tested.
Files in this package (2)
  • SKILL.md 2 KB
  • references/workflow.md 1 KB

Versions

The database has no other skills named usb-debugging.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 3f376df662f5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90esp32-usb-cdc-throughput-budget
    Use when designing, reviewing, debugging or validating usb cdc throughput budget for ESP32 firmware; apply target-specific constraints, failure analysis and measurable verification before release.
  • 90esp32-usb-host-power-budget
    Use when designing, reviewing, debugging or validating usb host power budget for ESP32 firmware; apply target-specific constraints, failure analysis and measurable verification before release.
  • 100tinyusb-integration
    Use when integrating, porting, configuring, or debugging TinyUSB device, host, CDC, MSC, HID, MIDI, vendor class, descriptors, DCD, or USB enumeration issues
  • 90jetson-customize-usb
    Enable/disable Jetson USB2/USB3 SS ports via kernel-DT overlay. Do NOT use for UPHY lane allocation or ODMDATA edits.
  • 81usb-devices
    Use when the USB devices attached to this machine need to be listed and their vendor and product names resolved.
  • 100meddev-usb-medical
    Implement safe USB device connectivity: class selection, enumeration handling, data validation, electrical and safety considerations. Use when working on usb medical in medical device software.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.