core-bluetooth — Claude Code skill: what it does, how to install
Guides Bluetooth Low Energy workflows in Swift, covering GATT communication, scanning, and background modes.
npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a claude-codeWhat core-bluetooth does
This skill guides direct Bluetooth Low Energy implementation in iOS projects using CBCentralManager and CBPeripheralManager. It covers filtering scans by CBUUID, establishing connections, discovering GATT services, and handling value updates through notifications.
Starting any Bluetooth task before reaching .poweredOn state will fail immediately. Core Bluetooth lacks a standalone permission prompt API, so you must add NSBluetoothAlwaysUsageDescription to Info.plist and monitor state transitions manually.
When accessory pairing requires privacy-focused picker flows, AccessorySetupKit comes first. This skill handles direct GATT traffic once the device is paired, along with background modes and state restoration.
What it helps with
- scan for specific BLE peripherals using service UUIDs
- subscribe to GATT characteristic updates with
CBPeripheral - handle Bluetooth authorization and manager state changes
- configure background execution modes in
Info.plist
Example prompts for the agent
- Write a Swift manager to discover a heart rate monitor via Core Bluetooth and stream notifications.
- Show how to handle write flow control and value reads on CBPeripheral.
- Set up CBCentralManager with background scanning and state restoration support.
How to install core-bluetooth
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a claude-code2Manually: put the files in place
~/.claude/skills/core-bluetooth/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/core-bluetooth/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a codex2Manually: put the files in place
.agents/skills/core-bluetooth/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a cursor2Manually: put the files in place
.cursor/skills/core-bluetooth/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills core-bluetooth2Manually: put the files in place
.github/skills/core-bluetooth/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/core-bluetoothManually: put the files in place
.devin/skills/core-bluetooth/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about core-bluetooth
How to install core-bluetooth in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a claude-code. The tool adds the skill directly to your Claude Code workspace.
What does the core-bluetooth skill do?
It provides code patterns for BLE central and peripheral roles in Swift. It guides GATT communication, service discovery, payload reads and writes, and background configuration.
When should you use AccessorySetupKit instead?
Use AccessorySetupKit when you need the system accessory picker without granting broad Bluetooth access. Then, rely on this skill for direct GATT operations once connected.