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

drizzle-migrations · curiositech — скилл для Claude Code

Скилл drizzle-migrations для Claude Code работает со схемой SQLite через Drizzle ORM: описывает таблицы, колонки и индексы, генерирует и применяет миграции. Изменения схемы повторяемы.

MIT 226 установок ★ 274 обновлён 2026-10-30

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

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

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

Внутри — шаблоны конфигурации drizzle.config.ts, определения таблиц через sqliteTable, типы колонок: text, integer, real, blob. Булевы значения хранятся как 0/1, даты как ISO-строки, JSON как текст. Для продакшена скилл предлагает путь через npm run db:generate, а npm run db:push помечает как вариант только для разработки.

Есть ограничение: переименование колонок в SQLite требует ручного SQL — создать новую таблицу, перенести данные. Для PostgreSQL и Prisma скилл не подходит, об этом сказано прямо в его описании.

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

  • добавить таблицу с внешним ключом и каскадным удалением
  • сгенерировать файл миграции из изменений схемы
  • настроить составной индекс по двум колонкам
  • запустить миграции из кода на better-sqlite3
  • выбрать тип колонки под булево значение или JSON

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

  • Добавь в схему таблицу sessions с внешним ключом на users.id и индексом по created_at
  • Сгенерируй миграцию для новой колонки display_name в таблице users
  • Покажи, как применить миграции через migrate() с better-sqlite3

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

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill drizzle-migrations -a claude-code

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

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

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

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

Вопросы о drizzle-migrations

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

Выполни npx skills add curiositech/some_claude_skills --skill drizzle-migrations -a claude-code. Скилл появится в ~/.claude/skills/drizzle-migrations/SKILL.md.

Что делает drizzle-migrations?

Помогает управлять схемой базы через Drizzle ORM: создавать таблицы, менять колонки, добавлять индексы, генерировать и запускать миграции. Заточен под SQLite.

Подойдёт ли скилл для Prisma или TypeORM?

Нет. Скилл работает только с Drizzle ORM, а для PostgreSQL и Supabase советует использовать другие инструменты. Для Prisma и TypeORM синтаксис и паттерны другие.

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

SKILL.md · MIT
---
name: drizzle-migrations
description: Drizzle ORM schema management and SQLite migrations — adding tables, modifying columns, creating indexes, generating and running migrations, Drizzle query patterns. NOT for Prisma, TypeORM,
  Sequelize, or raw SQL migration tools.
allowed-tools: Read,Write,Edit,Bash(npm:*,npx:*)
metadata:
  category: Data & Analytics
  tags:
  - database
  - drizzle
  - migrations
  pairs-with:
  - skill: database-design-patterns
    reason: Schema migration implementation follows database design pattern decisions
  - skill: supabase-admin
    reason: Drizzle migrations run against Supabase PostgreSQL databases with RLS considerations
  - skill: fullstack-debugger
    reason: Migration failures and schema mismatches are common fullstack debugging scenarios
---

# Drizzle ORM Migrations

This skill helps you manage database schema changes using Drizzle ORM with SQLite.

## When to Use

✅ **USE this skill for:**
- Adding new tables or modifying existing columns
- Generating and running database migrations
- Drizzle-specific query patterns and relations
- SQLite schema best practices with Drizzle
- Setting up Drizzle configuration

❌ **DO NOT use for:**
- Supabase/PostgreSQL → use `supabase-admin` skill
- Raw SQL without Drizzle → use standard SQL resources
- Prisma ORM → different syntax and patterns
- General database design theory → use database architecture resources

## Project Setup

**Configuration**: `drizzle.config.ts`
```typescript
import { defineConfig } from 'drizzle-kit';

export default defineConfig({
  schema: './src/db/schema.ts',
  out: './drizzle',
  dialect: 'sqlite',
  dbCredentials: {
    url: './data/app.db',
  },
});
```

**Commands**:
```bash
npm run db:generate  # Generate migration files
npm run db:push      # Push schema directly (dev only)
npm run db:studio    # Open Drizzle Studio GUI
```

## Schema Definition

Location: `src/db/schema.ts`

### Table Definition

