sqlite-data — скилл для Claude Code: что делает и как установить
Помогает проектировать базы данных на Swift с библиотекой SQLiteData, писать выборки через макросы и настраивать синхронизацию с CloudKit.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает sqlite-data
Скилл направляет агента при работе с библиотекой SQLiteData в проектах на Swift. Он содержит справочники по разметке таблиц макросом @Table, выборкам через @FetchAll и @FetchOne, составлению транзакций в блоке database.write и подключению зависимостей через @Dependency(\.defaultDatabase).
Внутри заложены готовые правила для SwiftUI, UIKit и The Composable Architecture. Скилл подсказывает, как оформлять миграции через DatabaseMigrator или #sql(), настраивать рекурсивные CTE, полнотекстовый поиск FTS5 и тесты с сидированием базы.
Любое изменение структуры @Table без отдельной миграции гарантированно уронит приложение при запуске. Поэтому скилл блокирует типичные ошибки: следит за наличием миграций, требует внедрять SyncDelegate для CloudKit и предупреждает N+1 запросы в циклах.
Какие задачи решает
- описать таблицы и связи в SQLite через макрос
@Table - настроить реактивные выборки данных для представлений SwiftUI
- составить безопасные транзакции записи без блокировок потока
- подготовить миграции схемы базы с помощью
DatabaseMigrator - подключить синхронизацию личной базы данных с CloudKit
Примеры запросов агенту
- Объяви модель заметки через макрос
@Tableсо свойствами id, title и createdAt - Напиши запрос выборки через
@FetchAllс сортировкой по дате для списка SwiftUI - Создай миграцию схемы для добавления нового поля в таблицу пользователей
Как установить sqlite-data
1Через маркетплейс плагинов
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineeringКоманда ставит плагин swift-engineering целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill sqlite-data -a claude-code3Вручную: положить файлы
~/.claude/skills/sqlite-data/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sqlite-data/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill sqlite-data -a codex2Вручную: положить файлы
.agents/skills/sqlite-data/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill sqlite-data -a cursor2Вручную: положить файлы
.cursor/skills/sqlite-data/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/sqlite-data2Вручную: положить файлы
.github/skills/sqlite-data/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill sqlite-data -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/sqlite-dataВручную: положить файлы
.devin/skills/sqlite-data/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sqlite-data
Как установить sqlite-data в Claude Code?
Подключите каталог и установите плагин командами /plugin marketplace add johnrogers/claude-swift-engineering и /plugin install swift-engineering@claude-swift-engineering.
Что делает этот скилл?
Он даёт Claude Code контекст и правила работы с библиотекой SQLiteData, макросами таблиц, транзакциями, реактивными запросами и миграциями в Swift.
Зачем для CloudKit обязательно реализовывать SyncDelegate?
Без методов делегата синхронизации приложение не сможет перехватывать ошибки передачи данных и разрешать конфликты записей.
Исходный текст
SKILL.md · MIT
---
name: sqlite-data
description: Use when working with SQLiteData library (@Table, @FetchAll, @FetchOne macros) for SQLite persistence, queries, writes, migrations, or CloudKit private database sync.
---
# SQLite Data
SQLiteData provides type-safe SQLite access through Swift macros, simplifying database modeling and queries while handling CloudKit sync, migrations, and async patterns automatically.
## Reference Loading Guide
**ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake.
| Reference | Load When |
|-----------|-----------|
| **[Table Models](references/models.md)** | Defining tables with `@Table`, setting up primary keys, columns, or enums |
| **[Queries - Basics](references/queries-basics.md)** | Using `@FetchAll`, `@FetchOne`, `@Selection`, filtering, ordering, or joins |
| **[Queries - Advanced](references/queries-advanced.md)** | Using `@Fetch` with `FetchKeyRequest`, dynamic queries, recursive CTEs, or direct reads |
| **[Writes](references/writes.md)** | Inserting, updating, upserting, deleting records, or managing transactions |
| **[Views - SwiftUI](references/views-swiftui.md)** | Using `@FetchAll`/`@FetchOne` in SwiftUI views, `@Observable` models, or animations |
| **[Views - Integration](references/views-integration.md)** | UIKit integration, dynamic query loading, TCA integration, or `observe {}` |
| **[Migrations](references/migrations.md)** | Creating database migrations with `DatabaseMigrator` or `#sql()` macro |
| **[CloudKit Sync](references/cloudkit.md)** | Setting up CloudKit private database sync, sharing, or sync delegates |
| **[Dependencies](references/dependencies.md)** | Injecting database/sync engine via `@Dependency`, bootstrap patterns, or TCA integration |
| **[Testing](references/testing.md)** | Setting up test databases, seeding data, or writing assertions for SQLite code |
| **[Advanced - Queries](references/advanced-queries.md)** | Implementing triggers, custom database functions, or full-text search (FTS5) |
| **[Advanced - Optimization](references/advanced-optimization.md)** | Performance tuning, indexes, custom aggregates, JSON aggregation, or self-joins |
| **[Schema Composition](references/schema-composition.md)** | Using `@Selection` column groups, single-table inheritance, or database views |
## Core Workflow
When working with SQLiteData:
1. Define table models with `@Table` macro
2. Use `@FetchAll`/`@FetchOne` property wrappers in views or `@Observable` models
3. Access database via `@Dependency(\.defaultDatabase)`
4. Perform writes in `database.write { }` transactions
5. Set up migrations before first use
## Common Mistakes
1. **N+1 query patterns** — Loading records one-by-one in a loop (e.g., fetching user then fetching all their posts separately) kills performance. Use joins or batch fetches instead.
2. **Missing migrations on schema changes** — Modifying `@Table` without creating a migration causes crashes at runtime. Always create migrations for schema changes before deploying.
3. **Improper transaction handling** — Long-running transactions outside of `database.write { }` block can cause deadlocks or data loss. Keep write blocks short and focused.
4. **Ignoring CloudKit sync delegates** — Setting up CloudKit sync without implementing `SyncDelegate` means you miss error handling and conflict resolution. Implement all delegate methods for production.
5. **Over-fetching in SwiftUI views** — Using `@FetchAll` without filtering/limiting can load thousands of records, freezing the UI. Use predicates, limits, and sorting to keep in-memory footprint small.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering