How does the skill handle CloudKit conflicts?

The skill provides implementation patterns for merging server and client records when a CKError.serverRecordChanged error occurs during a save operation.

Can it help with SwiftData synchronization issues?

Yes, it includes specific diagnostic patterns for identifying incompatible SwiftData attributes and model configurations that prevent CloudKit sync.

What types of iCloud issues does this skill diagnose?

It covers CloudKit account status, entitlement mismatches, network connectivity, storage quotas, and iCloud Drive file upload/download errors.

What is the primary debugging philosophy of this skill?

It operates on the principle that 90% of sync issues stem from configuration, entitlements, or connectivity rather than bugs in the iCloud infrastructure itself.

iCloud Sync Diagnostics

Name: iCloud Sync Diagnostics
Author: CharlesWiltgen

byCharlesWiltgen

•

233

Mobile Development

Diagnoses and resolves iCloud sync issues for CloudKit and iCloud Drive in Apple platform applications.

About

The axiom-cloud-sync-diag skill provides a systematic framework for debugging 'file not syncing' and CloudKit errors across iOS, iPadOS, and macOS development environments. It guides developers through mandatory first steps like checking ubiquity tokens and entitlements, provides structured decision trees for specific errors such as quota exhaustion or server record conflicts, and offers code-level solutions for common pitfalls in SwiftData and file coordination. By emphasizing configuration and connectivity verification over infrastructure assumptions, it significantly reduces the time required to resolve complex synchronization bugs.

Key Features

Conflict resolution logic and file coordinator deadlock diagnosis
Production crisis scenario management and monitoring guides
Decision trees for CloudKit and iCloud Drive specific errors
233 GitHub stars
SwiftData CloudKit integration troubleshooting and incompatible attribute checks
Automated iCloud status and entitlement verification patterns

Use Cases

Debugging files not appearing on secondary Apple devices during development or testing
Resolving production errors like CKError.quotaExceeded or CKError.serverRecordChanged
Verifying app entitlements and container configurations after an app update or migration

About

Key Features

Conflict resolution logic and file coordinator deadlock diagnosis
Production crisis scenario management and monitoring guides
Decision trees for CloudKit and iCloud Drive specific errors
233 GitHub stars
SwiftData CloudKit integration troubleshooting and incompatible attribute checks
Automated iCloud status and entitlement verification patterns

Use Cases

Debugging files not appearing on secondary Apple devices during development or testing
Resolving production errors like CKError.quotaExceeded or CKError.serverRecordChanged
Verifying app entitlements and container configurations after an app update or migration