К основному содержанию
скилл CX Codex

drizzle-orm · oakoss — скилл для Claude Code: что делает и как установить

Скилл передаёт агенту правила работы с Drizzle ORM, генерации схем для PostgreSQL, MySQL и SQLite, а также настройки миграций через drizzle-kit.

MIT 263 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill drizzle-orm -a claude-code
Открыть на GitHub

Что делает drizzle-orm

Скилл обучает ассистента паттернам для TypeScript: объявлению таблиц, составлению запросов через Query Builder или реляционный API db.query, настройке связей и транзакций. Он следит за типовыми ошибками, например пропущенным .where() в операциях update или delete.

В базе знаний собраны инструкции по выводу типов через $inferSelect, созданию представлений и работе с командами drizzle-kit push или generate. Для реляционных запросов обязательно передавать схему в клиент drizzle(), иначе API db.query не заработает.

Какие задачи решает

  • объявить схему таблиц для PostgreSQL, MySQL или SQLite
  • составить типобезопасный SQL-запрос с фильтрами и транзакциями
  • настроить миграции базы данных через drizzle-kit
  • описать логические связи между сущностями через relations

Примеры запросов агенту

  • Напиши схему таблицы пользователей для PostgreSQL с автогенерацией id
  • Добавь транзакцию для создания заказа и списания остатков товара
  • Сгенерируй миграцию схемы через drizzle-kit

Как установить drizzle-orm

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill drizzle-orm -a claude-code

2Вручную: положить файлы

~/.claude/skills/drizzle-orm/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/drizzle-orm/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о drizzle-orm

Как установить drizzle-orm в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill drizzle-orm -a claude-code.

Что делает скилл drizzle-orm?

Он направляет ИИ-ассистента при составлении схем, запросов и миграций для Drizzle ORM с учётом диалекта выбранной базы данных.

В чём разница между relations() и .references()?

Метод .references() задаёт внешний ключ на уровне SQL в базе данных, тогда как функция relations() нужна для реляционного API db.query.

Исходный текст

SKILL.md · MIT
---
name: drizzle-orm
description: 'Drizzle ORM for type-safe SQL with PostgreSQL, MySQL, and SQLite. Use when defining schemas, writing queries, managing relations, running migrations, or using drizzle-kit. Use for drizzle, orm, schema, query, migration, pgTable, relations, drizzle-kit, drizzle-zod.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://orm.drizzle.team/docs/overview'
user-invocable: false
---

# Drizzle ORM

## Overview

Drizzle ORM is a lightweight, type-safe TypeScript ORM that maps directly to SQL for PostgreSQL, MySQL, and SQLite. It provides both a SQL-like query builder and a relational queries API, with zero dependencies and full serverless compatibility. Use Drizzle when you need compile-time type safety with SQL-level control; avoid it when you need a full active-record ORM with automatic migrations (use Prisma) or when working with MongoDB/NoSQL databases.

## Quick Reference

| Pattern             | API                                                                    | Key Points                                            |
| ------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------- |
| Schema definition   | `pgTable('name', { columns }, (t) => [indexes])`                       | Third arg returns array of indexes/constraints        |
| Column types        | `text()`, `integer()`, `boolean()`, `timestamp()`                      | Import from `drizzle-orm/pg-core`                     |
| Type inference      | `typeof table.$inferSelect`, `$inferInsert`                            | Derive TS types directly from schema                  |
| Relational queries  | `db.query.table.findMany({ with, where })`                             | Requires schema passed to `drizzle()` client          |
| SQL-like queries    | `db.select().from(table).where()`                                      | Chainable, returns array of rows                      |
| Insert              | `db.insert(table).values({}).returning()`                              | `.returning()` for getting inserted rows              |
| Update              | `db.update(table).set({}).where().returning()`                         | Always include `.where()` to avoid full-table updates |
| Delete              | `db.delete(table).where()`                                             | Always include `.where()` to avoid full-table deletes |
| Upsert              | `.onConflictDoUpdate({ target, set })`                                 | Chain after `.insert().values()`                      |
| Transactions        | `db.transaction(async (tx) => { ... })`                                | Auto-rollback on thrown errors                        |
| Filters             | `eq()`, `and()`, `or()`, `inArray()`, `sql\`\``                        | Import operators from `drizzle-orm`                   |
| Relations           | `relations(table, ({ one, many }) => ({}))`                            | Declares logical relations for relational queries     |
| Generate migrations | `drizzle-kit generate`                                                 | Creates SQL migration files from schema diff          |
| Apply migrations    | `drizzle-kit migrate` or `migrate()` in code                           | Applies pending migrations to database                |
| Push schema         | `drizzle-kit push`                                                     | Direct schema push without migration files            |
| Prepared statements | `db.select().from(t).where(eq(t.id, sql.placeholder('id'))).prepare()` | Reusable parameterized queries                        |
| Views               | `pgView('name').as(qb => ...)`                                         | Regular and materialized views                        |
| $count utility      | `db.$count(table, filter?)`                                            | Shorthand count, usable as subquery                   |
| Generated columns   | `text().generatedAlwaysAs(() => sql\`...\`)`                           | Computed columns (virtual or stored)                  |
| Check constraints   | `check('name', sql\`condition\`)`                                      | Row-level validation at database level                |

## Common Mistakes

| Mistake                                            | Correct Pattern                                                       |
| -------------------------------------------------- | --------------------------------------------------------------------- |
| Missing `.returning()` on insert/update            | Chain `.returning()` to get back inserted/updated rows                |
| Omitting `.where()` on update/delete               | Always provide `.where()` to avoid affecting all rows                 |
| Using `any` for query result types                 | Use `$inferSelect` / `$inferInsert` for type-safe results             |
| Not passing `schema` to `drizzle()` client         | Pass `{ schema }` to enable `db.query` relational API                 |
| Forgetting indexes on foreign key columns          | Add explicit indexes for columns used in joins/lookups                |
| Wrapping related writes without a transaction      | Use `db.transaction()` for multi-table mutations                      |
| Using raw column names with `casing: 'snake_case'` | With casing option, define columns in camelCase without name arg      |
| Declaring relations but missing the inverse        | Both sides of a relation need declarations for relational queries     |
| Using `serial()` in new PostgreSQL schemas         | Prefer `integer().generatedAlwaysAsIdentity()` (modern approach)      |
| Not handling `findFirst` returning `undefined`     | Check for `undefined` before accessing properties                     |
| Importing column types from wrong dialect module   | Use `drizzle-orm/pg-core` for PostgreSQL, `mysql-core`, `sqlite-core` |
| Using `.references()` instead of `relations()`     | `.references()` is SQL foreign key; `relations()` is for query API    |

## Delegation

> If the `tanstack-query` skill is available, delegate client-side caching and server state management to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-query`
>
> If the `tanstack-start` skill is available, delegate server function patterns for database access to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-start`
>
> If the `electricsql` skill is available, delegate Electric setup, shape configuration, and write patterns to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s electricsql -a claude-code -y`
>
> If the `pglite` skill is available, delegate PGlite-specific configuration, extensions, and browser storage patterns to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s pglite -a claude-code -y`

- **Schema validation**: Use `drizzle-zod` to generate Zod schemas from Drizzle tables for input validation
- **Query pattern discovery**: Use `Explore` agent
- **Code review**: Delegate to `code-reviewer` agent

## References

- [Schema definition, column types, constraints, indexes, and type inference](references/schema-definition.md)
- [Relational queries, SQL-like API, joins, subqueries, and aggregations](references/queries.md)
- [Insert, update, delete, upsert, and transactions](references/mutations.md)
- [Relations: one, many, nested with clauses, self-referencing](references/relations.md)
- [Migrations: drizzle-kit generate, migrate, push, pull, studio](references/migrations.md)
- [Filter operators: eq, ne, gt, lt, like, inArray, sql template](references/filters-and-operators.md)
- [Views, materialized views, generated columns, check constraints, $count, batch API](references/views-and-advanced.md)
- [ElectricSQL + PGlite integration: driver setup, schema-to-shape mapping, type inference, local sync](references/electric-integration.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →

Сначала — drizzle-orm от других авторов.

drizzle-orm Mindrally Скилл задаёт агенту правила разработки на Drizzle ORM: схема как код, типы из таблиц, запросы и миграции. CX Codex +1 1 100установок drizzle-orm-patterns giuseppe-trisciuoglio Скилл drizzle-orm-patterns для Claude Code, Cursor, Codex и других агентов, который подключает готовые паттерны Drizzle ORM: определение схем, CRUD, транзакции и миграции через Drizzle Kit. CX Codex +1 5 900установок drizzle-orm-expert davila7 Скилл drizzle-orm-expert помогает проектировать схемы Drizzle ORM, писать реляционные запросы и настраивать миграции. Пригодится при сборке серверного слоя на TypeScript. CX Codex +1 83установок drizzle bobmatnyc Скилл drizzle для Claude Code помогает писать типобезопасный SQL-код с Drizzle ORM. Подключается при работе с drizzle-orm и связанной функциональностью. CX Codex +1 1 900установок drizzle-queries andrelandgraf Скилл drizzle-queries для Claude Code помогает писать типобезопасные запросы к Postgres через Drizzle ORM. Запускается при чтении и изменении данных или добавлении таблицы. CX Codex +1 103установок netlify-database netlify Скилл netlify-database для Claude Code настраивает базу Postgres в проектах Netlify. Он запускается при создании таблиц, написании миграций или подключении Drizzle ORM. CX Codex +1 3 300установок encore-database encoredev Скилл encore-database учит агента работать с PostgreSQL в приложениях на Encore.ts. Он помогает составлять типобезопасные SQL-запросы и писать миграции схемы. CX Codex +1 858установок

Из того же набора106

Весь набор →
ui-ux-polish Скилл ui-ux-polish для итеративной доводки интерфейса веб-приложения: отдельно десктоп и мобильные, паттерны вроде glassmorphism и проверка доступности. CX Codex +1 577установок playwright По Playwright: локаторы, ассерты, скриншоты и PDF, обход бот-защиты, авторизованные сессии, отладка ошибок. CX Codex +1 476установок coolify Скилл для работы с self-hosted PaaS Coolify: деплой приложений и баз, вебхуки, CI/CD и разбор ошибок сборки. CX Codex +1 385установок application-security Скилл application-security разбирает код и архитектуру по OWASP Top 10 и STRIDE, даёт чек-лист перед деплоем и закрывает вопросы по GDPR, HIPAA, SOC 2 и PCI-DSS. CX Codex +1 287установок brand-designer Скилл brand-designer для Claude Code помогает собрать визуальную айдентику: от логотипа до бренд-гайда. Запускается по запросам о палитре, типографике и шаблонах для соцсетей. CX Codex +1 242установок tailwind Скилл помогает настраивать Tailwind CSS v4, собирать темы и компоненты, подключать dark mode и разбирать ошибки сборки. CX Codex +1 233установок vitest-testing Скилл vitest-testing обучает агента писать модульные, компонентные и интеграционные тесты на Vitest. Помогает настроить моки, проверять хуки и тестировать компоненты. CX Codex +1 226установок content-humanizer Скилл content-humanizer переписывает черновик, который выдала модель, чтобы текст читался как написанный человеком: ритм фраз, тон, лишние оговорки. CX Codex +1 225установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой