Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dpearson2699/swift-ios-skills --skill core-bluetooth -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/core-bluetooth/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/core-bluetooth/

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.

Similar skills

Everything for Mobile →

From the same set86

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor