skills.rest
mirkosertic
mirkoserticCOMMUNITY
Explore all skills by this author →
Website𝕏@mirkoserticGitHub

ble

Coordinate BLE GATT and Classic Bluetooth HID communication for Megahub ESP32.

5|2|Updated Dec 26, 2025
Search Tags:#esp32#bluetooth#ble#gatt#hid#web-bluetooth#megahub
One-click install
npx skills add https://github.com/mirkosertic/Megahub --skill ble
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ble
Source: https://github.com/mirkosertic/Megahub/tree/main/.claude/skills/ble
Command: npx skills add https://github.com/mirkosertic/Megahub --skill ble

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides the Bluetooth context needed to implement and debug Megahub's wireless features without violating stack rules or breaking browser and controller connectivity.

Core Features & Use Cases

  • BLE GATT server behavior for the Web Bluetooth IDE, including service roles, characteristic directions, MTU negotiation, and notification flow.
  • Classic Bluetooth HID host handling for gamepads, keyboards, and mice, with pairing persistence and safe event processing.
  • Firmware debugging guidance for startup order, task routing, fragmentation, connection checks, and indication or notification failures.
  • Use Case: Use this Skill when a browser cannot connect, a gamepad will not pair, or a Bluetooth message exchange needs to be traced end to end.

Quick Start

Use the ble skill to summarize the current Bluetooth architecture and identify the correct callback, queue, and connection rules for the issue I am debugging.

Frequently Asked Questions about ble

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

FAQPage Schema
How do I debug an ESP32 BLE GATT server when a Web Bluetooth browser connection fails?▼

To debug a Web Bluetooth browser connection failure, trace the ESP32 BLE GATT server behavior by validating service roles, characteristic directions, and MTU negotiation to pinpoint notification flow breaks.

Why does my ESP32 gamepad fail to pair using Classic Bluetooth HID?▼

ESP32 gamepad pairing fails when Classic Bluetooth HID host handling rules are violated; ensure pairing persistence is configured and safe event processing is used to maintain the dual-mode BT setup.

How do I prevent dropped notifications during ESP32 BLE communication?▼

To prevent dropped notifications during ESP32 BLE communication, implement non-blocking callback handling, queued message processing, and MTU-aware fragmentation to ensure connection-safe data exchange.

What is the correct startup order for ESP32 dual-mode Bluetooth tasks?▼

The correct startup order for ESP32 dual-mode Bluetooth requires routing tasks properly to avoid stack violations, ensuring connection checks and indication logic execute before processing gamepad input workflows.

Can I use Web Bluetooth IDE to trace Bluetooth message exchanges end to end?▼

You can use the Web Bluetooth IDE to trace message exchanges end to end by analyzing BLE GATT server behavior, verifying MTU negotiation, and inspecting notification flow across the ESP32 platform.

What are common limitations when handling Bluetooth HID host events on ESP32?▼

Limitations when handling Bluetooth HID host events on ESP32 include breaking browser connectivity and stack violations if event processing is not safely queued or if dual-mode BT setup lacks connection checks.

Related Skills

Explore More Software Engineering Skills→
erichowenserichowens
181

typography-expert

Generates font pairings and CSS type scales for web typography.

Community
Advanced
orangehrmorangehrm
1.1k

mail

Implement, configure, and debug email delivery in OrangeHRM.

Official
Advanced
tranceetrancee

android-ble-gatt-operations

Serialize Android BLE GATT operations to prevent race conditions.

Community
Advanced
tranceetrancee

android-bluetooth-expert

Guide Android Bluetooth Classic and BLE development across API levels 21 through 34.

Community
Advanced