Evolving The Data Model
TriliumNext/Trilium
A skill your agent uses when adding a DB migration or a new column/field to a Becca entity in Trilium ("add a migration", "new column on notes/attributes", "ALTER TABLE", "add a field to…
A skill your agent uses when writing or reviewing database/config migration scripts or migration registries.
Install Migration Scripts
$ npx skills add mengxi-ream/read-frog --skill migration-scripts -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mengxi-ream/read-frog migration-scripts --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/mengxi-ream/read-frog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/migration-scripts .claude/skills/migration-scripts && 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 "migration-scripts" agent skill from https://github.com/mengxi-ream/read-frog/tree/main/.agents/skills/migration-scripts into .claude/skills/migration-scripts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "migration-scripts", 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/mengxi-ream/read-frog/tree/main/.agents/skills/migration-scriptsType 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 mengxi-ream/read-frog --skill migration-scripts -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mengxi-ream/read-frog migration-scripts --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mengxi-ream/read-frog.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/migration-scripts .agents/skills/migration-scripts && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "migration-scripts" agent skill from https://github.com/mengxi-ream/read-frog/tree/main/.agents/skills/migration-scripts into .agents/skills/migration-scripts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "migration-scripts", 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 mengxi-ream/read-frog --skill migration-scripts -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mengxi-ream/read-frog migration-scripts --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mengxi-ream/read-frog.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/migration-scripts .cursor/skills/migration-scripts && 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 "migration-scripts" agent skill from https://github.com/mengxi-ream/read-frog/tree/main/.agents/skills/migration-scripts into .cursor/skills/migration-scripts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "migration-scripts", 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/mengxi-ream/read-frog.git --path .agents/skills/migration-scripts--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 mengxi-ream/read-frog --skill migration-scripts -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mengxi-ream/read-frog migration-scripts --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mengxi-ream/read-frog.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/migration-scripts .gemini/skills/migration-scripts && 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 "migration-scripts" agent skill from https://github.com/mengxi-ream/read-frog/tree/main/.agents/skills/migration-scripts into .gemini/skills/migration-scripts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "migration-scripts", 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 mengxi-ream/read-frog migration-scriptsInstalls 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 mengxi-ream/read-frog --skill migration-scripts -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mengxi-ream/read-frog.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/migration-scripts .github/skills/migration-scripts && 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 "migration-scripts" agent skill from https://github.com/mengxi-ream/read-frog/tree/main/.agents/skills/migration-scripts into .github/skills/migration-scripts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "migration-scripts", 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 mengxi-ream/read-frog --skill migration-scripts -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mengxi-ream/read-frog migration-scripts --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mengxi-ream/read-frog.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/migration-scripts .opencode/skills/migration-scripts && 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 "migration-scripts" agent skill from https://github.com/mengxi-ream/read-frog/tree/main/.agents/skills/migration-scripts into .opencode/skills/migration-scripts/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "migration-scripts", 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
migration-scripts- GitHub stars
- 10k
- Token cost
- ~589 tokens
- SKILL.md length
- 279 words
- Files
- 1
- Skills in repo
- 9
- Repo updated
- First seen
- Licence
- GPL-3.0
At a glance
A skill your agent uses when writing or reviewing database/config migration scripts or migration registries.
- Reviewing database/config migration scripts
- SKILL.md covers Rule: Migrations Are Frozen…, Rule: Migration Registries…, Rule: Keep Migration Imports… and Checklist
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Migration registries
What it does
Migration Scripts is an agent skill from mengxi-ream/read-frog. Use when writing or reviewing database/config migration scripts or migration registries. Enforces frozen-snapshot migrations, safe registration, and lean import boundaries.
Its SKILL.md is about 590 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, covering Database migrations. It works with Chrome Extensions. The repository describes itself as: 🐸 Read Frog - Language Learning & Translate | 🐸 陪读蛙 - 语言学习与翻译. The licence is GPL-3.0.
When your agent uses it
- Reviewing database/config migration scripts
- Migration registries
Example prompts
- “/migration-scripts”
What it can do on your machine
Read from SKILL.md and the folder at commit 8a29c04. 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 Scripts loads about 589 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 279 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 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 mengxi-ream/read-frog at commit 8a29c04, republished under its GPL-3.0 licence (© mengxi-ream). 279 words, ~589 tokens.
Download SKILL.mdSave it as
.claude/skills/migration-scripts/SKILL.md (or your agent's skills folder).- name
- migration-scripts
- description
- Use when writing or reviewing database/config migration scripts or migration registries. Enforces frozen-snapshot migrations, safe registration, and lean import boundaries.
- metadata.author
- read-frog
- metadata.version
- 1.1.0
Migration Scripts
Rule: Migrations Are Frozen Snapshots
Migration scripts must NEVER import or reference:
- Constants, helpers, or utilities from the main codebase
- Shared types (use
anyfor migration input/output) - Factory functions like
createXxx()
Why: The codebase evolves. A migration written today references code that may change tomorrow. When that constant changes, the migration silently breaks — it now migrates to the new shape, not the shape that existed when the migration was written.
Rule: Migration Registries Must Validate the Chain
In this repo, config migration registries should auto-discover migration files from src/utils/config/migration-scripts/v*-to-v*.ts (for example via import.meta.glob), and the registry must:
- Parse both
fromVersionandtoVersionfrom the filename - Reject invalid steps like
v001-to-v003 - Reject duplicate target versions
- Reject discontinuous chains
Do not silently map only the target version and assume filenames are correct.
Rule: Keep Migration Imports Off Hot Paths
Do not let generic config read helpers or content-script paths import migration registries unless they really perform migration.
Prefer to isolate migration-aware reads/writes into dedicated modules for import/sync/restore flows, so normal runtime paths do not bundle all migration scripts unnecessarily.
Checklist
- All values are hardcoded inline (no imports from
src/) - Input and output typed as
any - No calls to factory functions or helpers
- Default values are literal objects, not references to constants
- Migration is idempotent (safe to re-run)
- Any record the migration seeds carries every field the app resolves at creation time — a migration runs before i18n is initialized and may not import the facade, so a localized field it omits stays blank forever (see
v098-to-v099.ts, which had to repair exactly that) - Auto-discovered registries validate
from -> tocontinuity and duplicate targets - Migration-aware storage logic is isolated from generic read paths
© mengxi-ream, GPL-3.0. 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-scripts of mengxi-ream/read-frog.
Open the folder on GitHubat commit 8a29c04
Compare with similar skills
Migration Scripts 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 |
|---|---|---|---|---|---|---|
| Migration Scripts this skillmengxi-ream/read-frog | 10k | — | ~589 | Automated safety check: Pass | GPL-3.0 | |
| Evolving The Data ModelTriliumNext/Trilium | 38k | — | ~2.1k | Automated safety check: Pass | AGPL-3.0 | |
| Openwrt Package UpdateNethServer/nethsecurity | 191 | — | ~841 | Automated safety check: Pass | Custom licence | |
| Free Willsyahiidkamil/Software-Engineer-AI-Agent-Atlas | 397 | — | ~3.4k | 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 |
Similar skills
Openwrt Package Update
NethServer/nethsecurity
A skill your agent uses when updating any forked OpenWrt package in a NethSecurity workspace from the upstream openwrt/packages feed.
Free Will
syahiidkamil/Software-Engineer-AI-Agent-Atlas
Deliberate-choice procedure for a medium-to-high-stakes engineering fork — when the first plausible solution (the instinct, the default next-token pull) would be costly to get wrong.
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.
Drizzle
kurealnum/dotfiles
Drizzle ORM schema and database guide. An agent skill from kurealnum/dotfiles.
More from mengxi-ream/read-frog
All 9 skills in this repoAdversarial Review
mengxi-ream/read-frog
Adversarial code review using cross-model approach. An agent skill from mengxi-ream/read-frog.
Record Extension Demo
mengxi-ream/read-frog
Record polished, evidence-backed demos of the Read Frog extension as MP4 (and optional GIF) by driving real Chrome with the built extension, following captioned scene scripts, asserting extension…
Extension Puppeteer Debugging
mengxi-ream/read-frog
Debug the built Read Frog extension in real Chrome. An agent skill from mengxi-ream/read-frog.
Webext Core
mengxi-ream/read-frog
Utilities for browser extensions - proxy services for cross-context RPC, type-safe messaging, URL match patterns, fake browser for testing, job scheduling, and shadow DOM isolation.
Wxt
mengxi-ream/read-frog
Build browser extensions with WXT - a next-gen framework with file-based entrypoints, Vite builds, auto-imports, typed storage with migrations, content script UIs, and multi-browser MV2/MV3 support.
Create PR
mengxi-ream/read-frog
Create a pull request, optionally for the issue provided as argument
Related
Works with
Categories
Questions about Migration Scripts
What does Migration Scripts do?
A skill your agent uses when writing or reviewing database/config migration scripts or migration registries. Migration Scripts is an agent skill from mengxi-ream/read-frog. Use when writing or reviewing database/config migration scripts or migration registries.
When should I use Migration Scripts?
Migration Scripts fits situations like: reviewing database/config migration scripts; migration registries.
How do I install Migration Scripts in Claude Code?
Run `npx skills add mengxi-ream/read-frog --skill migration-scripts -a claude-code`. Or copy the skill folder (.agents/skills/migration-scripts in mengxi-ream/read-frog) into .claude/skills/migration-scripts in your project. Claude Code loads it when a task matches its description.
How do I install Migration Scripts in Codex?
Run `npx skills add mengxi-ream/read-frog --skill migration-scripts -a codex`. Or copy the skill folder (.agents/skills/migration-scripts in mengxi-ream/read-frog) into .agents/skills/migration-scripts in your project. Codex loads it when a task matches its description.
Can I use Migration Scripts 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 mengxi-ream/read-frog --skill migration-scripts -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-scripts, .gemini/skills/migration-scripts, .github/skills/migration-scripts and .opencode/skills/migration-scripts in your project.
What does Migration Scripts need to run?
SKILL.md names no scripts, command-line tools or credentials: Migration Scripts is instructions for the agent only.
Does Migration Scripts 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 Scripts 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 Scripts use?
Migration Scripts is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Migration Scripts use?
About 589 tokens (SKILL.md is roughly 2.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 Scripts?
Skills that share tags, products or a category with Migration Scripts: Evolving The Data Model (TriliumNext/Trilium, 38k stars), Openwrt Package Update (NethServer/nethsecurity, 191 stars), Free Will (syahiidkamil/Software-Engineer-AI-Agent-Atlas, 397 stars) and DB Migrations (kurealnum/dotfiles, 290 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Migration Scripts?
mengxi-ream (a GitHub user) maintains it in mengxi-ream/read-frog, which has 9,987 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 7, 2026.
Source: mengxi-ream/read-frog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.