cloudkit-schema-source-of-truth

Installation
SKILL.md

CloudKit Schema Source of Truth

CloudKit has no migration-file system like a SQL database. The schema lives in Apple's CloudKit Dashboard/Console, and xcrun cktool (Apple's official CLI, ships with Xcode) can export, validate, and import it — but only against the Development environment. Production promotion is a manual, irreversible Console action. This skill makes the Development side of that workflow scriptable and commit-trackable while keeping the Production gate correctly user-owned.

When to invoke

  • A persistence change adds, renames, or edits a CloudKit record type, field, or index.
  • You need to push schema to a container (Development or Production).
  • Before any Production schema deploy — read the safety gate below first.
  • Asked why a .ckdb file is committed to the repo, or why a field the app writes is missing from Production data.

Scope

Installs
10
GitHub Stars
18
First Seen
Aug 3, 2026