migrate-nanoclaw

Extract fork customizations into a migration guide and replay them on upstream.

Updated May 7, 2026
One-click install
npx skills add https://github.com/Bartunek/nanoclaw --skill migrate-nanoclaw-bartunek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-nanoclaw
Source: https://github.com/Bartunek/nanoclaw/tree/main/.claude/skills/migrate-nanoclaw
Command: npx skills add https://github.com/Bartunek/nanoclaw --skill migrate-nanoclaw-bartunek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill extracts user customizations from a fork and generates a migration guide, enabling upgrades to upstream by reapplying custom changes on a clean base to avoid painful merge conflicts.

Core Features & Use Cases

  • Extracts fork-specific customizations into a migration guide containing intent and implementation details, allowing deterministic upgrades.
  • Replays customizations on a clean upstream worktree to produce a reproducible upgrade path and safe rollback.
  • Supports two phases (Extract and Upgrade) and uses sub-agents to analyze code changes, ensuring accurate and safe migrations.

Quick Start

Run the migrate-nanoclaw skill to generate a migration guide and upgrade to upstream with your personalized customizations.

Frequently Asked Questions about migrate-nanoclaw

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

FAQPage Schema
How do I upgrade a forked repo to upstream without merge conflicts?

To upgrade a fork without merge conflicts, extract customizations into a migration guide and replay them on a clean upstream worktree. This deterministic approach re-applies your changes onto a fresh base, ensuring a reproducible upgrade path.

What is an intent-based migration guide for code forks?

An intent-based migration guide extracts fork-specific customizations, capturing both implementation details and the original intent behind changes. Sub-agents analyze code edits and persona tweaks to produce per-file instructions for deterministic upgrades.

Can I rollback an upstream upgrade if my customizations break?

Yes, replaying customizations on a clean upstream worktree provides safe rollback. Because the upgrade path is reproducible and uses an isolated worktree, you can safely revert to your previous fork state if applied changes fail.

Does this migration tool support config changes and persona tweaks?

Yes, the migration process supports NanoClaw forks with config changes, code edits, and persona tweaks. It uses sub-agents to analyze these customizations and generates a reproducible guide with per-file instructions for each modification.

What are the phases of migrating a fork to upstream?

The migration process specifies a two-phase workflow: Extract and Upgrade. The Extract phase analyzes your fork to generate a migration guide, and the Upgrade phase replays those customizations on a clean upstream worktree.