Migration Skill

Automate large-scale TypeScript code migrations from forge-labs to HEPHAITOS.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sihu-dev/HEPHAITOS --skill migration-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Migration Skill
Source: https://github.com/sihu-dev/HEPHAITOS/tree/main/.claude/skills/migration
Command: npx skills add https://github.com/sihu-dev/HEPHAITOS --skill migration-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guidance and automation for large-scale code migrations following a nano-factored architecture.

Core Features & Use Cases

  • Nanofactor hierarchy mapping, migration order, and conflict resolution strategies.

Quick Start

Initiate a migration plan for aForge-to-HEPHAITOS codebase.

Frequently Asked Questions about Migration Skill

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

FAQPage Schema
How do I automate large-scale code migrations between TypeScript packages?

Large-scale code migrations automate the transfer of code across multiple packages while preserving functionality. This Skill handles multi-package TypeScript projects by mapping source packages to destinations, updating imports, and applying type system changes across L0–L3 layers, ensuring compilation success and test passage throughout the process.

Can I migrate a forge-labs codebase to use @ioblock/* import aliases?

Yes. This Skill automates import-path corrections by mapping forge-labs sources to HEPHAITOS destinations and rewriting them to @ioblock/* aliases. It applies a conflict-resolution strategy that prioritizes existing HEPHAITOS code while adopting the forge-labs type system.

What's the best way to handle TypeScript type system upgrades during code refactoring?

Code migrations can incorporate type system upgrades by applying transformation rules across packages in a specified order. This Skill guides migrations through defined layers, enforces migration sequencing, and verifies TypeScript compilation and test success to ensure type compatibility throughout the refactor.

Does this migration approach work for multi-package projects with core service rewrites?

Yes. This Skill targets multi-package TypeScript projects and handles scenarios including core-service rewrites, utility refactors, type system upgrades, and agent integration. It generates target package structure, updates all imports, and validates build verification and test passage.

What happens when existing code in the target repository conflicts with migrated code?

Conflict resolution prioritizes existing code in the target repository (HEPHAITOS) while adopting the forge-labs type system. The Skill enforces this strategy automatically during migration, ensuring consistent precedence and reducing manual resolution overhead.