Communitygithub.com

YepAPI/skills

Definición de esquemas con Drizzle, push vs migrate, consultas tipadas, relaciones, transacciones y sentencias preparadas.

¿Qué es skills?

Este skill proporciona directrices y patrones para trabajar con Drizzle ORM en proyectos de desarrollo. Cubre la definición de esquemas con `pgTable()`, `mysqlTable()` y `sqliteTable()`, y explica cuándo usar `drizzle-kit push` para iteración rápida en desarrollo frente a `generate` + `migrate` para producción. Incluye ejemplos de consultas tipadas con TypeScript, relaciones mediante el helper `relations()`, sentencias preparadas para optimización de rendimiento, y transacciones con `db.transaction()`. También aborda la creación de índices y el uso de Drizzle Studio para explorar bases de datos visualmente. Está diseñado para plataformas como Claude Code, Cursor o Codex, ayudando a los agentes a generar código consistente y eficiente con Drizzle.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/drizzle-orm

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Drizzle ORM

Reglas

  • Definición de esquemas: pgTable() / mysqlTable() / sqliteTable() en src/db/schema.ts
  • Desarrollo: drizzle-kit push para iteración rápida — no se necesitan archivos de migración
  • Producción: drizzle-kit generate + drizzle-kit migrate para un historial de migraciones rastreable
  • Consultas tipadas: db.select().from(users).where(eq(users.email, email)) — inferencia completa de TypeScript
  • Relaciones: definir con el helper relations() — one() y many() para consultas relacionales con db.query
  • Sentencias preparadas: db.select().from(users).where(eq(users.id, sql.placeholder("id"))).prepare() — reutilizar para rutas críticas
  • Transacciones: db.transaction(async (tx) => { ... }) — usar tx en lugar de db dentro del callback
  • Índices: definir en línea con .index() o en la configuración de la tabla — agregar en columnas usadas en where y orderBy
  • Drizzle Studio: npx drizzle-kit studio para un navegador visual de base de datos durante el desarrollo

Patrones

// schema.ts
import { pgTable, text, timestamp, uuid, integer } from "drizzle-orm/pg-core";
import { relations } from "drizzle-orm";

export const users = pgTable("users", {
  id: uuid("id").primaryKey().defaultRandom(),
  name: text("name").notNull(),
  email: text("email").notNull().unique(),
  createdAt: timestamp("created_at").defaultNow().notNull(),
});

export const posts = pgTable("posts", {
  id: uuid("id").primaryKey().defaultRandom(),
  title: text("title").notNull(),
  authorId: uuid("author_id").references(() => users.id).notNull(),
});

export const usersRelations = relations(users, ({ many }) => ({
  posts: many(posts),
}));

export const postsRelations = relations(posts, ({ one }) => ({
  author: one(users, { fields: [posts.authorId], references: [users.id] }),
}));

// Consulta con relaciones
const result = await db.query.users.findFirst({
  where: eq(users.id, userId),
  with: { posts: true },
});

Evitar

  • drizzle-kit push en producción — usar generate + migrate para migraciones rastreadas
  • SQL crudo cuando la API de Drizzle lo cubra — usar la etiqueta de plantilla sql solo para expresiones complejas
  • Olvidar las definiciones de relations() — sin ellas, las consultas relacionales de db.query no funcionarán
  • Consultas N+1 — usar with en db.query para unir relaciones en una sola consulta
  • Falta de índices en claves foráneas y columnas filtradas — Drizzle no los crea automáticamente

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Skills relacionados