Agent skill

Migration Helper

by pilinux in pilinux/gorest

Analyze GORM model changes, estimate resulting schema (DDL) differences, and propose safe migration steps with verification guidance.

MITAuto-check passedDatabases

Install Migration Helper

skills CLI
$ npx skills add pilinux/gorest --skill migration-helper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pilinux/gorest migration-helper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pilinux/gorest.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/migration-helper .claude/skills/migration-helper && rm -rf skills-src

Use ~/.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/

Facts

Skill name
migration-helper
GitHub stars
506
Token cost
~358 tokens
SKILL.md length
141 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Analyze GORM model changes, estimate resulting schema (DDL) differences, and propose safe migration steps with verification guidance.

  • Works in 3 steps: Locate migration entrypoints in the… → Map model edits to likely DDL changes… → Recommend migration steps and…
  • Databases work in your project
  • SKILL.md covers When to Use, Rules, Project-Specific Paths and Workflow, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Migration Helper is an agent skill from pilinux/gorest. Analyze GORM model changes, estimate resulting schema (DDL) differences, and propose safe migration steps with verification guidance.

Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases. The repository describes itself as: Go RESTful API starter kit with Gin, JWT, GORM (MySQL, PostgreSQL, SQLite), Redis, Mongo, 2FA, email verification, password recovery. The licence is MIT.

When your agent uses it

  • Databases work in your project

Example prompts

  • “/migration-helper”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Locate migration entrypoints in the paths above.
  2. Map model edits to likely DDL changes and affected queries.
  3. Recommend migration steps and verification commands (local + staging).

What it can do on your machine

Read from SKILL.md and the folder at commit 38aab64. 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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Migration Helper loads about 358 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 141 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~358

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from pilinux/gorest at commit 38aab64, republished under its MIT licence (© pilinux). 141 words, ~358 tokens.