```typescript
import { sqliteTable, text, integer, real, blob } from 'drizzle-orm/sqlite-core';
import { relations } from 'drizzle-orm';

// Basic table
export const users = sqliteTable('users', {
  id: text('id').primaryKey(),
  email: text('email').notNull().unique(),
  username: text('username').notNull(),
  passwordHash: text('password_hash'),
  createdAt: text('created_at').notNull().default(sql`CURRENT_TIMESTAMP`),
  updatedAt: text('updated_at'),
});

// Table with foreign key
export const checkIns = sqliteTable('check_ins', {
  id: text('id').primaryKey(),
  userId: text('user_id').notNull().references(() => users.id, {
    onDelete: 'cascade',
  }),
  mood: integer('mood').notNull(),
  cravingLevel: integer('craving_level').notNull(),
  sleepHours: real('sleep_hours'),
  notes: text('notes'),
  createdAt: text('created_at').notNull().default(sql`CURRENT_TIMESTAMP`),
});

// Table with composite index
export const auditLog = sqliteTable('audit_log', {
  id: text('id').primaryKey(),
  userId: text('user_id').notNull(),
  action: text('action').notNull(),
  targetType: text('target_type'),
  targetId: text('target_id'),
  details: text('details'),  // JSON string
  createdAt: text('created_at').notNull().default(sql`CURRENT_TIMESTAMP`),
}, (table) => ({
  userActionIdx: index('idx_audit_user_action').on(table.userId, table.action),
  createdAtIdx: index('idx_audit_created').on(table.createdAt),
}));
```

### Relations

```typescript
export const usersRelations = relations(users, ({ many }) => ({
  checkIns: many(checkIns),
  sessions: many(sessions),
  journalEntries: many(journalEntries),
}));

export const checkInsRelations = relations(checkIns, ({ one }) => ({
  user: one(users, {
    fields: [checkIns.userId],
    references: [users.id],
  }),
}));
```

## Column Types

### SQLite Types in Drizzle

```typescript
import {
  sqliteTable,
  text,           // TEXT - strings, JSON, dates
  integer,        // INTEGER - numbers, booleans (0/1)
  real,           // REAL - floating point
  blob,           // BLOB - binary data
} from 'drizzle-orm/sqlite-core';

const examples = sqliteTable('examples', {
  // Strings
  name: text('name').notNull(),
  description: text('description'),

  // Numbers
  count: integer('count').notNull().default(0),
  rating: real('rating'),

  // Booleans (stored as 0/1)
  isActive: integer('is_active', { mode: 'boolean' }).default(true),

  // Dates (stored as ISO strings)
  createdAt: text('created_at').notNull().default(sql`CURRENT_TIMESTAMP`),
  expiresAt: text('expires_at'),

  // JSON (stored as TEXT)
  metadata: text('metadata', { mode: 'json' }),

  // Enums (stored as TEXT)
  status: text('status', { enum: ['pending', 'active', 'archived'] }),
});
```

## Migration Strategies

### Strategy 1: Push (Development Only)

```bash
npm run db:push
```

- Directly applies schema changes
- Fast for development
- **Never use in production**

### Strategy 2: Generate & Migrate (Production)

```bash
# 1. Generate migration file
npm run db:generate

# 2. Review generated SQL in /drizzle folder

# 3. Apply migration (in code or manually)
```

### Applying Migrations in Code

```typescript
import { drizzle } from 'drizzle-orm/better-sqlite3';
import { migrate } from 'drizzle-orm/better-sqlite3/migrator';
import Database from 'better-sqlite3';

const sqlite = new Database('./data/app.db');
const db = drizzle(sqlite);

// Run migrations
migrate(db, { migrationsFolder: './drizzle' });
```

## Common Schema Changes

### Adding a New Table

```typescript
// 1. Add to schema.ts
export const newFeature = sqliteTable('new_feature', {
  id: text('id').primaryKey(),
  userId: text('user_id').notNull().references(() => users.id),
  name: text('name').notNull(),
  createdAt: text('created_at').notNull().default(sql`CURRENT_TIMESTAMP`),
});

// 2. Add relations
export const newFeatureRelations = relations(newFeature, ({ one }) => ({
  user: one(users, {
    fields: [newFeature.userId],
    references: [users.id],
  }),
}));

// 3. Generate migration
// npm run db:generate
```

