{
  "markdown": "# SwiftData Expert Skill\n\nExpert guidance for AI coding tools using the Agent Skills format.  \nFocus: safe persistence architecture, predictable concurrency, migration safety, and CloudKit sync for SwiftData-first projects.\n\n## Installation\n\n```bash\nnpx skills add https://github.com/vanab/SwiftData-agent-skill --skill swiftdata-expert-skill\n```\n\n## Scope\n\nThis skill targets:\n\n- SwiftData schema design and lifecycle management\n- query and fetch behavior in SwiftUI and service layers\n- model context boundaries and mutation safety\n- schema evolution and persistent history operations\n- CloudKit-compatible storage design\n- incremental adoption with Core Data coexistence\n\n## Audience\n\n- teams shipping SwiftData-backed applications\n- developers debugging persistence and sync failures\n- engineers planning schema changes on existing user data\n\n## Capabilities\n\n### Persistence decisions\n\n- select container and configuration strategy\n- separate UI-bound and background persistence flows\n- apply deterministic context and save boundaries\n\n### Concurrency safety\n\n- enforce model isolation with `ModelContext` and `@ModelActor`\n- avoid cross-context mutable model usage\n- use identifier-based handoff patterns\n\n### Query quality\n\n- build stable predicates and sort strategies\n- configure `FetchDescriptor` limits and offsets\n- reduce unnecessary fetch work\n\n### Migration and history\n\n- apply lightweight and custom migration planning\n- model versions with `VersionedSchema`\n- process and clean persistent history with tokens\n\n### CloudKit integration\n\n- configure capabilities and container selection\n- design within CloudKit schema constraints\n- handle SwiftData sync opt-in and opt-out modes\n\n## Skill Structure\n\n```text\nswiftdata-expert-skill/\n├── SKILL.md\n└── references/\n    ├── cloudkit-sync.md\n    ├── concurrency-and-actors.md\n    ├── core-data-adoption.md\n    ├── implementation-playbooks.md\n    ├── migrations-and-history.md\n    ├── model-context-and-lifecycle.md\n    ├── modeling-and-schema.md\n    ├── querying-and-fetching.md\n    ├── relationships-and-inheritance.md\n    └── troubleshooting-and-updates.md\n```\n\n## Coverage Notes\n\n- Primary focus: SwiftData (`@Model`, `ModelContainer`, `ModelContext`, `Query`, migrations, history, CloudKit).\n- Secondary focus: Core Data coexistence boundaries during migration.\n",
  "bytes": 2327,
  "sha": "1758a9e420f7c0771e20df22d5f79c22c6d881b78aa0250853952c874b23396f",
  "repo_slug": "vanab/swiftdata-agent-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_vanab_swiftdata_agent_skill_swiftdata_ex_46561ae5/readme"
}