Download SKILL.mdSave it as .claude/skills/migration-helper/SKILL.md (or your agent's skills folder).
name
migration-helper
description
Analyze GORM model changes, estimate resulting schema (DDL) differences, and propose safe migration steps with verification guidance.
license
MIT
metadata.mode
diagnostics
metadata.purpose
migration

Migration Helper

When to Use

  • A model change (field add/remove/type change) or migration code is proposed and you need a safe rollout plan.

Rules

  • Start with a non-destructive assessment and clearly call out destructive operations (drops, type narrows, index changes).
  • Recommend backups, staging verification, and zero-downtime considerations for risky changes.

Project-Specific Paths

  • Core migration: database/migrate/
  • Example app migration: example2/internal/database/migrate/
  • Core models: database/model/ (Auth, TwoFA, TwoFABackup, TempEmail)

Workflow

  1. Locate migration entrypoints in the paths above.
  2. Map model edits to likely DDL changes and affected queries.
  3. Recommend migration steps and verification commands (local + staging).

Output

  • Affected models: path:line entries.
  • Schema updates: likely DDL changes and risk level (low/medium/high).
  • Verification: steps and test commands.

Examples

  • "Adding a Role field to Auth model - what migration is needed?"
  • "Changing IDAuth from uint64 to uint32 - what are the risks?"
  • db-infra-mocks, test-runner, patch-applier

© pilinux, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/migration-helper of pilinux/gorest.

Open the folder on GitHubat commit 38aab64

Compare with similar skills

Migration Helper 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.

Migration Helper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Migration Helper this skillpilinux/gorest506—~358Automated safety check: PassMIT
Mail Timeveliovgroup/mail-time143—~1kAutomated safety check: PassBSD-3-Clause
Tgf Server Devthkhxm/tgf128—~1.3kAutomated safety check: NotesMIT
Azure Storagemicrosoft/GitHub-Copilot-for-Azure2552 repos~1.3kAutomated safety check: PassMIT
ArchitectYougLin-dev/Aha-Loop181—~2.2kAutomated safety check: PassMIT
Configure REST Cachestrapi-community/plugin-rest-cache155—~1.1kAutomated safety check: PassMIT

Similar skills

  • Mail Time

    veliovgroup/mail-time

    A skill your agent uses when building, wiring, reviewing, or debugging MailTime and ostrio:mailer email queues for horizontally scaled Node.js, Bun, or Meteor apps.

    143 GitHub stars~1k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Tgf Server Dev

    thkhxm/tgf

    基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。

    128 GitHub stars~1.3k tokensUpdated 2 mo ago
    DatabasesAuto-check: notes
  • Azure Storage

    microsoft/GitHub-Copilot-for-Azure

    Official

    Azure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake.

    255 GitHub starsUsed in 2 repos~1.3k tokens
    DatabasesAuto-check passed
  • Architect

    YougLin-dev/Aha-Loop

    Designs system architecture and selects technology stack based on vision analysis.

    181 GitHub stars~2.2k tokensUpdated 8 mo ago
    DatabasesAuto-check passed
  • Configure REST Cache

    strapi-community/plugin-rest-cache

    Choose and write a Strapi REST Cache configuration for a specific use case.

    155 GitHub stars~1.1k tokensUpdated 12 days ago
    DatabasesAuto-check passed
  • Pocketbase

    pockethost/pockethost

    Models PocketBase backends: collections, relations, auth, API rules, migrations, and architecture.

    1.4k GitHub stars~1k tokensUpdated 12 days ago
    DatabasesAuto-check passed

More from pilinux/gorest

All 20 skills in this repo
  • Config Loader Helper

    pilinux/gorest

    Diagnoses configuration failures in the gorest project by listing the required environment variables grouped by feature and giving minimal commands for a safe local test setup.

    506 GitHub stars~441 tokensUpdated 14 days ago
    Auto-check passed
  • Enumerates Go declarations and signatures from the syntax tree, then proposes small, mechanically safe refactors with file and line citations.

    506 GitHub stars~414 tokensUpdated 14 days ago
    Auto-check passed
  • Local Build and Run

    pilinux/gorest

    Builds and runs a Go project locally to reproduce compile or runtime problems safely, using test environment variables and mocks instead of production credentials.

    506 GitHub stars~362 tokensUpdated 14 days ago
    Auto-check passed
  • Code Navigation

    pilinux/gorest

    Rapid, focused navigation to locate definitions/usages and map the impact of proposed changes.

    506 GitHub stars~354 tokensUpdated 14 days ago
    Auto-check passed
  • Cited Code Explainer

    pilinux/gorest

    Explains how a module behaves in a few short, read-only sections, with a path-and-line citation behind every non-trivial claim.

    506 GitHub stars~244 tokensUpdated 14 days ago
    Auto-check passed
  • Cited File Reader

    pilinux/gorest

    Reads only the lines needed from a source file and answers with a short summary and path:line citations, without changing anything.

    506 GitHub stars~250 tokensUpdated 14 days ago
    Auto-check passed

Questions about Migration Helper

What does Migration Helper do?

Analyze GORM model changes, estimate resulting schema (DDL) differences, and propose safe migration steps with verification guidance. Migration Helper is an agent skill from pilinux/gorest. Analyze GORM model changes, estimate resulting schema (DDL) differences, and propose safe migration steps with verification guidance.

When should I use Migration Helper?

Migration Helper fits situations like: databases work in your project.

How do I install Migration Helper in Claude Code?

Run `npx skills add pilinux/gorest --skill migration-helper -a claude-code`. Or copy the skill folder (.agents/skills/migration-helper in pilinux/gorest) into .claude/skills/migration-helper in your project. Claude Code loads it when a task matches its description.

How do I install Migration Helper in Codex?

Run `npx skills add pilinux/gorest --skill migration-helper -a codex`. Or copy the skill folder (.agents/skills/migration-helper in pilinux/gorest) into .agents/skills/migration-helper in your project. Codex loads it when a task matches its description.

Can I use Migration Helper 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 pilinux/gorest --skill migration-helper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/migration-helper, .gemini/skills/migration-helper, .github/skills/migration-helper and .opencode/skills/migration-helper in your project.

What does Migration Helper need to run?

SKILL.md names no scripts, command-line tools or credentials: Migration Helper is instructions for the agent only.

Does Migration Helper 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 Migration Helper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Migration Helper use?

Migration Helper is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Migration Helper use?

About 358 tokens (SKILL.md is roughly 1.4k 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 Migration Helper?

Skills that share tags, products or a category with Migration Helper: Mail Time (veliovgroup/mail-time, 143 stars), Tgf Server Dev (thkhxm/tgf, 128 stars), Azure Storage (microsoft/GitHub-Copilot-for-Azure, 255 stars) and Architect (YougLin-dev/Aha-Loop, 181 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Migration Helper?

pilinux (a GitHub user) maintains it in pilinux/gorest, which has 506 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on September 25, 2026.

Source: pilinux/gorest on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.