bluez-expert

Explain BlueZ D-Bus APIs and kernel protocols for Linux Bluetooth.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/trancee/MeshLink-old --skill bluez-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluez-expert
Source: https://github.com/trancee/MeshLink-old/tree/main/.agents/skills/bluez-expert
Command: npx skills add https://github.com/trancee/MeshLink-old --skill bluez-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

BlueZ Expert provides comprehensive guidance for navigating the Linux Bluetooth stack BlueZ, including D-Bus APIs, kernel protocols, and troubleshooting workflows.

Core Features & Use Cases

  • Detailed coverage of Adapter1, Device1, GATT, LE Advertising, Media, Profile, Network, OBEX, Mesh
  • Quick references for bluetoothctl commands, btmon, and btmgmt
  • Practical troubleshooting workflows for pairing, discovery, and service resolution

Quick Start

Ask me to walk you through locating a BlueZ D-Bus object, querying an Adapter1, or debugging a GATT service.

Frequently Asked Questions about bluez-expert

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

FAQPage Schema
How do I interact with BlueZ D-Bus APIs to manage a Linux Bluetooth adapter?

BlueZ exposes D-Bus interfaces like Adapter1 and Device1 to manage Linux Bluetooth adapters. You query these objects to control discovery, pairing, and device properties directly via the D-Bus message bus.

What is the best way to debug a GATT service that is not resolving on Linux?

Debugging a GATT service on Linux involves using troubleshooting workflows for service resolution alongside tools like bluetoothctl and btmon. This identifies whether the failure originates in the BlueZ D-Bus layer or kernel protocols.

Does BlueZ support Bluetooth mesh networking and how do I access it?

BlueZ supports Bluetooth mesh networking through dedicated D-Bus Mesh APIs. You access mesh functionality by interfacing with these D-Bus objects to provision and manage mesh nodes directly on Linux.

Why does my Linux Bluetooth pairing fail and how can I troubleshoot the HCI kernel protocol?

Linux Bluetooth pairing fails due to misconfigurations in HCI kernel protocols or BlueZ settings storage. You troubleshoot by inspecting kernel protocol logs and verifying mgmt protocol commands to isolate the failure.

Can I use bluetoothctl to configure LE Advertising on Linux?

You can use bluetoothctl to configure LE Advertising on Linux by interacting with the LEAdvertising D-Bus interface. This registers advertising data and parameters to broadcast custom BLE services.