guide-swiftdata — скилл для Claude Code: паттерны SwiftData
Скилл для написания, ревью и отладки кода SwiftData: подсказывает безопасные предикаты, правила автосохранения и ограничения CloudKit.
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a claude-codeЧто делает guide-swiftdata
Это гид по паттернам SwiftData, а не справочник по API. Агент применяет его, когда вы пишете модели, разбираете падение на предикате или проверяете код перед коммитом. Внутри пять файлов-справочников: references/core-rules.md про автосохранение, связи, правила удаления, ограничения @Query, #Unique и @Transient; references/predicates.md про поддерживаемые предикаты и опасные конструкции, которые падают в рантайме; references/cloudkit.md про ограничения CloudKit; references/indexing.md про индексы с iOS 18+; references/class-inheritance.md про наследование классов моделей с iOS 26+.
Порядок проверки задан жёстко: сначала ядро, потом предикаты, затем CloudKit, если проект его использует, индексы для iOS 18+ и наследование для iOS 26+. При частичной задаче агент грузит только нужный файл, поэтому контекст не раздувается. Скилл нацелен на Swift 6.2 и современную конкурентность, Core Data предлагать не станет, а сторонние фреймворки не потянет без вашего согласия.
Ограничение простое: без проекта на SwiftData или при цели ниже iOS 18 часть справочников не откроется, потому что привязка к версии платформы зашита в шаги проверки. Ставить есть смысл, если вы уже пишете на SwiftData и хотите, чтобы агент ловил реальные проблемы, а не придирался по мелочам.
Какие задачи решает
- проверить предикат до того, как он уронит приложение в рантайме
- разобрать правила автосохранения и удаления в моделях
- подобрать индексы для iOS 18+
- учесть ограничения CloudKit при синхронизации
- найти ошибки в наследовании классов моделей для iOS 26+
Примеры запросов агенту
- Проверь мои модели SwiftData по core-rules и predicates
- Посмотри предикаты в этом файле — не упадёт ли в рантайме?
- Мы синхронизируем через CloudKit, проверь ограничения
Как установить guide-swiftdata
1Через Skills CLI (Vercel)
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a claude-code2Вручную: положить файлы
~/.claude/skills/guide-swiftdata/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/guide-swiftdata/
1Через Skills CLI (Vercel)
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a codex2Вручную: положить файлы
.agents/skills/guide-swiftdata/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a cursor2Вручную: положить файлы
.cursor/skills/guide-swiftdata/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Prisma-Labs-Dev/apple-skills guide-swiftdata2Вручную: положить файлы
.github/skills/guide-swiftdata/SKILL.md1Через Skills CLI (Vercel)
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a gemini-cli2Командой платформы
gemini skills install https://github.com/Prisma-Labs-Dev/apple-skills --path skills/guide-swiftdataВручную: положить файлы
.devin/skills/guide-swiftdata/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о guide-swiftdata
Как установить guide-swiftdata в Claude?
Выполните npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a claude-code. Скилл окажется в ~/.claude/skills/guide-swiftdata/SKILL.md.
Что делает guide-swiftdata?
Ведёт агента по паттернам SwiftData: автосохранение, связи, предикаты, CloudKit, индексы и наследование классов. Работает при написании, ревью и отладке кода.
Какие версии нужны для работы скилла?
Цель — Swift 6.2 и современная конкурентность. Справочники по индексам подключаются для iOS 18+, по наследованию классов — для iOS 26+.
Исходный текст
SKILL.md · MIT
--- name: guide-swiftdata description: SwiftData patterns — autosave, relationships, dangerous predicates, CloudKit constraints, indexing, class inheritance. Use when writing, reviewing, or debugging SwiftData code. type: guide origin: https://github.com/twostraws/SwiftData-Agent-Skill license: MIT --- > **Guide Skill** — This is an expert workflow/pattern guide, not API reference documentation. > Originally from [twostraws/SwiftData-Agent-Skill](https://github.com/twostraws/SwiftData-Agent-Skill) by Paul Hudson. MIT License. # SwiftData Patterns Write and review SwiftData code for correctness, modern API usage, and adherence to project conventions. Report only genuine problems — do not nitpick or invent issues. ## Core Instructions - Target Swift 6.2 or later, using modern Swift concurrency. - Prefer SwiftData across the board. Do not suggest Core Data unless the feature cannot be solved with SwiftData. - Do not introduce third-party frameworks without asking first. ## Review Process 1. Check for core SwiftData issues using `references/core-rules.md`. 2. Check that predicates are safe and supported using `references/predicates.md`. 3. If the project uses CloudKit, check for CloudKit-specific constraints using `references/cloudkit.md`. 4. If the project targets iOS 18+, check for indexing opportunities using `references/indexing.md`. 5. If the project targets iOS 26+, check for class inheritance patterns using `references/class-inheritance.md`. If doing partial work, load only the relevant reference files. ## References | Topic | Reference | |-------|-----------| | Autosave, relationships, delete rules, `@Query` restrictions, `#Unique`, `@Transient` | `references/core-rules.md` | | Supported predicates, dangerous patterns that crash at runtime, unsupported methods | `references/predicates.md` | | CloudKit constraints: no `#Unique`, optional requirements, eventual consistency | `references/cloudkit.md` | | Database indexing (iOS 18+), single and compound property indexes | `references/indexing.md` | | Model subclassing (iOS 26+), `@available` requirements, predicate filtering | `references/class-inheritance.md` |
© Prisma-Labs-Dev · MIT · Prisma-Labs-Dev/apple-skills
