Agent skill

Migrate Validate

by ruvnet in ruvnet/ruflo

Validate pending migrations for foreign key consistency, rollback safety, and best practices

MITAuto-check: notesDevOps & Cloud

Install Migrate Validate

skills CLI
$ npx skills add ruvnet/ruflo --skill migrate-validate -a claude-code

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

GitHub CLI
$ gh skill install ruvnet/ruflo migrate-validate --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/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruflo-migrations/skills/migrate-validate .claude/skills/migrate-validate && 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
migrate-validate
GitHub stars
74k
Token cost
~660 tokens
SKILL.md length
268 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Validate pending migrations for foreign key consistency, rollback safety, and best practices

  • Works in 10 steps: Find pending migrations -- use Glob to… → Parse SQL -- use Read to load each… → Check foreign keys -- verify that all… → …
  • DevOps & Cloud work in your project
  • SKILL.md covers When to use, Steps and CLI alternative
  • Calls npx

What it does

Migrate Validate is an agent skill from ruvnet/ruflo. Validate pending migrations for foreign key consistency, rollback safety, and best practices

Its SKILL.md is about 660 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 DevOps & Cloud. It works with SQL and Model Context Protocol. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

  • DevOps & Cloud work in your project

Example prompts

  • “/migrate-validate”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Bash, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__memory_list, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__agentdb_pattern-store, mcp__plugin_ruflo-core_ruflo__agentdb_semantic-route

Workflow steps

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

  1. Find pending migrations -- use Glob to list all migration files, cross-reference with applied history via…
  2. Parse SQL -- use Read to load each pending .up.sql and .down.sql file and parse the SQL statements
  3. Check foreign keys -- verify that all REFERENCES targets exist in the current schema or in prior migrations (both applied and pending)
  4. Check NOT NULL defaults -- verify that any ADD COLUMN with NOT NULL has a DEFAULT value
  5. Check rollback completeness -- verify every CREATE/ALTER in the UP file has a corresponding DROP/ALTER in the DOWN file
  6. Flag destructive ops -- warn on DROP TABLE, DROP COLUMN, TRUNCATE without explicit confirmation
  7. Check idempotency -- verify IF EXISTS / IF NOT EXISTS is used for safety
  8. Check naming -- verify table names are plural, column names are snake_case, index names follow idx_table_column convention
  9. Store validation patterns -- two paths (per ruflo-cost-tracker ADR-0001 dual-path pattern)
  10. Report -- display: errors (must fix), warnings (should fix), info (suggestions), with file path and line number for each issue

What it can do on your machine

Read from SKILL.md and the folder at commit de590e1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • Bash
    • mcp__plugin_ruflo-core_ruflo__memory_search
    • mcp__plugin_ruflo-core_ruflo__memory_list
    • mcp__plugin_ruflo-core_ruflo__memory_store
    • mcp__plugin_ruflo-core_ruflo__agentdb_pattern-store
    • mcp__plugin_ruflo-core_ruflo__agentdb_semantic-route

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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

Migrate Validate loads about 660 tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 268 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Glob, Grep, Bash, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__m

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 ruvnet/ruflo at commit de590e1, republished under its MIT licence (© ruvnet). 268 words, ~660 tokens.

Download SKILL.mdSave it as .claude/skills/migrate-validate/SKILL.md (or your agent's skills folder).
name
migrate-validate
description
Validate pending migrations for foreign key consistency, rollback safety, and best practices
allowed-tools
Read, Glob, Grep, Bash, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__memory_list, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__agentdb_pattern-store, mcp__plugin_ruflo-core_ruflo__agentdb_semantic-route

Migrate Validate

Validate all pending database migrations for correctness, safety, and adherence to best practices.

When to use

Before applying migrations to catch issues early -- foreign key references to non-existent tables, missing rollback SQL, destructive operations without safeguards, and naming convention violations.

Steps

  1. Find pending migrations -- use Glob to list all migration files, cross-reference with applied history via mcp__plugin_ruflo-core_ruflo__memory_search --namespace migrations (or memory_list) to identify pending ones. The memory_* tool family routes by namespace; agentdb_hierarchical-* does NOT (it routes by tier), so use memory_* here.
  2. Parse SQL -- use Read to load each pending .up.sql and .down.sql file and parse the SQL statements
  3. Check foreign keys -- verify that all REFERENCES targets exist in the current schema or in prior migrations (both applied and pending)
  4. Check NOT NULL defaults -- verify that any ADD COLUMN with NOT NULL has a DEFAULT value
  5. Check rollback completeness -- verify every CREATE/ALTER in the UP file has a corresponding DROP/ALTER in the DOWN file
  6. Flag destructive ops -- warn on DROP TABLE, DROP COLUMN, TRUNCATE without explicit confirmation
  7. Check idempotency -- verify IF EXISTS / IF NOT EXISTS is used for safety
  8. Check naming -- verify table names are plural, column names are snake_case, index names follow idx_table_column convention
  9. Store validation patterns -- two paths (per ruflo-cost-tracker ADR-0001 dual-path pattern):
    • Pattern store (typed, recommended): mcp__plugin_ruflo-core_ruflo__agentdb_pattern-store with type: 'migration-validation'. No namespace arg — ReasoningBank routes it.
    • Plain store (namespace-routable): mcp__plugin_ruflo-core_ruflo__memory_store --namespace migrations for validation results tied to a specific migration number.
  10. Report -- display: errors (must fix), warnings (should fix), info (suggestions), with file path and line number for each issue

CLI alternative

bash
npx @claude-flow/cli@latest memory search --query "migration validation results" --namespace migrations

© ruvnet, 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 plugins/ruflo-migrations/skills/migrate-validate of ruvnet/ruflo.

Open the folder on GitHubat commit de590e1

Compare with similar skills

Migrate Validate 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.

Migrate Validate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Migrate Validate this skillruvnet/ruflo74k—~660Automated safety check: NotesMIT
Greptimedb Perses DashboardGreptimeTeam/dashboard111—~3.9kAutomated safety check: PassApache-2.0
Take Doc Screenshotspgplex/pgconsole155—~841Automated safety check: PassApache-2.0
Azure Storagemicrosoft/GitHub-Copilot-for-Azure2552 repos~1.3kAutomated safety check: PassMIT
Alloydb Basicsgoogle/skills21k—~1.7kAutomated safety check: PassApache-2.0
TMA1 Observability Querytma1-ai/tma1119—~5.1kAutomated safety check: NotesApache-2.0

Similar skills

  • Greptimedb Perses Dashboard

    GreptimeTeam/dashboard

    Generate Perses dashboards or single panels for GreptimeDB. An agent skill from GreptimeTeam/dashboard.

    111 GitHub stars~3.9k tokensUpdated 7 days ago
    DevOps & CloudAuto-check passed
  • Take Doc Screenshots

    pgplex/pgconsole

    Take screenshots of the running pgconsole app for documentation.

    155 GitHub stars~841 tokensUpdated 1 mo ago
    DatabasesAuto-check passed
  • 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
  • Alloydb Basics

    google/skills

    Official

    Manages clusters, instances, and backups for AlloyDB for PostgreSQL, and integrates with AlloyDB Model Context Protocol (MCP) tools for automated database operations.

    21k GitHub stars~1.7k tokensUpdated today
    DatabasesAuto-check passed
  • Answers questions about agent spend, token use, traces, events, errors and tool usage by running read-only SQL against a local TMA1 observability store.

    119 GitHub stars~5.1k tokensUpdated 19 days ago
    AI & LLM EngineeringAuto-check: notes
  • Official

    Stores, retrieves, and manages data as objects in Cloud Storage on Google Cloud (also known colloquially as GCS) buckets.

    21k GitHub stars~2.8k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Categories

Questions about Migrate Validate

What does Migrate Validate do?

Validate pending migrations for foreign key consistency, rollback safety, and best practices. Migrate Validate is an agent skill from ruvnet/ruflo.

When should I use Migrate Validate?

Migrate Validate fits situations like: devOps & Cloud work in your project.

How do I install Migrate Validate in Claude Code?

Run `npx skills add ruvnet/ruflo --skill migrate-validate -a claude-code`. Or copy the skill folder (plugins/ruflo-migrations/skills/migrate-validate in ruvnet/ruflo) into .claude/skills/migrate-validate in your project. Claude Code loads it when a task matches its description.

How do I install Migrate Validate in Codex?

Run `npx skills add ruvnet/ruflo --skill migrate-validate -a codex`. Or copy the skill folder (plugins/ruflo-migrations/skills/migrate-validate in ruvnet/ruflo) into .agents/skills/migrate-validate in your project. Codex loads it when a task matches its description.

Can I use Migrate Validate 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 ruvnet/ruflo --skill migrate-validate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/migrate-validate, .gemini/skills/migrate-validate, .github/skills/migrate-validate and .opencode/skills/migrate-validate in your project.

What does Migrate Validate need to run?

Going by SKILL.md and its folder, Migrate Validate needs the command-line tools its instructions call (npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Glob, Grep, Bash, mcp__plugin_ruflo-core_ruflo__memory_search, mcp__plugin_ruflo-core_ruflo__memory_list, mcp__plugin_ruflo-core_ruflo__memory_store, mcp__plugin_ruflo-core_ruflo__agentdb_pattern-store, mcp__plugin_ruflo-core_ruflo__agentdb_semantic-route.

Does Migrate Validate access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Migrate Validate safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Migrate Validate use?

Migrate Validate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Migrate Validate use?

About 660 tokens (SKILL.md is roughly 2.6k 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 Migrate Validate?

Skills that share tags, products or a category with Migrate Validate: Greptimedb Perses Dashboard (GreptimeTeam/dashboard, 111 stars), Take Doc Screenshots (pgplex/pgconsole, 155 stars), Azure Storage (microsoft/GitHub-Copilot-for-Azure, 255 stars) and Alloydb Basics (google/skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Migrate Validate?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,012 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 7, 2026.

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