### Adding a Column

```typescript
// In schema.ts, add the new column
export const users = sqliteTable('users', {
  // existing columns...
  newColumn: text('new_column'),  // Add this
});

// Generate migration
// npm run db:generate
```

### Adding an Index

```typescript
export const messages = sqliteTable('messages', {
  id: text('id').primaryKey(),
  conversationId: text('conversation_id').notNull(),
  createdAt: text('created_at').notNull(),
}, (table) => ({
  // Add index
  convCreatedIdx: index('idx_messages_conv_created')
    .on(table.conversationId, table.createdAt),
}));
```

### Renaming (Requires Manual SQL)

SQLite doesn't support direct column renames in older versions. For complex changes:

```sql
-- drizzle/XXXX_rename_column.sql
-- Manual migration for column rename

-- 1. Create new table with desired schema
CREATE TABLE users_new (
  id TEXT PRIMARY KEY,
  email TEXT NOT NULL UNIQUE,
  display_name TEXT NOT NULL,  -- renamed from username
  created_at TEXT NOT NULL
);

-- 2. Copy data
INSERT INTO users_new SELECT id, email, username, created_at FROM users;

-- 3. Drop old table
DROP TABLE users;

-- 4. Rename new table
ALTER TABLE users_new RENAME TO users;
```

## Query Patterns

### Basic Queries

```typescript
import { db } from '@/db';
import { eq, and, or, desc, asc, like, gte, lte } from 'drizzle-orm';
import { users, checkIns } from '@/db/schema';

// Select all
const allUsers = await db.select().from(users);

// Select with conditions
const activeUsers = await db
  .select()
  .from(users)
  .where(eq(users.isActive, true));

// Select specific columns
const userEmails = await db
  .select({ id: users.id, email: users.email })
  .from(users);

// Complex where clause
const results = await db
  .select()
  .from(checkIns)
  .where(
    and(
      eq(checkIns.userId, userId),
      gte(checkIns.createdAt, startDate),
      lte(checkIns.createdAt, endDate)
    )
  )
  .orderBy(desc(checkIns.createdAt))
  .limit(30);
```

### Insert

```typescript
// Single insert
const [newUser] = await db
  .insert(users)
  .values({
    id: generateId(),
    email: '[email protected]',
    username: 'newuser',
  })
  .returning();

// Bulk insert
await db.insert(checkIns).values([
  { id: '1', userId, mood: 7, cravingLevel: 2 },
  { id: '2', userId, mood: 8, cravingLevel: 1 },
]);

// Upsert (insert or update)
await db
  .insert(users)
  .values({ id: 'user-1', email: '[email protected]' })
  .onConflictDoUpdate({
    target: users.id,
    set: { email: '[email protected]' },
  });
```

### Update

```typescript
await db
  .update(users)
  .set({ username: 'newname', updatedAt: new Date().toISOString() })
  .where(eq(users.id, userId));
```

### Delete

```typescript
// Always use WHERE clause!
await db
  .delete(checkIns)
  .where(eq(checkIns.id, checkInId));

// Delete with multiple conditions
await db
  .delete(sessions)
  .where(
    and(
      eq(sessions.userId, userId),
      lte(sessions.expiresAt, new Date().toISOString())
    )
  );
```

### Joins

```typescript
const userWithCheckIns = await db
  .select({
    user: users,
    checkIn: checkIns,
  })
  .from(users)
  .leftJoin(checkIns, eq(users.id, checkIns.userId))
  .where(eq(users.id, userId));
```

### Aggregations

```typescript
import { count, avg, sum, max, min } from 'drizzle-orm';

const stats = await db
  .select({
    totalCheckIns: count(),
    avgMood: avg(checkIns.mood),
    maxStreak: max(checkIns.streak),
  })
  .from(checkIns)
  .where(eq(checkIns.userId, userId));
```

## Best Practices

1. **Always use transactions for related changes**
```typescript
await db.transaction(async (tx) => {
  await tx.insert(users).values(userData);
  await tx.insert(profiles).values(profileData);
});
```

