migration-analysis

Analyze Sui package migrations for token transitions and object-layout changes.

276|56|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/PlamenTSV/plamen --skill migration-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration-analysis
Source: https://github.com/PlamenTSV/plamen/tree/main/agents/skills/sui/migration-analysis
Command: npx skills add https://github.com/PlamenTSV/plamen --skill migration-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze and quantify the risks of Sui package migrations, including detecting upgrade paths, object-layout changes, deprecated functions, and potential compatibility pitfalls across versions.

Core Features & Use Cases

  • Detect token transitions and object-layout changes across V1 to V2 upgrades.
  • Assess UpgradeCap policy compliance and determine whether upgrades preserve or alter type identities.
  • Trace token flow paths and pre-upgrade inventory to identify stranded assets and recovery options.
  • Provide actionable remediation guidance and migration risk assessments for auditors and engineers.
  • Use Case: Pre-release migration audit to ensure assets can migrate safely when upgrading a Sui package.

Quick Start

Run migration-analysis on a Sui package to assess upgrade readiness and potential stranded assets.

Frequently Asked Questions about migration-analysis

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

FAQPage Schema
How do I analyze Sui package upgrade readiness before migrating?

To analyze Sui package upgrade readiness, assess token transitions, object-layout changes, and UpgradeCap policy compliance between V1 and V2. This identifies compatibility concerns and verifies whether type identities are preserved or altered during the migration.

What are stranded assets in Sui migrations and how can I identify them?

Stranded assets in Sui migrations are tokens or objects left inaccessible after an upgrade. You can identify them by tracing token flow paths and pre-upgrade inventory using Move type information and object ownership data to model recovery options.

How does UpgradeCap lineage affect Sui package compatibility during an upgrade?

UpgradeCap lineage determines the upgrade policy enforced on a Sui package. Analyzing it verifies whether upgrades preserve or alter type identities and ensures the planned migration path complies with the authorized upgrade rules.

Can I detect deprecated functions when upgrading Sui Move packages?

Yes, you can detect deprecated functions when upgrading Sui Move packages by modeling safe upgrade paths across V1 and V2. This analysis quantifies risks by mapping object-layout changes and highlighting deprecated logic.

What is the best way to audit a Sui package migration for security and compatibility risks?

The best way to audit a Sui package migration is to leverage Move type information and object ownership data to quantify risk exposure. This approach outlines compatibility concerns, stranded assets, and remediation guidance for auditors.

Why do Sui package upgrades leave objects stranded and how do I model recovery options?

Sui package upgrades leave objects stranded when object-layout changes break previous ownership data or type identities. You can model recovery options by tracing pre-upgrade inventory and token flow paths against the new V2 package layout.