cloudkit-code-review skill
✓ VerifiedReviews CloudKit code for container configuration, record management, subscriptions, and sharing patterns.
- GitHub stars
- 87
- Files
- 5
- Last commit
- Sep 15, 2026
- License
- Apache-2.0
- Allowed tools
- —
What does the cloudkit-code-review skill do?
cloudkit-code-review reviews CloudKit code for container configuration, record management, subscriptions, and sharing patterns.
Summary generated from the skill's SKILL.md.
About the cloudkit-code-review skill
Developers reviewing Apple CloudKit implementations can use this skill to identify errors in container configuration, record management, and data synchronization. An agent should load this tool when inspecting code containing imports for CloudKit, CKContainer, CKRecord, CKShare, or CKSubscription. It analyzes codebases to ensure developers are using custom zones instead of default zones, handling CKErrorPartialFailure correctly, and respecting retryAfterSeconds during error recovery.
The skill produces structured reports using a specific file and line number format to highlight issues like missing CKAsset usage for large binaries or improper handling of serverRecordChanged conflicts. It relies on specialized reference files including container-setup.md, records.md, subscriptions.md, and sharing.md to validate specific implementation patterns. By checking for requirements like unique subscription IDs and main thread UI updates, it helps prevent common synchronization and sharing bugs in iCloud-enabled applications.
What an agent can do with it
- 1Validate CloudKit error handlingCheck if the code correctly implements backoff logic when encountering CloudKit errors.
- 2Audit record storage efficiencyEnsure large binary files are being stored as assets rather than direct record data.
- 3Verify sharing requirementsConfirm that sharing features are implemented using custom zones as required by the framework.
- 4Review data synchronization patternsInspect the implementation of batch operations to ensure performance efficiency.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the cloudkit-code-review skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the cloudkit-code-review skill in Plugin
/plugin marketplace add existential-birds/beagle /plugin install beagle-ios@existential-birds
Install the cloudkit-code-review skill in Claude Code
~/.claude/skills/cloudkit-code-review/SKILL.md
$ npx degit existential-birds/beagle/plugins/beagle-ios/skills/cloudkit-code-review ~/.claude/skills/cloudkit-code-reviewInstall the cloudkit-code-review skill in Claude Code (project)
.claude/skills/cloudkit-code-review/SKILL.md
$ npx degit existential-birds/beagle/plugins/beagle-ios/skills/cloudkit-code-review .claude/skills/cloudkit-code-reviewInstall the cloudkit-code-review skill in Codex
~/.agents/skills/cloudkit-code-review/SKILL.md
$ npx degit existential-birds/beagle/plugins/beagle-ios/skills/cloudkit-code-review ~/.agents/skills/cloudkit-code-reviewInstall the cloudkit-code-review skill in Gemini CLI
~/.gemini/skills/cloudkit-code-review/SKILL.md
$ npx degit existential-birds/beagle/plugins/beagle-ios/skills/cloudkit-code-review ~/.gemini/skills/cloudkit-code-reviewInstall the cloudkit-code-review skill in Claude.ai
npx degit existential-birds/beagle/plugins/beagle-ios/skills/cloudkit-code-review cloudkit-code-review && zip -r cloudkit-code-review.zip cloudkit-code-review # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cloudkit-code-review.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work
- Source repository linked and reachableexistential-birds/beagle/plugins/beagle-ios/skills/cloudkit-code-review is public and reachablegithub.com/existential-birds/beagle/tree/HEAD/plugins/beagle ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit 2026-09-15github.com/existential-birds/beagle/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/existential-birds/beagle/blob/HEAD/plugins/beagle ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/existential-birds/beagle/blob/HEAD/plugins/beagle ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 66 linesgithub.com/existential-birds/beagle/blob/HEAD/plugins/beagle ↗Pass
SKILL.md
View on GitHubCloudKit Code Review
Quick Reference
| Issue Type | Reference |
|---|---|
| CKContainer, databases, zones, entitlements | references/container-setup.md |
| CKRecord, references, assets, batch operations | references/records.md |
| CKSubscription, push notifications, silent sync | references/subscriptions.md |
| CKShare, participants, permissions, acceptance | references/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
retryAfterSecondsrespected -
serverRecordChangedconflicts handled with proper merge logic -
CKErrorPartialFailureparsed 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
-
CKAccountChangedNotificationobserved 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
- What happens when the user is signed out of iCloud?
- Does error handling respect rate limiting (
retryAfterSeconds)? - Are conflicts resolved or does data get overwritten silently?
- Is the schema deployed to production before App Store release?
- Are shared records in custom zones (required for CKShare)?
Hard gates (before reporting)
Complete in order for each finding you intend to report. Do not advance until the pass condition is satisfied.
- Location artifact — The finding includes
[FILE:LINE](or a line range) copied from the current file contents; the path resolves in this repo. - Scope read — You read the full surrounding unit: the type or function that owns the CloudKit work (for example the
CKOperationsubclass usage, completion handler chain, orCKRecordlifecycle), not only a diff hunk or isolated snippet. - CloudKit or deployment claim (only if the finding depends on container identifiers, public vs private database choice, custom zone requirement, iCloud account state, entitlements, or production schema) — You name one concrete artifact you inspected (for example
com.apple.developer.icloud-container-environmentor container ID in the entitlements file,CKContainer.default()vs custom identifier in source,Info.plist/ target capability, or evidence that schema is deployed) or you downgrade the item to an open question in Review Questions. - Protocol — Pre-report steps in review-verification-protocol are satisfied for this item (no finding if they are not).
Use the issue format [FILE:LINE] ISSUE_TITLE for each reported finding. Hard gate 4 is the full pre-report checklist for this skill’s review type.
Files in this skill
5cloudkit-code-review skill questions
How do I install the cloudkit-code-review skill in Claude Code?
Run npx degit existential-birds/beagle/plugins/beagle-ios/skills/cloudkit-code-review ~/.claude/skills/cloudkit-code-review. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the cloudkit-code-review skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How should large binary data be handled in CloudKit?
Large binary data should be stored as a CKAsset because CloudKit records have a 1MB limit.
What is required for using CKShare?
Sharing requires the use of custom zones.
How should CloudKit errors be handled regarding rate limiting?
All CloudKit errors must be handled while respecting the retryAfterSeconds value.