2. **Always include WHERE on DELETE/UPDATE**
3. **Use indexes for frequently queried columns**
4. **Store dates as ISO strings for SQLite**
5. **Use `returning()` to get inserted/updated rows**
6. **Generate migrations, don't push to production**

## References

- [Drizzle ORM Docs](https://orm.drizzle.team/docs/overview)
- [Drizzle SQLite](https://orm.drizzle.team/docs/get-started-sqlite)
- [Drizzle Migrations](https://orm.drizzle.team/docs/migrations)

© curiositech · MIT · curiositech/some_claude_skills

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

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

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

drizzle-migrations bobmatnyc Скилл drizzle-migrations для Claude Code задаёт порядок работы с базой в TypeScript: сначала SQL-миграция, потом схема. Миграции становятся источником правды в нескольких окружениях. CX Codex +1 1 300установок drizzle-safe-migrations Pedro Nauck Скилл drizzle-safe-migrations для Claude Code: планирует безопасные миграции Drizzle — бэкфиллы, ужесточение enum/check/default, порядок шагов и откат. Срабатывает при смене схемы, затрагивающей существующие строки. CX Codex +1 348установок drizzle-orm-d1 secondsky Скилл drizzle-orm-d1 для работы с Cloudflare D1 через Drizzle ORM: схемы, типизированные запросы, миграции Drizzle Kit и разбор типовых ошибок D1. CX Codex +1 441установок drizzle bobmatnyc Скилл drizzle для Claude Code помогает писать типобезопасный SQL-код с Drizzle ORM. Подключается при работе с drizzle-orm и связанной функциональностью. CX Codex +1 1 900установок drizzle-best-practices Marc A. Maceira Zayas Скилл drizzle-best-practices для Claude Code и других агентов: подсказывает, как писать схемы, запросы и связи в Drizzle ORM на PostgreSQL в TypeScript-проекте. CX Codex +1 718установок bun-drizzle-integration secondsky Скилл bun-drizzle-integration подсказывает агенту, как связать Drizzle ORM с драйвером bun:sqlite: схема, миграции, CRUD и транзакции в одном месте. CX Codex +1 438установок database-migrations affaan-m Скилл database-migrations для Claude Code помогает писать миграции схемы и данных, планировать откат и готовить изменения без простоя. Включается при добавлении столбца или индекса в большую таблицу. CX Codex +1 7 200установок

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

Весь набор →
design-critic Скилл design-critic для дизайн-ревью интерфейсов по 6 критериям с расчётом баллов и разбором кода компонентов. Помогает найти огрехи в верстке и доступности до релиза. CX Codex +1 230установок grief-companion Скилл grief-companion для Claude Code помогает пережить утрату: объясняет особенности горя, поддерживает при практических задачах и помогает создавать памятные тексты. CX Codex +1 229установок crisis-detection-intervention-ai Скилл crisis-detection-intervention-ai для Claude Code обнаруживает сигналы кризиса в пользовательском тексте и запускает безопасную эскалацию. Используется в приложениях поддержки и восстановления. CX Codex +1 227установок drone-inspection-specialist Скилл drone-inspection-specialist для анализа дроновых съёмок: пожары, крыши, град, тепловидение и 3D-реконструкция. Пригодится в оценке недвижимости и страховании. CX Codex +1 227установок seo-visibility-expert Скилл seo-visibility-expert настраивает поисковую оптимизацию сайта, готовит файл llms.txt для ИИ-краулеров и разметку Schema.org. Пригодится перед запуском веб-проекта. CX Codex +1 224установок mcp-creator Скилл mcp-creator для Claude Code помогает создавать MCP-серверы для внешних API и сервисов с учётом проверки входных данных и обработки ошибок. Активируется по запросам о разработке MCP. CX Codex +1 222установок chatbot-analytics Скилл chatbot-analytics помогает внедрить мониторинг AI-чатов с подсчётом токенов и задержек без сохранения личных данных по стандарту HIPAA. CX Codex +1 221установок technical-writer Скилл technical-writer помогает оформлять документацию для разработчиков по методологии Diátaxis: API-справочники, ADR, ранбуки и README с проверенными примерами кода. CX Codex +1 221установок

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

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