cloud-sync-diag

Diagnose iCloud sync issues across CloudKit and iCloud Drive.

1.1k|81|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill cloud-sync-diag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cloud-sync-diag
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/.claude-plugin/plugins/axiom/skills/cloud-sync-diag
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill cloud-sync-diag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This diagnostic skill helps debug cloud sync problems across CloudKit and iCloud Drive, focusing on account, connectivity, quota, and timing issues.

Core Features & Use Cases

  • Diagnosing account/entitlements, quota, and network conditions
  • Handling CKError, sync conflicts, and data propagation delays
  • Guidance for both CloudKit and iCloud Drive sync paths

Quick Start

Prompt: "Diagnose CKError: quotaExceeded on a user device."

Frequently Asked Questions about cloud-sync-diag

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

FAQPage Schema
How do I diagnose iCloud sync issues when data isn't appearing on other devices?

Diagnose iCloud sync problems by validating account entitlements, checking network connectivity, verifying storage quota, and confirming CloudKit or iCloud Drive configuration. The Skill guides you through mandatory first-step checks and decision-tree remediation to identify whether the issue stems from connectivity, quota limits, conflicts, or propagation delays.

What should I check when I encounter a CloudKit quota exceeded error?

A CloudKit quotaExceeded error indicates your account or app has reached its storage or request limit. Check your current quota usage, review recent uploads, and verify entitlements. The diagnostic process identifies whether you need to delete data, upgrade your plan, or resolve conflicting records preventing sync.

Can I diagnose sync conflicts and upload stalls across both CloudKit and iCloud Drive?

Yes. The Skill handles diagnostics for both CloudKit and iCloud Drive sync paths, including conflict resolution and upload/download stall scenarios. It validates account status, network conditions, and storage availability to pinpoint whether delays are due to network issues, quota problems, or data conflicts.

Why is my CloudKit or iCloud Drive sync stuck or delayed?

Sync stalls typically result from network connectivity issues, insufficient storage quota, account entitlement problems, or unresolved data conflicts. The diagnostic process systematically checks each factor and provides actionable remediation steps tailored to your specific condition.

What's the first step to troubleshoot an iCloud sync problem?

Start by running mandatory first-step checks: validate your account status and iCloud entitlements, confirm network connectivity, and verify available storage quota. These prerequisites establish baseline health and narrow down whether the issue is account-level, network-related, or storage-constrained.

How do I know if my iCloud account or app has the right entitlements for CloudKit sync?

Entitlement validation checks whether your account and app are correctly configured to use CloudKit or iCloud Drive. The Skill verifies these permissions as a mandatory first-step diagnostic, flagging missing entitlements that would prevent sync from functioning.