accessory-setup-kit

Discover and configure Bluetooth and Wi-Fi accessories with AccessorySetupKit.

16|2|Updated Jan 1, 2026
One-click install
npx skills add https://github.com/nonameplum/agent-skills --skill accessory-setup-kit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessory-setup-kit
Source: https://github.com/nonameplum/agent-skills/tree/main/accessory-setup-kit
Command: npx skills add https://github.com/nonameplum/agent-skills --skill accessory-setup-kit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often need a privacy-preserving way to discover and configure nearby Bluetooth or Wi-Fi accessories without requesting broad system permissions or exposing user data.

Core Features & Use Cases

  • Privacy-preserving discovery: shows a picker of matching accessories without broad device access.
  • Secure setup: facilitates installation, authentication, migration, renaming, and removal of accessories.
  • Workflow integration: declare required Info.plist keys, create and present ASPickerDisplayItem items, and handle session events to configure devices.

Quick Start

  1. Integrate AccessorySetupKit into your iOS app and declare supported technologies in NSAccessorySetupKitSupports.
  2. Create an ASAccessorySession, configure ASPickerDisplayItem objects with ASDiscoveryDescriptor (Bluetooth service UUID or Wi-Fi SSID) and present the picker to the user.
  3. On accessoryAdded, connect to the selected device using Core Bluetooth or Network extensions and complete setup.

Frequently Asked Questions about accessory-setup-kit

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

FAQPage Schema
How do I discover Bluetooth accessories in iOS without requesting broad system permissions?

AccessorySetupKit enables privacy-preserving discovery of Bluetooth and Wi-Fi accessories by presenting a user picker of matching devices without requiring broad system access. You configure ASDiscoveryDescriptor objects with specific service UUIDs to filter and display nearby accessories.

What is the best way to securely pair and configure Wi-Fi accessories on iOS?

Secure Wi-Fi accessory setup is handled by creating an ASAccessorySession and presenting ASPickerDisplayItem objects configured with the target Wi-Fi SSID. The system manages the user picker interaction and triggers session events for secure installation and authentication.

How does AccessorySetupKit handle device migration and renaming workflows?

AccessorySetupKit facilitates secure setup workflows including migration and renaming of accessories across iOS devices. After presenting the user picker, you handle session events to configure device properties and complete the migration or renaming process.

Do I need to declare specific Info.plist keys to use AccessorySetupKit for Bluetooth discovery?

Yes, integrating AccessorySetupKit requires declaring supported technologies in the NSAccessorySetupKitSupports key within your Info.plist. This entry specifies whether your app requires Bluetooth or Wi-Fi accessory discovery capabilities.

How do I connect to a Bluetooth accessory after the user selects it from the iOS picker?

After the user selects an accessory from the picker, the system fires an accessoryAdded session event. You then connect to the selected device using Core Bluetooth and complete the setup configuration workflow.

Can I use AccessorySetupKit to present a custom picker for nearby Wi-Fi devices?

AccessorySetupKit presents a system-managed user picker for nearby Wi-Fi and Bluetooth devices rather than a custom interface. You define the ASPickerDisplayItem items with specific ASDiscoveryDescriptor criteria to populate the system picker.