run-migration

Runs the project migration script on a target workspace and reports results.

5|2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/decocms/deco-start --skill run-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-migration
Source: https://github.com/decocms/deco-start/tree/main/.claude/skills/run-migration
Command: npx skills add https://github.com/decocms/deco-start --skill run-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run the Deco-start migration workflow against a target site workspace by resetting it to the Fresh/Deno state (origin/main), then applying the local migration script to validate changes in a real environment.

Core Features & Use Cases

  • Orchestrates a safe migration workflow on real site workspaces by resetting to origin/main.
  • Executes the local migration script from the deco-start repository and surfaces a MIGRATION_REPORT.md with results.
  • Provides a clear local testing path for developers to verify migration behavior before deployment.

Quick Start

Run the migration against a target site workspace to validate the migration workflow on a real project.

Frequently Asked Questions about run-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Deco-start migrations safely on a real site workspace?

To automate Deco-start migrations safely, the skill resets your target site workspace to the origin/main Fresh/Deno state, applies the local migration script via tsx, and generates a MIGRATION_REPORT.md to document validation results.

What is the purpose of resetting to origin/main before running a migration script?

Resetting to origin/main provides a clean Fresh/Deno baseline before applying migration changes. This ensures the migration script is tested against a stable state, preventing uncommitted local files from causing false validation errors in the workspace.

How do I test a TypeScript migration script locally before deployment?

You can test a TypeScript migration script locally by executing scripts/migrate.ts with tsx against your target workspace, which validates the migration behavior in a real environment and outputs the results to a MIGRATION_REPORT.md file.

Does this migration workflow require any specific dependencies to run?

The migration workflow requires the tsx tool to execute the local migration script from the Deco-start repository and a target site workspace that can be reset to the origin/main Fresh/Deno state, with no other external dependencies listed.

What limitations should I expect when validating migrations on real sites?

Validation is limited to the local environment as the workflow resets the target site workspace to origin/main and runs the script locally via tsx, meaning it tests migration behavior pre-deployment rather than validating live production environments.

Can I use this workflow to verify Deco-start updates on any Deno project?

You can use this workflow to verify Deco-start updates on any target site workspace that supports a Fresh/Deno state, as it resets the project to origin/main and applies the local migration script to validate changes in that specific environment.