core-bluetooth

Guide iOS BLE development with Core Bluetooth for scanning, connecting, and communicating with peripherals.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/onymchat/onym-ios --skill core-bluetooth-onymchat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-bluetooth
Source: https://github.com/onymchat/onym-ios/tree/main/.claude/skills/core-bluetooth
Command: npx skills add https://github.com/onymchat/onym-ios --skill core-bluetooth-onymchat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps iOS developers implement and manage Bluetooth Low Energy (BLE) communication, covering central and peripheral roles, service discovery, data transfer, background modes, and state restoration.

Core Features & Use Cases

  • Central role: Scanning, connecting, and discovering services and characteristics
  • Peripheral role: Advertising and publishing services for other devices to interact with
  • Data flow: Reading, writing, and subscribing to notifications for real-time updates
  • Robust workflows: Background BLE support and state restoration to handle app relaunches

Quick Start

Initialize CBCentralManager, wait for poweredOn, and start scanning for a target BLE 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 and connect to Bluetooth Low Energy peripherals on iOS?

To scan and connect to Bluetooth Low Energy peripherals on iOS, initialize CBCentralManager, wait for the poweredOn state, and start scanning for target services. This Skill provides structured guidance for discovering services and characteristics after connecting.

Can I use Core Bluetooth to publish services and act as a BLE peripheral?

Yes, Core Bluetooth supports the peripheral role via CBPeripheralManager. You can advertise services and publish characteristics for other central devices to discover, connect to, and interact with.

How do I handle BLE background modes and state restoration in my iOS app?

Core Bluetooth handles background modes and state restoration by declaring required Info.plist keys and implementing specific delegate callbacks. This allows your app to handle BLE events and relaunches reliably in the background.

What is the best way to read, write, and subscribe to BLE characteristic notifications?

The best way to manage BLE data flow is by using Core Bluetooth's characteristic read/write operations and subscribing to notifications. This Skill details how to handle real-time data updates and implement best-practice error handling.

Why does my CBCentralManager fail to scan for Bluetooth devices?

CBCentralManager scanning fails if the manager is not in the poweredOn state or if required Info.plist privacy keys are missing. This Skill addresses Core Bluetooth workflows and best-practice error handling to resolve these issues.