go-goose — Claude Code skill: database migrations with Go
go-goose — a skill for planning and running database migrations using the pressly/goose CLI and Go library. Available on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
no license 1 installs ★ 27 updated 2026-08-21
npx skills add metalagman/agent-skills --skill go-goose -a claude-codeWhat go-goose does
go-goose guides you through writing and executing SQL and Go migrations while respecting your project's layout and database dialect. It clarifies when to use the CLI for CI/CD pipelines and when to embed migrations in Go services via the provider API. The skill recommends SQL migrations for schema changes and Go migrations for complex data backfills, ensures your database driver matches the goose dialect, and flags missing Down migrations before rollbacks.
After understanding your target database, driver, and required command, the skill provides exact commands or code tailored to your environment. If a migration needs special parsing rules or non-transactional execution, the skill will highlight that.
What it helps with
- Write and run an SQL migration to alter database schema
- Create a rollback migration for a deployed change
- Embed migrations inside a Go service using the provider API
- Sequence and deploy hybrid-versioned migrations to production
- Debug migration parsing or transactional execution issues
Example prompts for the agent
- Help me write a Go migration to backfill data into a new column
- What's the goose command to check migration status on Postgres?
- Create an SQL migration adding an index and show how to run it via CLI
How to install go-goose
1Skills CLI (Vercel)
npx skills add metalagman/agent-skills --skill go-goose -a claude-code2Manually: put the files in place
~/.claude/skills/go-goose/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/go-goose/
1Skills CLI (Vercel)
npx skills add metalagman/agent-skills --skill go-goose -a codex2Manually: put the files in place
.agents/skills/go-goose/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add metalagman/agent-skills --skill go-goose -a cursor2Manually: put the files in place
.cursor/skills/go-goose/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install metalagman/agent-skills go-goose2Manually: put the files in place
.github/skills/go-goose/SKILL.md1Skills CLI (Vercel)
npx skills add metalagman/agent-skills --skill go-goose -a gemini-cli2Platform CLI
gemini skills install https://github.com/metalagman/agent-skills --path go-gooseManually: put the files in place
.devin/skills/go-goose/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add metalagman/agent-skills --skill go-goose -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about go-goose
How do I install go-goose in Claude Code?
Run npx skills add metalagman/agent-skills --skill go-goose -a claude-code, then link the skill from ~/.claude/skills/go-goose/SKILL.md in your agent context.
What does the go-goose skill do?
It provides expert guidance for pressly/goose, helping you create and run SQL and Go migrations via CLI or the Go library. The skill guides dialect selection, ensures migrations are idempotent, and advises on versioning strategies.
When should I use SQL migrations versus Go migrations?
Use SQL migrations for schema changes like table creation or column modifications. Reach for Go migrations when you need complex logic or data transformations. The skill helps you choose and write both.