Skill13.7k repo starsupdated 3d ago

db-migrations

Create a database migration with Drizzle on a fresh Neon branch. Use when changing the packages/db schema or generating migrations.

View source Repository: superset

Install in Claude Code

Copy

git clone --depth 1 https://github.com/superset-sh/superset /tmp/db-migrations && cp -r /tmp/db-migrations/.agents/skills/db-migrations ~/.claude/skills/db-migrations

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# DB migrations

- Always spin up a new neon branch to create migrations. Update our root .env files to point at the neon branch locally.
- Use drizzle to manage the migration. You can see the schema at packages/db/src/schema. Generating a migration is fine; never *apply* one yourself, and never against a shared or production database; migrations apply through the normal deploy flow.
- Create migrations by changing drizzle schema then running `bunx drizzle-kit generate --name="<sample_name_snake_case>"`
- `NEON_ORG_ID` and `NEON_PROJECT_ID` env vars are set in .env
- list_projects tool requires org_id passed in
- **NEVER manually edit files in `packages/db/drizzle/`** - this includes `.sql` migration files, `meta/_journal.json`, and snapshot files. These are auto-generated by Drizzle. Change only the schema files in `packages/db/src/schema/` and let `drizzle-kit generate` write the migration (hand-edits to generated files require explicit user confirmation).

More from this repository

ticket-formatSkill

Canonical three-section structure for Linear and Superset tickets in this repo. Use when creating, drafting, or grooming a ticket.

project-structure-validatorSubagent

Validates project structure against co-location and architecture patterns defined in AGENTS.md

supersetSkill

Create workspaces, spawn agents, schedule automations, and manage Superset projects/tasks/hosts via the `superset` CLI. Use to orchestrate coding agents across devices from the terminal.

cdp-verificationSkill

Verify UI behavior end-to-end by driving the running desktop app over the Chrome DevTools Protocol. Use when asked to verify, reproduce, or confirm a UI change, bug, or regression in the real app rather than in tests.

decideSkill

Walk the user through design or implementation decisions one at a time, or review completed code one change at a time. Use when the user says "walk me through each decision", "let's decide together", "help me work through these choices", "walk me through what you did", or "QA step by step". Present concise context, mutually exclusive options, log each answer, and finish with a summary.

redesignSkill

Critique and improve the visual design of an existing UI component with concrete implementation guidance. Use when the user asks to redesign, restyle, reimagine, polish, or improve a component, screen, or interface, especially in React and Tailwind codebases.

superset-settingsSkill

Read and update the Superset desktop app's user settings (theme, fonts, terminal, git, notifications, behavior) via the superset CLI, including creating and installing custom themes from JSON. Use when asked to change app settings, switch or create a theme, adjust fonts, or configure desktop preferences without opening the settings UI.

10xSkill

Personalized audit that teaches the advanced Superset features the user isn't using yet (automations, parallel agents, tasks, multi-host, terminal remote control, custom commands, MCP) and sets them up live. Use when the user wants to get more out of Superset, asks "what else can Superset do", "how do I 10x my workflow", "what am I missing", or wants to learn a specific Superset feature.