accessorysetupkit

Automate AccessorySetupKit accessory discovery and authorization for iOS BLE and Wi-Fi devices.

Updated May 10, 2026
One-click install
npx skills add https://github.com/FelixRauch/medat-figuren --skill accessorysetupkit-felixrauch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: accessorysetupkit
Source: https://github.com/FelixRauch/medat-figuren/tree/main/.agents/skills/accessorysetupkit
Command: npx skills add https://github.com/FelixRauch/medat-figuren --skill accessorysetupkit-felixrauch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Accessory discovery and authorization can force apps into broad Bluetooth/Wi‑Fi permission prompts and complicated legacy flows; this skill helps you set up devices through a privacy-preserving system picker instead.

Core Features & Use Cases

  • Privacy-preserving accessory discovery: Replace permission-heavy scanning with system-provided discovery and per-accessory authorization.
  • Configurable BLE and Wi‑Fi matching: Define discovery descriptors using service UUIDs, names/substrings, manufacturer/service data patterns, or SSID/SSID prefixes.
  • Full lifecycle event handling: Manage session activation, accessory added/changed/removed, picker presentation/dismissal, authorization/migration completion, and recovery from common setup failures.
  • Migration support: Migrate legacy CoreBluetooth-authorized peripherals to AccessorySetupKit using ASMigrationDisplayItem.

Quick Start

Use the AccessorySetupKit ASAccessorySession to present a user-initiated accessory picker for a set of ASPickerDisplayItem instances configured with an ASDiscoveryDescriptor.

Frequently Asked Questions about accessorysetupkit

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

FAQPage Schema
How do I set up Bluetooth accessories in iOS without broad permission prompts?▼

AccessorySetupKit replaces broad Bluetooth permission prompts with a privacy-preserving system picker for per-accessory authorization. You configure an ASAccessorySession with ASDiscoveryDescriptor and ASPickerDisplayItem to handle user-initiated BLE device selection.

How does AccessorySetupKit discovery work for Wi-Fi and BLE devices?▼

AccessorySetupKit discovery uses ASDiscoveryDescriptor to match BLE and Wi-Fi devices via service UUIDs, names, manufacturer data, or SSID prefixes. The system presents matching accessories through a user-initiated picker, ensuring privacy-preserving authorization.

Can I migrate existing CoreBluetooth peripherals to AccessorySetupKit?▼

Yes, you can migrate legacy CoreBluetooth-authorized peripherals to AccessorySetupKit using ASMigrationDisplayItem. The session handles migration completion through event-driven processing, transitioning your existing Bluetooth devices to privacy-preserving authorization.

What is the best way to handle accessory setup lifecycle events in iOS?▼

Handling accessory setup lifecycle events requires event-driven processing using ASAccessorySession to manage activation, accessory added, changed, removed, picker dismissal, and authorization completion. You implement handlers for each session event to maintain setup state.

Do I need specific Info.plist declarations for AccessorySetupKit?▼

Yes, implementing AccessorySetupKit requires correct Info.plist declarations to support the privacy-preserving accessory discovery and authorization. These declarations configure your iOS app to use ASAccessorySession and present the system accessory picker.

Why does AccessorySetupKit replace broad Bluetooth scanning?▼

AccessorySetupKit replaces broad Bluetooth scanning because it provides privacy-preserving per-accessory authorization instead of requesting full Bluetooth access. Users select specific BLE or Wi-Fi devices through a system picker, preventing unnecessary access to all nearby accessories.