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.