core-bluetooth

Manage BLE central and peripheral roles in Swift.

155|22|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/omarshahine/HomeClaw --skill core-bluetooth-omarshahine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-bluetooth
Source: https://github.com/omarshahine/HomeClaw/tree/main/.agents/skills/core-bluetooth
Command: npx skills add https://github.com/omarshahine/HomeClaw --skill core-bluetooth-omarshahine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables seamless interaction with Bluetooth Low Energy (BLE) devices, allowing applications to discover, connect to, and communicate with peripherals, as well as act as a peripheral itself.

Core Features & Use Cases

  • Central Role: Scan for BLE peripherals, connect to them, discover their services and characteristics, and read/write data or subscribe to notifications.
  • Peripheral Role: Advertise local services and characteristics, allowing other devices to connect and interact with your device.
  • Use Case: Build a custom heart rate monitor app that connects to a BLE heart rate sensor, reads the data, and displays it in real-time. Or, create a device that advertises its own sensor data for other devices to consume.

Quick Start

Use the core-bluetooth skill to scan for Bluetooth Low Energy peripherals advertising the heart rate service.

Frequently Asked Questions about core-bluetooth

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

FAQPage Schema
How do I scan for Bluetooth Low Energy peripherals in Swift?

To scan for Bluetooth Low Energy peripherals in Swift, use the Core Bluetooth central role to discover nearby advertising devices and establish connections for data exchange. You can filter discovered devices by specific advertised services.

Can I use Swift to advertise my iOS device as a BLE peripheral?

Yes, you can use Swift to advertise your device as a BLE peripheral. The Core Bluetooth peripheral role allows you to broadcast custom services and characteristics so other central devices can discover and interact with your hardware.

What is the difference between central and peripheral roles in Core Bluetooth?

In Core Bluetooth, the central role scans for and connects to devices to read and write data, while the peripheral role advertises services and characteristics to allow other devices to connect and interact with the local hardware.

How do I discover services and characteristics after connecting to a BLE device?

After connecting to a BLE device, you discover its services and characteristics by querying the remote peripheral object in Swift. This allows your application to identify available data endpoints for reading, writing, or subscribing to notifications.

Does Core Bluetooth work for building a custom heart rate monitor app?

Yes, Core Bluetooth works for building a custom heart rate monitor app. You can scan for peripherals advertising the heart rate service, establish a connection, and subscribe to characteristic notifications to display real-time sensor data.

Why is my Core Bluetooth scan not finding any BLE devices?

If your Core Bluetooth scan is not finding BLE devices, ensure the central manager is powered on and your iOS device has the necessary permissions. Scanning only detects peripherals actively advertising their Bluetooth Low Energy services.