contacts-framework

The contacts-framework skill provides comprehensive capabilities for integrating Apple's Contacts and ContactsUI frameworks into Swift applications. It enables developers to read, create, update, and manage contacts from the user's Contacts database through CNContactStore, handle contact picker interactions with CNContactPickerViewController, and manage authorization states including the iOS 18+ limited access mode. This skill solves the common challenge of implementing contact management features while handling the complex authorization flows, data fetching patterns, and framework-specific requirements that Apple's Contacts API demands.

Key capabilities include fetching contacts using predicate-based queries or batch enumeration, creating and updating contact records through CNSaveRequest, implementing contact picker UI in SwiftUI applications, and managing contact access permissions across different authorization states. The skill covers essential operations like fetching by name or identifier, enumerating all contacts efficiently, working with key descriptors to optimize data fetching, and observing contact database changes. It specifically addresses iOS 26+ and Swift 6.3 development, incorporating modern concurrency patterns and the latest authorization models.

This skill is designed for iOS developers building applications that require contact integration, such as messaging apps, CRM tools, social networking platforms, or any application needing access to the user's contact information. It provides practical guidance on project configuration including Info.plist requirements, handling different authorization states from full access to limited access, and avoiding common implementation mistakes. The comprehensive coverage includes setup instructions, authorization flows, fetching patterns, and a review checklist to ensure proper implementation.