CL

cloudkit-code-review

Review CloudKit code for secure container setup, batch record handling, and syncing.

Install

mkdir -p .claude/skills/cloudkit-code-review && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16491" && unzip -o skill.zip -d .claude/skills/cloudkit-code-review && rm skill.zip

Installs to .claude/skills/cloudkit-code-review

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Reviews CloudKit code for container setup, record handling, subscriptions, and sharing patterns. Use when reviewing code with import CloudKit, CKContainer, CKRecord, CKShare, or CKSubscription.
193 chars✓ has a “when” trigger
Advanced

Key capabilities

  • Check account status before database operations
  • Verify custom zones are used for production data
  • Ensure all CloudKit errors are handled with `retryAfterSeconds`
  • Confirm `serverRecordChanged` conflicts are handled with merge logic
  • Parse `CKErrorPartialFailure` for individual record errors
  • Validate batch operations are used instead of individual saves

How it works

The skill reviews CloudKit code against a checklist of best practices and common pitfalls, focusing on container setup, record handling, subscriptions, and sharing patterns.

Inputs & outputs

You give it
CloudKit code
You get back
A report of issues found in the CloudKit code, formatted as `[FILE:LINE] ISSUE_TITLE`

When to use cloudkit-code-review

  • Review CloudKit container setup
  • Check record CRUD operations
  • Audit sync and push logic

About this skill

CloudKit Code Review

Quick Reference

Issue TypeReference
CKContainer, databases, zones, entitlementsreferences/container-setup.md
CKRecord, references, assets, batch operationsreferences/records.md
CKSubscription, push notifications, silent syncreferences/subscriptions.md
CKShare, participants, permissions, acceptancereferences/sharing.md

Review Checklist

  • Account status checked before private/shared database operations
  • Custom zones used (not default zone) for production data
  • All CloudKit errors handled with retryAfterSeconds respected
  • serverRecordChanged conflicts handled with proper merge logic
  • CKErrorPartialFailure parsed for individual record errors
  • Batch operations used (CKModifyRecordsOperation) not individual saves
  • Large binary data stored as CKAsset (records have 1MB limit)
  • Record keys type-safe (enums) not string literals
  • UI updates dispatched to main thread from callbacks
  • CKAccountChangedNotification observed for account switches
  • Subscriptions have unique IDs to prevent duplicates
  • CKShare uses custom zone (sharing requires custom zones)

When to Load References

  • Reviewing container/database setup or zones -> container-setup.md
  • Reviewing record CRUD or relationships -> records.md
  • Reviewing push notifications or sync triggers -> subscriptions.md
  • Reviewing sharing or collaboration features -> sharing.md

Output Format

Report issues using: [FILE:LINE] ISSUE_TITLE

Examples:

  • [AppDelegate.swift:24] CKContainer not in custom zone
  • [SyncManager.swift:156] Unhandled CKErrorPartialFailure
  • [DataStore.swift:89] Missing retryAfterSeconds backoff

Review Questions

  1. What happens when the user is signed out of iCloud?
  2. Does error handling respect rate limiting (retryAfterSeconds)?
  3. Are conflicts resolved or does data get overwritten silently?
  4. Is the schema deployed to production before App Store release?
  5. Are shared records in custom zones (required for CKShare)?

When not to use it

  • When reviewing code unrelated to CloudKit
  • When the code does not import CloudKit or use CKContainer, CKRecord, CKShare, or CKSubscription
  • When the user is not interested in security or performance standards

Limitations

  • Focuses only on CloudKit-specific logic
  • Relies on a predefined checklist for review
  • Does not cover general Swift/iOS code quality

How it compares

This skill provides a specialized checklist for CloudKit code, ensuring adherence to specific Apple guidelines and common error handling, which a general code review might miss.

Compared to similar skills

cloudkit-code-review side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
cloudkit-code-review (this skill)06moNo flagsAdvanced
build-macos-apps708moReviewIntermediate
ios-simulator-skill272moReviewAdvanced
build-iphone-apps148moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry