How do I install the Corebluetooth skill?

Run npx skillmds@latest add nonameplum/corebluetooth in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Corebluetooth safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Corebluetooth?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Corebluetooth free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Corebluetooth?

nonameplum (@nonameplum) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Corebluetooth by nonameplum — Agent Skill

Name: Corebluetooth
Author: nonameplum

Corebluetooth

Apple Core Bluetooth framework for BLE and Bluetooth Classic. Use for central/peripheral workflows, scanning, connecting, advertising, GATT services/characteristics, read/write/notify, L2CAP, background processing or state restoration, and error handling across Apple platforms.

nonameplum f22bb1b 10 files · 157.3 KB Updated Sep 17, 2026

File contents

Core Bluetooth

What to open

Use corebluetooth/AboutCoreBluetooth.md and corebluetooth/CoreBluetoothOverview.md for concepts and role orientation.
Use corebluetooth/PerformingCommonCentralRoleTasks.md for step-by-step central workflows.
Use corebluetooth/PerformingCommonPeripheralRoleTasks.md for step-by-step peripheral workflows.
Use corebluetooth/BestPracticesforInteractingwithaRemotePeripheralDevice.md and corebluetooth/BestPracticesforSettingUpYourLocalDeviceasaPeripheral.md for pitfalls and best practices.
Use corebluetooth/CoreBluetoothBackgroundProcessingforiOSApps.md for background modes and lifecycle constraints.
Use corebluetooth/BluetoothStateRestorationAppReaunchRules.md for state restoration app relaunch rules.
Use corebluetooth/corebluetooth.md for API quick maps and symbol lookup.

Workflow

Identify whether the app acts as a central, a peripheral, or both.
Wait for the manager state to be poweredOn before issuing BLE operations.
Follow the role checklist to keep discovery and connection order correct.
Open the role task guide and best practices first; use the API reference for exact signatures.

Central checklist

Create a CBCentralManager with a delegate and queue.
Handle centralManagerDidUpdateState(_:) and gate scanning on .poweredOn.
Scan with scanForPeripherals(withServices:options:) and stop when the target is found.
Connect, set the CBPeripheral delegate, and discover services and characteristics.
Read, write, or subscribe to characteristic notifications as needed.

Peripheral checklist

Create a CBPeripheralManager with a delegate and queue.
Wait for the state to become .poweredOn.
Define services and characteristics, then add them to the manager.
Start advertising with service UUIDs and optional local name.
Respond to read and write requests; publish updates to subscribed centrals.

Reminders

Retain discovered CBPeripheral instances to keep them alive.
Use notifications for streaming data; use write-without-response only when canSendWriteWithoutResponse is true.
Use L2CAP only for use cases that do not fit GATT characteristics.

---name: corebluetoothdescription: Apple Core Bluetooth framework for BLE and Bluetooth Classic. Use for central/peripheral workflows, scanning, connecting, advertising, GATT services/characteristics, read/write/notify, L2CAP, background processing or state restoration, and error handling across Apple platforms.---# Core Bluetooth## What to open- Use `corebluetooth/AboutCoreBluetooth.md` and `corebluetooth/CoreBluetoothOverview.md` for concepts and role orientation.- Use `corebluetooth/PerformingCommonCentralRoleTasks.md` for step-by-step central workflows.- Use `corebluetooth/PerformingCommonPeripheralRoleTasks.md` for step-by-step peripheral workflows.- Use `corebluetooth/BestPracticesforInteractingwithaRemotePeripheralDevice.md` and `corebluetooth/BestPracticesforSettingUpYourLocalDeviceasaPeripheral.md` for pitfalls and best practices.- Use `corebluetooth/CoreBluetoothBackgroundProcessingforiOSApps.md` for background modes and lifecycle constraints.- Use `corebluetooth/BluetoothStateRestorationAppReaunchRules.md` for state restoration app relaunch rules.- Use `corebluetooth/corebluetooth.md` for API quick maps and symbol lookup.## Workflow- Identify whether the app acts as a central, a peripheral, or both.- Wait for the manager state to be `poweredOn` before issuing BLE operations.- Follow the role checklist to keep discovery and connection order correct.- Open the role task guide and best practices first; use the API reference for exact signatures.## Central checklist1. Create a `CBCentralManager` with a delegate and queue.2. Handle `centralManagerDidUpdateState(_:)` and gate scanning on `.poweredOn`.3. Scan with `scanForPeripherals(withServices:options:)` and stop when the target is found.4. Connect, set the `CBPeripheral` delegate, and discover services and characteristics.5. Read, write, or subscribe to characteristic notifications as needed.## Peripheral checklist1. Create a `CBPeripheralManager` with a delegate and queue.2. Wait for the state to become `.poweredOn`.3. Define services and characteristics, then add them to the manager.4. Start advertising with service UUIDs and optional local name.5. Respond to read and write requests; publish updates to subscribed centrals.## Reminders- Retain discovered `CBPeripheral` instances to keep them alive.- Use notifications for streaming data; use write-without-response only when `canSendWriteWithoutResponse` is true.- Use L2CAP only for use cases that do not fit GATT characteristics.

Frequently asked questions