Skills
.Work. You
Rest

btsnoop-analyzer

Community

Diagnose Bluetooth btsnoop traces quickly

Software Engineering#llm#diagnostics#github-action#trace-analysis#bluetooth#hci#btsnoop
AuthorVudentz
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Automates in-depth analysis of Bluetooth btsnoop/HCI traces to detect protocol errors, annotate key frames, and produce a structured diagnostic report for debugging connection, pairing, and streaming issues.

Core Features & Use Cases

  • Five-step deterministic pipeline: detection, prefiltering, annotation, diagnostics, and optional LLM-powered analysis.
  • Focus-aware analysis: auto-detects or accepts user focus (A2DP, LE Audio, HFP, SMP, L2CAP, advertising, etc.) and loads relevant annotators and docs.
  • Privacy and CI integration: optional MAC anonymization, local btmon decoding, and a reusable GitHub Action for posting results as issue comments.
  • Use cases: debug audio streaming disconnects, troubleshoot pairing failures, verify GATT discovery flows, analyze L2CAP/channel issues, and assess advertising/coexistence effects.

Quick Start

Provide a trace URL or local decoded trace and request analysis; the skill will decode (with btmon), optionally anonymize, run the pipeline, and produce a structured diagnostic report.

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: btsnoop-analyzer
Download link: https://github.com/Vudentz/btsnoop-analyzer/archive/main.zip#btsnoop-analyzer

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.