Drizzle
kurealnum/dotfiles
Drizzle ORM schema and database guide. An agent skill from kurealnum/dotfiles.
Generates a Drizzle migration on a fresh Neon branch and runs a production-safety checklist for table sizes, lock order and load rehearsal before the PR opens.
Install Drizzle Migration Safety on Neon
$ npx skills add superset-sh/superset --skill db-migrations -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install superset-sh/superset db-migrations --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/superset-sh/superset.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/db-migrations .claude/skills/db-migrations && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "db-migrations" agent skill from https://github.com/superset-sh/superset/tree/main/.agents/skills/db-migrations into .claude/skills/db-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "db-migrations", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/superset-sh/superset/tree/main/.agents/skills/db-migrationsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add superset-sh/superset --skill db-migrations -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install superset-sh/superset db-migrations --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/superset-sh/superset.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/db-migrations .agents/skills/db-migrations && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "db-migrations" agent skill from https://github.com/superset-sh/superset/tree/main/.agents/skills/db-migrations into .agents/skills/db-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "db-migrations", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add superset-sh/superset --skill db-migrations -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install superset-sh/superset db-migrations --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/superset-sh/superset.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/db-migrations .cursor/skills/db-migrations && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "db-migrations" agent skill from https://github.com/superset-sh/superset/tree/main/.agents/skills/db-migrations into .cursor/skills/db-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "db-migrations", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/superset-sh/superset.git --path .agents/skills/db-migrations--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add superset-sh/superset --skill db-migrations -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install superset-sh/superset db-migrations --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/superset-sh/superset.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/db-migrations .gemini/skills/db-migrations && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "db-migrations" agent skill from https://github.com/superset-sh/superset/tree/main/.agents/skills/db-migrations into .gemini/skills/db-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "db-migrations", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install superset-sh/superset db-migrationsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add superset-sh/superset --skill db-migrations -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/superset-sh/superset.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/db-migrations .github/skills/db-migrations && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "db-migrations" agent skill from https://github.com/superset-sh/superset/tree/main/.agents/skills/db-migrations into .github/skills/db-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "db-migrations", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add superset-sh/superset --skill db-migrations -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install superset-sh/superset db-migrations --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/superset-sh/superset.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/db-migrations .opencode/skills/db-migrations && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "db-migrations" agent skill from https://github.com/superset-sh/superset/tree/main/.agents/skills/db-migrations into .opencode/skills/db-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "db-migrations", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
db-migrations- GitHub stars
- 15k
- Token cost
- ~2k tokens
- SKILL.md length
- 1,112 words
- Files
- 1
- Skills in repo
- 47
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Generates a Drizzle migration on a fresh Neon branch and runs a production-safety checklist for table sizes, lock order and load rehearsal before the PR opens.
- Works in 5 steps: All pending migrations run in ONE… → Never change a column's type on a large,… → Take locks in the order the application… → …
- Changing the database schema in packages/db and generating the migration
- SKILL.md covers Generate, Safety checklist, Rules and Rehearse on a Neon branch of…, plus 2 more sections
- Calls bunx and bun
What it does
The skill starts from the point that a migration which is correct on a quiet database can still take production down, and cites an earlier incident where a rewrite of a very large table while holding heavy locks on the auth tables brought the API down. To generate one, the agent creates a new Neon branch and points the root `.env` files at it, changes the schema under `packages/db/src/schema/`, runs `bunx drizzle-kit generate` from `packages/db`, and applies it to the dev branch only. It must not hand-edit the generated `drizzle` folder without your confirmation.
A safety checklist follows. It covers checking production table sizes with a read-only query, avoiding column type changes on large or busy tables, taking locks on the child table before the tables it references, avoiding long exclusive locks on hot tables, and keeping every statement well inside 60 seconds at production size. It also asks for a rehearsal on a Neon branch of production under load when a hot table is locked or a large one rewritten, data moves in the same release as reads, no tRPC input or output changes in the same PR, and deleting the preview branch after changing a pushed migration.
When your agent uses it
- Changing the database schema in packages/db and generating the migration
- Reviewing a migration for lock and table-rewrite risk before merge
- Deciding whether a migration needs a rehearsal on a production-sized Neon branch
Example prompts
- “Add a nullable deleted_at column to the projects table and generate the migration.”
- “Review the new migration for anything that could lock a hot table in production.”
- “Do we need to rehearse this index change under load before opening the PR?”
Requirements
- A Neon project, with NEON_ORG_ID and NEON_PROJECT_ID set in `.env`
- Bun with drizzle-kit in packages/db
- Read-only production access for the table size query
Workflow steps
5 steps, taken from the step headings in SKILL.md.
- All pending migrations run in ONE transaction
- Never change a column's type on a large, busy table in a normal migration
- Take locks in the order the application does: child first, then its parents
- Know what is hot
- Moving where data is READ from means moving the data in the same release
What it can do on your machine
Read from SKILL.md and the folder at commit 4ec5b6e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
bunxbun
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use bunx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Drizzle Migration Safety on Neon loads about 2k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 1,112 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:15
up a new Neon branch and point the root `.env` files at it. `NEON_ORG_ID` and - NoteMentions a .env fileSKILL.md:16
`NEON_PROJECT_ID` are in `.env`; the Neon `list_projects` tool needs `org_id` passed in. - NoteMentions a .env fileSKILL.md:125
have your migration yet. The workspace `.env`
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,112 words (~2,042 tokens).
“A migration that is correct on a quiet database can still take production down. On 17 September 2026 migration 0119 rewrote ingest.webhook_events (about 540 GB with indexes) while holding ACCESS EXCLUSIVE on the auth tables, and took the API down…”
- name
- db-migrations
Files
Just SKILL.md in .agents/skills/db-migrations of superset-sh/superset.
Open the folder on GitHubat commit 4ec5b6e
Compare with similar skills
Drizzle Migration Safety on Neon next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Drizzle Migration Safety on Neon this skillsuperset-sh/superset | 15k | — | ~2k | Automated safety check: Notes | Custom licence | |
| Drizzlekurealnum/dotfiles | 290 | — | ~1.3k | Automated safety check: Pass | None | |
| DB Migrationskurealnum/dotfiles | 290 | — | ~820 | Automated safety check: Pass | None | |
| Change Database Schemamartin-ueding/geo-activity-playground | 100 | — | ~225 | Automated safety check: Pass | Custom licence | |
| Migrationkortix-ai/suna | 20k | — | ~1.2k | Automated safety check: Pass | Custom licence | |
| Drizzle Erdhiroppy/mf-dashboard | 418 | — | ~627 | Automated safety check: Pass | MIT |
Similar skills
DB Migrations
kurealnum/dotfiles
A skill your agent uses when generating or regenerating Drizzle migration files, changing database schema tables or columns, resolving migration sequence conflicts after rebase, reviewing migration…
Change Database Schema
martin-ueding/geo-activity-playground
How to change the SQLAlchemy data model and generate the matching Alembic migration.
Migration
kortix-ai/suna
How to change the database schema in this repo. An agent skill from kortix-ai/suna.
Drizzle Erd
hiroppy/mf-dashboard
A skill your agent uses when needing to visualize database schema, generate ERD diagrams from Drizzle ORM schemas, or understand table relationships
Archestra Dev Migrations
archestra-ai/archestra
A skill your agent uses when changing Drizzle schemas, generating migrations, editing migration SQL, creating data-only migrations, diagnosing drizzle-kit check failures, or resolving…
More from superset-sh/superset
All 47 skills in this repoMobile Demo Film Editor
superset-sh/superset
Edits real mobile screen recordings into a configurable demo video with phone framing, title cards, cutaways and an end card, using a bundled renderer.
Superset Agent Standup
superset-sh/superset
Sweeps every Superset workspace, task and agent terminal to report what finished, what needs review and what is blocked, read-only, and can publish the digest as a page.
Superset Browser Control
superset-sh/superset
Opens pages, takes screenshots, reads the console, clicks and types in the browser panes of a Superset workspace, with Browser Use as a fallback for other browsers.
Superset Automate
superset-sh/superset
Turns a recurring chore into a scheduled or event-triggered Superset agent, drafting its prompt, picking a target and trigger, and reviewing the first run.
Superset Feedback Reporter
superset-sh/superset
Turns a bug report or feature request about Superset into a short, scannable write-up and submits it privately or as a public GitHub issue.
Superset Incident Triage
superset-sh/superset
Does a read-only first pass on a possible production incident: gathers deploy, Sentry and health-check signals, proposes a severity and status message, then stops for human approval.
Related
Works with
Categories
Questions about Drizzle Migration Safety on Neon
What does Drizzle Migration Safety on Neon do?
Generates a Drizzle migration on a fresh Neon branch and runs a production-safety checklist for table sizes, lock order and load rehearsal before the PR opens. The skill starts from the point that a migration which is correct on a quiet database can still take production down, and cites an earlier incident where a rewrite of a very large table while holding heavy locks on the auth tables brought the API down.env` files at it, changes the schema under `packages/db/src/schema/`, runs `bunx drizzle-kit generate` from `packages/db`, and applies it to the dev branch only.
When should I use Drizzle Migration Safety on Neon?
Drizzle Migration Safety on Neon fits situations like: changing the database schema in packages/db and generating the migration; reviewing a migration for lock and table-rewrite risk before merge; deciding whether a migration needs a rehearsal on a production-sized Neon branch.
How do I install Drizzle Migration Safety on Neon in Claude Code?
Run `npx skills add superset-sh/superset --skill db-migrations -a claude-code`. Or copy the skill folder (.agents/skills/db-migrations in superset-sh/superset) into .claude/skills/db-migrations in your project. Claude Code loads it when a task matches its description.
How do I install Drizzle Migration Safety on Neon in Codex?
Run `npx skills add superset-sh/superset --skill db-migrations -a codex`. Or copy the skill folder (.agents/skills/db-migrations in superset-sh/superset) into .agents/skills/db-migrations in your project. Codex loads it when a task matches its description.
Can I use Drizzle Migration Safety on Neon in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add superset-sh/superset --skill db-migrations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/db-migrations, .gemini/skills/db-migrations, .github/skills/db-migrations and .opencode/skills/db-migrations in your project.
What does Drizzle Migration Safety on Neon need to run?
Going by SKILL.md and its folder, Drizzle Migration Safety on Neon needs the command-line tools its instructions call (bunx and bun). Our summary lists: A Neon project, with NEON_ORG_ID and NEON_PROJECT_ID set in `.env`; Bun with drizzle-kit in packages/db; Read-only production access for the table size query.
Does Drizzle Migration Safety on Neon access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Drizzle Migration Safety on Neon safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Drizzle Migration Safety on Neon use?
Drizzle Migration Safety on Neon has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Drizzle Migration Safety on Neon use?
About 2k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Drizzle Migration Safety on Neon?
Skills that share tags, products or a category with Drizzle Migration Safety on Neon: Drizzle (kurealnum/dotfiles, 290 stars), DB Migrations (kurealnum/dotfiles, 290 stars), Change Database Schema (martin-ueding/geo-activity-playground, 100 stars) and Migration (kortix-ai/suna, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Drizzle Migration Safety on Neon?
superset-sh (a GitHub organization) maintains it in superset-sh/superset, which has 15,042 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 10, 2026.
Source: superset-sh/superset on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.