grdb — скилл для Claude Code: что делает и как установить
Помогает проектировать прямые запросы к SQLite, миграции и реактивные подписки через GRDB.swift в приложениях для iOS и macOS.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает grdb
Скилл подключает набор правил и справочников для работы с библиотекой GRDB.swift. Ассистент ориентируется на сценарии, где возможностей высокоуровневых обёрток вроде SQLiteData не хватает: объединение четырёх и более таблиц через JOIN, оконные функции уровня ROW_NUMBER или RANK, а также точечные сырые SQL-запросы для критичных участков.
Внутри заложены пять справочников: начальная настройка пулов соединений DatabaseQueue и DatabasePool, протоколы записей FetchableRecord и PersistableRecord, миграции схемы через DatabaseMigrator, реактивные подписки ValueObservation и профилирование плана выполнения запросов через EXPLAIN QUERY PLAN.
Без анализа EXPLAIN QUERY PLAN оптимизировать запросы бессмысленно — скилл прямо требует проверять план перед добавлением индексов. Для работы в проекте нужны Swift 5.7+, GRDB.swift от версии 6.0, а целевая система должна быть не старее iOS 13 или macOS 10.15.
Какие задачи решает
- составить сложные выборки с объединением четырёх и более таблиц через SQL
- внедрить оконные функции вроде ROW_NUMBER и RANK в запросы к локальной базе
- настроить реактивное обновление интерфейса SwiftUI через ValueObservation
- описать последовательные миграции базы данных с помощью DatabaseMigrator
- найти узкие места в запросах и проверить индексы через команду EXPLAIN QUERY PLAN
Примеры запросов агенту
- Настрой DatabasePool и напиши миграцию для таблицы транзакций с индексами по дате
- Составь сложный SQL-запрос с объединением пяти таблиц и оконной функцией ROW_NUMBER
- Создай подписку ValueObservation на список задач для обновления представления в SwiftUI
Как установить grdb
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 grdb -a claude-code3Вручную: положить файлы
~/.claude/skills/grdb/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/grdb/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill grdb -a codex2Вручную: положить файлы
.agents/skills/grdb/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill grdb -a cursor2Вручную: положить файлы
.cursor/skills/grdb/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/grdb2Вручную: положить файлы
.github/skills/grdb/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill grdb -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/grdbВручную: положить файлы
.devin/skills/grdb/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о grdb
Как установить grdb в Claude Code?
Сначала подключите маркетплейс командой /plugin marketplace add johnrogers/claude-swift-engineering, затем установите плагин вызовом /plugin install swift-engineering@claude-swift-engineering.
Когда выбирать GRDB вместо SQLiteData?
GRDB нужен для сложных JOIN на четыре и более таблицы, оконных функций, требовательного к скорости сырого SQL и подписок ValueObservation. Для простых моделей с @Table или синхронизации с CloudKit авторы рекомендуют оставаться на SQLiteData.
Какие требования к проекту предъявляет скилл?
Проект должен быть написан на Swift 5.7 или новее с подключённой библиотекой GRDB.swift версии 6.0+. Минимальные поддерживаемые платформы — iOS 13 и macOS 10.15.
Исходный текст
SKILL.md · MIT
--- name: grdb description: Use when writing raw SQL with GRDB, complex joins across 4+ tables, window functions, ValueObservation for reactive queries, or dropping down from SQLiteData for performance. Direct SQLite access for iOS/macOS with type-safe queries and migrations. --- # GRDB Direct SQLite access using [GRDB.swift](https://github.com/groue/GRDB.swift) - type-safe Swift wrapper with full SQLite power when you need it. ## 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 | |-----------|-----------| | **[Getting Started](references/getting-started.md)** | Setting up DatabaseQueue or DatabasePool | | **[Queries](references/queries.md)** | Writing raw SQL, Record types, type-safe queries | | **[Value Observation](references/value-observation.md)** | Reactive queries, SwiftUI integration | | **[Migrations](references/migrations.md)** | DatabaseMigrator, schema evolution | | **[Performance](references/performance.md)** | EXPLAIN QUERY PLAN, indexing, profiling | ## When to Use GRDB vs SQLiteData | Scenario | Use | |----------|-----| | Type-safe @Table models | SQLiteData | | CloudKit sync needed | SQLiteData | | Complex joins (4+ tables) | GRDB | | Window functions (ROW_NUMBER, RANK) | GRDB | | Performance-critical raw SQL | GRDB | | Reactive queries (ValueObservation) | GRDB | ## Core Workflow 1. Choose DatabaseQueue (single connection) or DatabasePool (concurrent reads) 2. Define migrations with DatabaseMigrator 3. Create Record types (Codable, FetchableRecord, PersistableRecord) 4. Write queries with raw SQL or QueryInterface 5. Use ValueObservation for reactive updates ## Requirements - iOS 13+, macOS 10.15+ - Swift 5.7+ - GRDB.swift 6.0+ ## Common Mistakes 1. **Performance assumptions without EXPLAIN PLAN** — Assuming your query is fast or slow without checking `EXPLAIN QUERY PLAN` is guessing. Always profile queries with EXPLAIN before optimizing. 2. **Missing indexes on WHERE clauses** — Queries filtering on non-indexed columns scan the entire table. Index any column used in WHERE, JOIN, or ORDER BY clauses for large tables. 3. **Improper migration ordering** — Running migrations out of order or skipping intermediate versions breaks schema consistency. Always apply migrations sequentially; never jump versions. 4. **Record conformance shortcuts** — Not conforming Record types to `PersistableRecord` or `FetchableRecord` correctly leads to silent data loss or deserialization failures. Always implement all required protocols correctly. 5. **ValueObservation without proper cleanup** — Forgetting to cancel ValueObservation when views disappear causes memory leaks and stale data subscriptions. Store the cancellable and clean up in deinit.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering