Motoko Enhanced Migration

Name: Motoko Enhanced Migration
Rating: 91 (1 reviews)
Author: dfinity

Trust Score 91/100

Guidance and examples for multi-step Motoko canister state migrations using a migrations/ directory and the --enhanced-migration flow.

triggers:motokomigrationcanistermopsstatemigrations directoryenhanced-migration

GitHub SKILL.md

What it does

Documents an enhanced migration workflow for Motoko canisters: how to write ordered migration modules, compose migration chains, and evolve persistent actor state safely across deployments. Includes patterns for adding/renaming/removing fields, type changes, and mapping collections.

When to use it

Use when your Motoko project requires structured, repeatable state migrations across upgrades — especially for projects using mops and wanting compiler-verified migration chains rather than ad-hoc preupgrade/postupgrade code.

What's included

Scripts: none, but many code examples (Motoko modules) demonstrating Init, AddField, Rename, Transform, and Map patterns.
References: notes on mops.toml setup, compatibility constraints, and common pitfalls.
Instructions: stepwise rules (no stable keyword, timestamped filenames, lexicographic ordering) and a checklist for safe migrations.

Compatible agents

Useful to developer-focused agents that can read/write code and manage repos (Codex/GitHub Copilot-style agents), and agents that advise on blockchain/canister deployments.

Audit Summary

Well-crafted reference skill for Dfinity's Motoko enhanced canister state migrations. The SKILL.md is thorough with clear patterns (add/rename/remove/transform fields), lifecycle examples, and a practical checklist. No scripts bundled — purely instructional content targeting ICP developers using mops and --enhanced-migration. Niche audience limits breadth of usefulness.

Watch Out

Requires moc >= 1.7.0 and core >= 2.5.0
Only applies to Motoko canisters on the Internet Computer
Cannot combine with inline (with migration = ...) syntax

Notes

Clean, documentation-only skill from the official dfinity/icskills repo. No security concerns — no scripts, no network calls, no credential handling. Minor deduct: no explicit version pinning or changelog. Architecture follows the skill spec well with proper frontmatter and progressive disclosure. Usefulness is niche — only relevant to ICP/Motoko developers doing multi-step migrations.

Information

Repository: icskills
Stars: 22

Trust Score

Overall91

Security97

Code Quality88

Architecture82

Usefulness52

Related Skills

Sync Production Database to Development

Run a safe, scripted workflow to download production database dumps and restore them into a development environment (download-only and restore options).

Navan Migration — Deep Dive

End-to-end migration playbook for moving from SAP Concur or legacy TMC to Navan: data export, user provisioning (SCIM/CSV), policy recreation, parallel running

FastAPI Project Templates

Creates production-ready FastAPI project scaffolds with async patterns, DI, middleware, and testing best practices for high-performance APIs.

GraphQL Inspector — Validate

Validate GraphQL operations against a schema with configurable depth, complexity, alias and directive limits to catch errors before runtime.

JJ Hunk

Programmatic hunk selection for Jujutsu (jj): list, split, commit, or squash specific hunks to enable partial commits and fine-grained history editing without a

Codex Collab

Bridge Claude and Codex to run tasks, perform code reviews, and run background jobs for research or implementation workflows.

Cursor Hello World Tutorial

A concise 10-minute hands-on tutorial demonstrating Cursor's Tab completion, Chat, Inline Edit, and Composer features for getting started quickly.

Code Spec Backfill

Identify missing function-level contracts and backfill docstrings and type annotations; report ambiguous gaps with misuse scenarios. Incremental, state-driven w

Back to Skills