{"id":"6ccb1f7a-f5d0-4788-bb95-30ff26794ec6","shortId":"Rn3kTK","kind":"skill","title":"contacts-framework","tagline":"Read, create, update, and pick contacts using the Contacts and ContactsUI frameworks. Use when fetching contact data, saving new contacts, wrapping CNContactPickerViewController in SwiftUI, handling contact permissions, or working with CNContactStore fetch and save requests.","description":"# Contacts Framework\n\nFetch, create, update, and pick contacts from the user's Contacts database using\n`CNContactStore`, `CNSaveRequest`, and `CNContactPickerViewController`. Targets\nSwift 6.3 / iOS 26+.\n\n## Contents\n\n- [Setup](#setup)\n- [Authorization](#authorization)\n- [Fetching Contacts](#fetching-contacts)\n- [Key Descriptors](#key-descriptors)\n- [Creating and Updating Contacts](#creating-and-updating-contacts)\n- [Contact Picker](#contact-picker)\n- [Observing Changes](#observing-changes)\n- [Common Mistakes](#common-mistakes)\n- [Review Checklist](#review-checklist)\n- [References](#references)\n\n## Setup\n\n### Project Configuration\n\n1. Add `NSContactsUsageDescription` to Info.plist explaining why the app accesses contacts\n2. No additional capability or entitlement is required for basic Contacts access\n3. For contact notes access, add the `com.apple.developer.contacts.notes` entitlement\n\n### Imports\n\n```swift\nimport Contacts       // CNContactStore, CNSaveRequest, CNContact\nimport ContactsUI     // CNContactPickerViewController\n```\n\n## Authorization\n\nRequest access before fetching or saving contacts. The picker (`CNContactPickerViewController`)\ndoes not require authorization -- the system grants access only to the contacts\nthe user selects.\n\n```swift\nlet store = CNContactStore()\n\nfunc requestAccess() async throws -> Bool {\n    return try await store.requestAccess(for: .contacts)\n}\n\n// Check current status without prompting\nfunc checkStatus() -> CNAuthorizationStatus {\n    CNContactStore.authorizationStatus(for: .contacts)\n}\n```\n\n### Authorization States\n\n| Status | Meaning |\n|---|---|\n| `.notDetermined` | User has not been prompted yet |\n| `.authorized` | Full read/write access granted |\n| `.denied` | User denied access; direct to Settings |\n| `.restricted` | Parental controls or MDM restrict access |\n| `.limited` | iOS 18+: user granted access to selected contacts only |\n\n## Fetching Contacts\n\nUse `unifiedContacts(matching:keysToFetch:)` for predicate-based queries.\nUse `enumerateContacts(with:usingBlock:)` for batch enumeration of all contacts.\n\n### Fetch by Name\n\n```swift\nfunc fetchContacts(named name: String) throws -> [CNContact] {\n    let predicate = CNContact.predicateForContacts(matchingName: name)\n    let keys: [CNKeyDescriptor] = [\n        CNContactGivenNameKey as CNKeyDescriptor,\n        CNContactFamilyNameKey as CNKeyDescriptor,\n        CNContactPhoneNumbersKey as CNKeyDescriptor\n    ]\n    return try store.unifiedContacts(matching: predicate, keysToFetch: keys)\n}\n```\n\n### Fetch by Identifier\n\n```swift\nfunc fetchContact(identifier: String) throws -> CNContact {\n    let keys: [CNKeyDescriptor] = [\n        CNContactGivenNameKey as CNKeyDescriptor,\n        CNContactFamilyNameKey as CNKeyDescriptor,\n        CNContactEmailAddressesKey as CNKeyDescriptor\n    ]\n    return try store.unifiedContact(withIdentifier: identifier, keysToFetch: keys)\n}\n```\n\n### Enumerate All Contacts\n\nPerform I/O-heavy enumeration off the main thread.\n\n```swift\nfunc fetchAllContacts() throws -> [CNContact] {\n    let keys: [CNKeyDescriptor] = [\n        CNContactGivenNameKey as CNKeyDescriptor,\n        CNContactFamilyNameKey as CNKeyDescriptor\n    ]\n    let request = CNContactFetchRequest(keysToFetch: keys)\n    request.sortOrder = .givenName\n\n    var contacts: [CNContact] = []\n    try store.enumerateContacts(with: request) { contact, _ in\n        contacts.append(contact)\n    }\n    return contacts\n}\n```\n\n## Key Descriptors\n\nOnly fetch the properties you need. Accessing an unfetched property throws\n`CNContactPropertyNotFetchedException`.\n\n### Common Keys\n\n| Key | Property |\n|---|---|\n| `CNContactGivenNameKey` | First name |\n| `CNContactFamilyNameKey` | Last name |\n| `CNContactPhoneNumbersKey` | Phone numbers array |\n| `CNContactEmailAddressesKey` | Email addresses array |\n| `CNContactPostalAddressesKey` | Mailing addresses array |\n| `CNContactImageDataKey` | Full-resolution contact photo |\n| `CNContactThumbnailImageDataKey` | Thumbnail contact photo |\n| `CNContactBirthdayKey` | Birthday date components |\n| `CNContactOrganizationNameKey` | Company name |\n\n### Composite Key Descriptors\n\nUse `CNContactFormatter.descriptorForRequiredKeys(for:)` to fetch all keys needed\nfor formatting a contact's name.\n\n```swift\nlet nameKeys = CNContactFormatter.descriptorForRequiredKeys(for: .fullName)\nlet keys: [CNKeyDescriptor] = [nameKeys, CNContactPhoneNumbersKey as CNKeyDescriptor]\n```\n\n## Creating and Updating Contacts\n\nUse `CNMutableContact` to build new contacts and `CNSaveRequest` to persist changes.\n\n### Creating a New Contact\n\n```swift\nfunc createContact(givenName: String, familyName: String, phone: String) throws {\n    let contact = CNMutableContact()\n    contact.givenName = givenName\n    contact.familyName = familyName\n    contact.phoneNumbers = [\n        CNLabeledValue(\n            label: CNLabelPhoneNumberMobile,\n            value: CNPhoneNumber(stringValue: phone)\n        )\n    ]\n\n    let saveRequest = CNSaveRequest()\n    saveRequest.add(contact, toContainerWithIdentifier: nil) // nil = default container\n    try store.execute(saveRequest)\n}\n```\n\n### Updating an Existing Contact\n\nYou must fetch the contact with the properties you intend to modify, create a\nmutable copy, change the properties, then save.\n\n```swift\nfunc updateContactEmail(identifier: String, email: String) throws {\n    let keys: [CNKeyDescriptor] = [\n        CNContactEmailAddressesKey as CNKeyDescriptor\n    ]\n    let contact = try store.unifiedContact(withIdentifier: identifier, keysToFetch: keys)\n    guard let mutable = contact.mutableCopy() as? CNMutableContact else { return }\n\n    mutable.emailAddresses.append(\n        CNLabeledValue(label: CNLabelWork, value: email as NSString)\n    )\n\n    let saveRequest = CNSaveRequest()\n    saveRequest.update(mutable)\n    try store.execute(saveRequest)\n}\n```\n\n### Deleting a Contact\n\n```swift\nfunc deleteContact(identifier: String) throws {\n    let keys: [CNKeyDescriptor] = [CNContactIdentifierKey as CNKeyDescriptor]\n    let contact = try store.unifiedContact(withIdentifier: identifier, keysToFetch: keys)\n    guard let mutable = contact.mutableCopy() as? CNMutableContact else { return }\n\n    let saveRequest = CNSaveRequest()\n    saveRequest.delete(mutable)\n    try store.execute(saveRequest)\n}\n```\n\n## Contact Picker\n\n`CNContactPickerViewController` lets users pick contacts without granting full\nContacts access. The app receives only the selected contact data.\n\n### SwiftUI Wrapper\n\n```swift\nimport SwiftUI\nimport ContactsUI\n\nstruct ContactPicker: UIViewControllerRepresentable {\n    @Binding var selectedContact: CNContact?\n\n    func makeUIViewController(context: Context) -> CNContactPickerViewController {\n        let picker = CNContactPickerViewController()\n        picker.delegate = context.coordinator\n        return picker\n    }\n\n    func updateUIViewController(_ uiViewController: CNContactPickerViewController, context: Context) {}\n\n    func makeCoordinator() -> Coordinator {\n        Coordinator(self)\n    }\n\n    final class Coordinator: NSObject, CNContactPickerDelegate {\n        let parent: ContactPicker\n\n        init(_ parent: ContactPicker) {\n            self.parent = parent\n        }\n\n        func contactPicker(_ picker: CNContactPickerViewController, didSelect contact: CNContact) {\n            parent.selectedContact = contact\n        }\n\n        func contactPickerDidCancel(_ picker: CNContactPickerViewController) {\n            parent.selectedContact = nil\n        }\n    }\n}\n```\n\n### Using the Picker\n\n```swift\nstruct ContactSelectionView: View {\n    @State private var selectedContact: CNContact?\n    @State private var showPicker = false\n\n    var body: some View {\n        VStack {\n            if let contact = selectedContact {\n                Text(\"\\(contact.givenName) \\(contact.familyName)\")\n            }\n            Button(\"Select Contact\") {\n                showPicker = true\n            }\n        }\n        .sheet(isPresented: $showPicker) {\n            ContactPicker(selectedContact: $selectedContact)\n        }\n    }\n}\n```\n\n### Filtering the Picker\n\nUse predicates to control which contacts appear and what the user can select.\n\n```swift\nlet picker = CNContactPickerViewController()\n// Only show contacts that have an email address\npicker.predicateForEnablingContact = NSPredicate(format: \"emailAddresses.@count > 0\")\n// Selecting a contact returns it directly (no detail card)\npicker.predicateForSelectionOfContact = NSPredicate(value: true)\n```\n\n## Observing Changes\n\nListen for external contact database changes to refresh cached data.\n\n```swift\nfunc observeContactChanges() {\n    NotificationCenter.default.addObserver(\n        forName: .CNContactStoreDidChange,\n        object: nil,\n        queue: .main\n    ) { _ in\n        // Refetch contacts -- cached CNContact objects are stale\n        refreshContacts()\n    }\n}\n```\n\n## Common Mistakes\n\n### DON'T: Fetch all keys when you only need a name\n\nOver-fetching wastes memory and slows queries, especially for contacts with\nlarge photos.\n\n```swift\n// WRONG: Fetches everything including full-resolution photos\nlet keys: [CNKeyDescriptor] = [CNContactCompleteNameKey as CNKeyDescriptor,\n    CNContactImageDataKey as CNKeyDescriptor,\n    CNContactPhoneNumbersKey as CNKeyDescriptor,\n    CNContactEmailAddressesKey as CNKeyDescriptor,\n    CNContactPostalAddressesKey as CNKeyDescriptor,\n    CNContactBirthdayKey as CNKeyDescriptor]\n\n// CORRECT: Fetch only what you display\nlet keys: [CNKeyDescriptor] = [\n    CNContactGivenNameKey as CNKeyDescriptor,\n    CNContactFamilyNameKey as CNKeyDescriptor\n]\n```\n\n### DON'T: Access unfetched properties\n\nAccessing a property that was not in `keysToFetch` throws\n`CNContactPropertyNotFetchedException` at runtime.\n\n```swift\n// WRONG: Only fetched name keys, now accessing phone\nlet keys: [CNKeyDescriptor] = [CNContactGivenNameKey as CNKeyDescriptor]\nlet contact = try store.unifiedContact(withIdentifier: id, keysToFetch: keys)\nlet phone = contact.phoneNumbers.first // CRASH\n\n// CORRECT: Include the key you need\nlet keys: [CNKeyDescriptor] = [\n    CNContactGivenNameKey as CNKeyDescriptor,\n    CNContactPhoneNumbersKey as CNKeyDescriptor\n]\n```\n\n### DON'T: Mutate a CNContact directly\n\n`CNContact` is immutable. You must call `mutableCopy()` to get a `CNMutableContact`.\n\n```swift\n// WRONG: CNContact has no setter\nlet contact = try store.unifiedContact(withIdentifier: id, keysToFetch: keys)\ncontact.givenName = \"New Name\" // Compile error\n\n// CORRECT: Create mutable copy\nguard let mutable = contact.mutableCopy() as? CNMutableContact else { return }\nmutable.givenName = \"New Name\"\n```\n\n### DON'T: Skip authorization and assume access\n\nWithout calling `requestAccess(for:)`, fetch methods return empty results or throw.\n\n```swift\n// WRONG: Jump straight to fetch\nlet contacts = try store.unifiedContacts(matching: predicate, keysToFetch: keys)\n\n// CORRECT: Check or request access first\nlet granted = try await store.requestAccess(for: .contacts)\nguard granted else { return }\nlet contacts = try store.unifiedContacts(matching: predicate, keysToFetch: keys)\n```\n\n### DON'T: Run heavy fetches on the main thread\n\n`enumerateContacts` performs I/O. Running it on the main thread blocks the UI.\n\n```swift\n// WRONG: Main thread enumeration\nfunc loadContacts() {\n    try store.enumerateContacts(with: request) { contact, _ in ... }\n}\n\n// CORRECT: Run on a background thread\nfunc loadContacts() async throws -> [CNContact] {\n    try await Task.detached {\n        var results: [CNContact] = []\n        try store.enumerateContacts(with: request) { contact, _ in\n            results.append(contact)\n        }\n        return results\n    }.value\n}\n```\n\n## Review Checklist\n\n- [ ] `NSContactsUsageDescription` added to Info.plist\n- [ ] `requestAccess(for: .contacts)` called before fetch or save operations\n- [ ] Authorization denial handled gracefully (guide user to Settings)\n- [ ] Only needed `CNKeyDescriptor` keys included in fetch requests\n- [ ] `CNContactFormatter.descriptorForRequiredKeys(for:)` used when formatting names\n- [ ] Mutable copy created via `mutableCopy()` before modifying contacts\n- [ ] `CNSaveRequest` used for all create/update/delete operations\n- [ ] Heavy fetches (`enumerateContacts`) run off the main thread\n- [ ] `CNContactStoreDidChange` observed to refresh cached contacts\n- [ ] `CNContactPickerViewController` used when full Contacts access is unnecessary\n- [ ] Picker predicates set before presenting the picker view controller\n- [ ] Single `CNContactStore` instance reused across the app\n\n## References\n\n- Extended patterns (multi-select picker, vCard export, search optimization): [references/contacts-patterns.md](references/contacts-patterns.md)\n- [Contacts framework](https://sosumi.ai/documentation/contacts)\n- [CNContactStore](https://sosumi.ai/documentation/contacts/cncontactstore)\n- [CNContactFetchRequest](https://sosumi.ai/documentation/contacts/cncontactfetchrequest)\n- [CNSaveRequest](https://sosumi.ai/documentation/contacts/cnsaverequest)\n- [CNMutableContact](https://sosumi.ai/documentation/contacts/cnmutablecontact)\n- [CNContactPickerViewController](https://sosumi.ai/documentation/contactsui/cncontactpickerviewcontroller)\n- [CNContactPickerDelegate](https://sosumi.ai/documentation/contactsui/cncontactpickerdelegate)\n- [Accessing the contact store](https://sosumi.ai/documentation/contacts/accessing-the-contact-store)\n- [NSContactsUsageDescription](https://sosumi.ai/documentation/bundleresources/information-property-list/nscontactsusagedescription)","tags":["contacts","framework","swift","ios","skills","dpearson2699","accessibility","agent-skills","ai-coding","apple","claude-code","codex-skills"],"capabilities":["skill","source-dpearson2699","skill-contacts-framework","topic-accessibility","topic-agent-skills","topic-ai-coding","topic-apple","topic-claude-code","topic-codex-skills","topic-cursor-skills","topic-ios","topic-ios-development","topic-liquid-glass","topic-localization","topic-mapkit"],"categories":["swift-ios-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/dpearson2699/swift-ios-skills/contacts-framework","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add dpearson2699/swift-ios-skills","source_repo":"https://github.com/dpearson2699/swift-ios-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 599 github stars · SKILL.md body (13,510 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:53:40.404Z","embedding":null,"createdAt":"2026-04-18T20:34:42.469Z","updatedAt":"2026-05-18T18:53:40.404Z","lastSeenAt":"2026-05-18T18:53:40.404Z","tsv":"'/documentation/bundleresources/information-property-list/nscontactsusagedescription)':1270 '/documentation/contacts)':1235 '/documentation/contacts/accessing-the-contact-store)':1266 '/documentation/contacts/cncontactfetchrequest)':1243 '/documentation/contacts/cncontactstore)':1239 '/documentation/contacts/cnmutablecontact)':1251 '/documentation/contacts/cnsaverequest)':1247 '/documentation/contactsui/cncontactpickerdelegate)':1259 '/documentation/contactsui/cncontactpickerviewcontroller)':1255 '0':783 '1':112 '18':238 '2':123 '26':62 '3':135 '6.3':60 'access':121,134,139,156,172,220,225,235,241,383,636,902,905,924,1016,1046,1199,1260 'across':1215 'ad':1132 'add':113,140 'addit':125 'address':405,409,777 'app':120,638,1217 'appear':759 'array':402,406,410 'assum':1015 'async':186,1109 'author':66,67,154,168,206,217,1013,1144 'await':191,1051,1113 'background':1105 'base':255 'basic':132 'batch':262 'bind':655 'birthday':422 'block':1085 'bodi':728 'bool':188 'build':465 'button':739 'cach':807,822,1192 'call':970,1018,1138 'capabl':126 'card':792 'chang':93,96,472,535,798,804 'check':195,1043 'checklist':103,106,1130 'checkstatus':201 'class':683 'cnauthorizationstatus':202 'cncontact':150,277,311,345,364,658,701,721,823,963,965,978,1111,1117 'cncontact.predicateforcontacts':280 'cncontactbirthdaykey':421,882 'cncontactcompletenamekey':867 'cncontactemailaddresseskey':321,403,551,876 'cncontactfamilynamekey':289,318,352,396,897 'cncontactfetchrequest':357,1240 'cncontactformatter.descriptorforrequiredkeys':432,448,1160 'cncontactgivennamekey':286,315,349,393,894,929,953 'cncontactidentifierkey':598 'cncontactimagedatakey':411,870 'cncontactorganizationnamekey':425 'cncontactphonenumberskey':292,399,455,873,956 'cncontactpickerdeleg':686,1256 'cncontactpickerviewcontrol':25,57,153,164,627,663,666,674,698,707,769,1194,1252 'cncontactpostaladdresseskey':407,879 'cncontactpropertynotfetchedexcept':388,914 'cncontactstor':34,54,148,183,1212,1236 'cncontactstore.authorizationstatus':203 'cncontactstoredidchang':814,1188 'cncontactthumbnailimagedatakey':417 'cnkeydescriptor':285,288,291,294,314,317,320,323,348,351,354,453,457,550,553,597,600,866,869,872,875,878,881,884,893,896,899,928,931,952,955,958,1154 'cnlabeledvalu':495,571 'cnlabelphonenumbermobil':497 'cnlabelwork':573 'cnmutablecontact':463,489,567,614,975,1004,1248 'cnphonenumb':499 'cnsaverequest':55,149,469,504,580,619,1174,1244 'com.apple.developer.contacts.notes':142 'common':97,100,389,828 'common-mistak':99 'compani':426 'compil':993 'compon':424 'composit':428 'configur':111 'contact':2,9,12,19,23,29,39,46,51,69,72,81,86,87,90,122,133,137,147,161,176,194,205,244,247,266,333,363,369,372,374,415,419,442,461,467,476,488,506,518,523,555,588,602,625,631,635,643,700,703,734,741,758,772,786,802,821,851,933,983,1035,1054,1060,1099,1122,1125,1137,1173,1193,1198,1231,1262 'contact-pick':89 'contact.familyname':492,738 'contact.givenname':490,737,990 'contact.mutablecopy':565,612,1002 'contact.phonenumbers':494 'contact.phonenumbers.first':942 'contactpick':653,689,692,696,747 'contactpickerdidcancel':705 'contacts-framework':1 'contacts.append':371 'contactselectionview':715 'contactsui':14,152,651 'contain':511 'content':63 'context':661,662,675,676 'context.coordinator':668 'control':231,756,1210 'coordin':679,680,684 'copi':534,998,1167 'correct':885,944,995,1042,1101 'count':782 'crash':943 'creat':5,42,78,83,458,473,531,996,1168 'create/update/delete':1178 'createcontact':479 'creating-and-updating-contact':82 'current':196 'data':20,644,808 'databas':52,803 'date':423 'default':510 'delet':586 'deletecontact':591 'deni':222,224 'denial':1145 'descriptor':74,77,376,430 'detail':791 'didselect':699 'direct':226,789,964 'display':890 'els':568,615,1005,1057 'email':404,545,575,776 'emailaddress':781 'empti':1024 'entitl':128,143 'enumer':263,331,336,1092 'enumeratecontact':258,1076,1182 'error':994 'especi':849 'everyth':858 'exist':517 'explain':117 'export':1226 'extend':1219 'extern':801 'fals':726 'familynam':482,493 'fetch':18,35,41,68,71,158,246,267,302,378,435,521,832,843,857,886,920,1021,1033,1071,1140,1158,1181 'fetchallcontact':343 'fetchcontact':272,307 'fetching-contact':70 'filter':750 'final':682 'first':394,1047 'format':440,780,1164 'fornam':813 'framework':3,15,40,1232 'full':218,413,634,861,1197 'full-resolut':412,860 'fullnam':450 'func':184,200,271,306,342,478,541,590,659,671,677,695,704,810,1093,1107 'get':973 'givennam':361,480,491 'grace':1147 'grant':171,221,240,633,1049,1056 'guard':562,609,999,1055 'guid':1148 'handl':28,1146 'heavi':1070,1180 'i/o':1078 'i/o-heavy':335 'id':937,987 'identifi':304,308,328,543,559,592,606 'immut':967 'import':144,146,151,648,650 'includ':859,945,1156 'info.plist':116,1134 'init':690 'instanc':1213 'intend':528 'io':61,237 'ispres':745 'jump':1030 'key':73,76,284,301,313,330,347,359,375,390,391,429,437,452,549,561,596,608,834,865,892,922,927,939,947,951,989,1041,1066,1155 'key-descriptor':75 'keystofetch':251,300,329,358,560,607,912,938,988,1040,1065 'label':496,572 'larg':853 'last':397 'let':181,278,283,312,346,355,446,451,487,502,548,554,563,578,595,601,610,617,628,664,687,733,767,864,891,926,932,940,950,982,1000,1034,1048,1059 'limit':236 'listen':799 'loadcontact':1094,1108 'mail':408 'main':339,818,1074,1083,1090,1186 'makecoordin':678 'makeuiviewcontrol':660 'match':250,298,1038,1063 'matchingnam':281 'mdm':233 'mean':209 'memori':845 'method':1022 'mistak':98,101,829 'modifi':530,1172 'multi':1222 'multi-select':1221 'must':520,969 'mutabl':533,564,582,611,621,997,1001,1166 'mutable.emailaddresses.append':570 'mutable.givenname':1007 'mutablecopi':971,1170 'mutat':961 'name':269,273,274,282,395,398,427,444,840,921,992,1009,1165 'namekey':447,454 'need':382,438,838,949,1153 'new':22,466,475,991,1008 'nil':508,509,709,816 'notdetermin':210 'note':138 'notificationcenter.default.addobserver':812 'nscontactsusagedescript':114,1131,1267 'nsobject':685 'nspredic':779,794 'nsstring':577 'number':401 'object':815,824 'observ':92,95,797,1189 'observecontactchang':811 'observing-chang':94 'oper':1143,1179 'optim':1228 'over-fetch':841 'parent':230,688,691,694 'parent.selectedcontact':702,708 'pattern':1220 'perform':334,1077 'permiss':30 'persist':471 'phone':400,484,501,925,941 'photo':416,420,854,863 'pick':8,45,630 'picker':88,91,163,626,665,670,697,706,712,752,768,1202,1208,1224 'picker.delegate':667 'picker.predicateforenablingcontact':778 'picker.predicateforselectionofcontact':793 'predic':254,279,299,754,1039,1064,1203 'predicate-bas':253 'present':1206 'privat':718,723 'project':110 'prompt':199,215 'properti':380,386,392,526,537,904,907 'queri':256,848 'queue':817 'read':4 'read/write':219 'receiv':639 'refer':107,108,1218 'references/contacts-patterns.md':1229,1230 'refetch':820 'refresh':806,1191 'refreshcontact':827 'request':38,155,356,368,1045,1098,1121,1159 'request.sortorder':360 'requestaccess':185,1019,1135 'requir':130,167 'resolut':414,862 'restrict':229,234 'result':1025,1116,1127 'results.append':1124 'return':189,295,324,373,569,616,669,787,1006,1023,1058,1126 'reus':1214 'review':102,105,1129 'review-checklist':104 'run':1069,1079,1102,1183 'runtim':916 'save':21,37,160,539,1142 'saverequest':503,514,579,585,618,624 'saverequest.add':505 'saverequest.delete':620 'saverequest.update':581 'search':1227 'select':179,243,642,740,765,784,1223 'selectedcontact':657,720,735,748,749 'self':681 'self.parent':693 'set':228,1151,1204 'setter':981 'setup':64,65,109 'sheet':744 'show':771 'showpick':725,742,746 'singl':1211 'skill' 'skill-contacts-framework' 'skip':1012 'slow':847 'sosumi.ai':1234,1238,1242,1246,1250,1254,1258,1265,1269 'sosumi.ai/documentation/bundleresources/information-property-list/nscontactsusagedescription)':1268 'sosumi.ai/documentation/contacts)':1233 'sosumi.ai/documentation/contacts/accessing-the-contact-store)':1264 'sosumi.ai/documentation/contacts/cncontactfetchrequest)':1241 'sosumi.ai/documentation/contacts/cncontactstore)':1237 'sosumi.ai/documentation/contacts/cnmutablecontact)':1249 'sosumi.ai/documentation/contacts/cnsaverequest)':1245 'sosumi.ai/documentation/contactsui/cncontactpickerdelegate)':1257 'sosumi.ai/documentation/contactsui/cncontactpickerviewcontroller)':1253 'source-dpearson2699' 'stale':826 'state':207,717,722 'status':197,208 'store':182,1263 'store.enumeratecontacts':366,1096,1119 'store.execute':513,584,623 'store.requestaccess':192,1052 'store.unifiedcontact':326,557,604,935,985 'store.unifiedcontacts':297,1037,1062 'straight':1031 'string':275,309,481,483,485,544,546,593 'stringvalu':500 'struct':652,714 'swift':59,145,180,270,305,341,445,477,540,589,647,713,766,809,855,917,976,1028,1088 'swiftui':27,645,649 'system':170 'target':58 'task.detached':1114 'text':736 'thread':340,1075,1084,1091,1106,1187 'throw':187,276,310,344,387,486,547,594,913,1027,1110 'thumbnail':418 'tocontainerwithidentifi':507 'topic-accessibility' 'topic-agent-skills' 'topic-ai-coding' 'topic-apple' 'topic-claude-code' 'topic-codex-skills' 'topic-cursor-skills' 'topic-ios' 'topic-ios-development' 'topic-liquid-glass' 'topic-localization' 'topic-mapkit' 'tri':190,296,325,365,512,556,583,603,622,934,984,1036,1050,1061,1095,1112,1118 'true':743,796 'ui':1087 'uiviewcontrol':673 'uiviewcontrollerrepresent':654 'unfetch':385,903 'unifiedcontact':249 'unnecessari':1201 'updat':6,43,80,85,460,515 'updatecontactemail':542 'updateuiviewcontrol':672 'use':10,16,53,248,257,431,462,710,753,1162,1175,1195 'user':49,178,211,223,239,629,763,1149 'usingblock':260 'valu':498,574,795,1128 'var':362,656,719,724,727,1115 'vcard':1225 'via':1169 'view':716,730,1209 'vstack':731 'wast':844 'withidentifi':327,558,605,936,986 'without':198,632,1017 'work':32 'wrap':24 'wrapper':646 'wrong':856,918,977,1029,1089 'yet':216","prices":[{"id":"364a3888-3ba4-48f0-941e-2f9b8d3920a7","listingId":"6ccb1f7a-f5d0-4788-bb95-30ff26794ec6","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"dpearson2699","category":"swift-ios-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T20:34:42.469Z"}],"sources":[{"listingId":"6ccb1f7a-f5d0-4788-bb95-30ff26794ec6","source":"github","sourceId":"dpearson2699/swift-ios-skills/contacts-framework","sourceUrl":"https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/contacts-framework","isPrimary":false,"firstSeenAt":"2026-04-18T22:00:50.985Z","lastSeenAt":"2026-05-18T18:53:40.404Z"},{"listingId":"6ccb1f7a-f5d0-4788-bb95-30ff26794ec6","source":"skills_sh","sourceId":"dpearson2699/swift-ios-skills/contacts-framework","sourceUrl":"https://skills.sh/dpearson2699/swift-ios-skills/contacts-framework","isPrimary":true,"firstSeenAt":"2026-04-18T20:34:42.469Z","lastSeenAt":"2026-05-07T22:40:34.166Z"}],"details":{"listingId":"6ccb1f7a-f5d0-4788-bb95-30ff26794ec6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"dpearson2699","slug":"contacts-framework","github":{"repo":"dpearson2699/swift-ios-skills","stars":599,"topics":["accessibility","agent-skills","ai-coding","apple","claude-code","codex-skills","cursor-skills","ios","ios-development","liquid-glass","localization","mapkit","networking","storekit","swift","swift-concurrency","swiftdata","swiftui","widgetkit","xcode"],"license":"other","html_url":"https://github.com/dpearson2699/swift-ios-skills","pushed_at":"2026-04-26T21:04:17Z","description":"Agent Skills for iOS 26+, Swift 6.3, SwiftUI, and modern Apple frameworks","skill_md_sha":"1e42b83ca2f0aaf2fd0b2ecd473d9459092017c6","skill_md_path":"skills/contacts-framework/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/contacts-framework"},"layout":"multi","source":"github","category":"swift-ios-skills","frontmatter":{"name":"contacts-framework","description":"Read, create, update, and pick contacts using the Contacts and ContactsUI frameworks. Use when fetching contact data, saving new contacts, wrapping CNContactPickerViewController in SwiftUI, handling contact permissions, or working with CNContactStore fetch and save requests."},"skills_sh_url":"https://skills.sh/dpearson2699/swift-ios-skills/contacts-framework"},"updatedAt":"2026-05-18T18:53:40.404Z"}}