# Migrate Nanoclaw

Extracts user customizations from a fork, generates a replayable migration guide, and...

- Repository: https://github.com/nanocoai/nanoclaw (31069 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nanocoai/nanoclaw --skill migrate-nanoclaw -g -a claude-code -y`
Codex: `npx skills add nanocoai/nanoclaw --skill migrate-nanoclaw -g -a codex -y`
Cursor: `npx skills add nanocoai/nanoclaw --skill migrate-nanoclaw -g -a cursor -y`
Gemini CLI: `npx skills add nanocoai/nanoclaw --skill migrate-nanoclaw -g -a gemini-cli -y`

## Description

Extracts user customizations from a fork, generates a replayable migration guide, and upgrades to upstream by reapplying customizations on a clean base. Replaces merge-based upgrades with intent-based migration.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Context

NanoClaw users fork the repo and customize it, changing config values, editing source files, modifying personas, adding skills. When upstream ships updates or refactors, `git merge` produces painful conflicts because the same core files were changed on both sides.

This skill extracts the user's customizations into a migration guide, capturing both the intent (what they want) and the implementation details (how they did it, with code snippets, API calls, and specific configurations). On upgrade, it checks out clean upstream in a worktree, then reapplies customizations using the guide. No merge conflicts because there's nothing to merge.

The migration guide is markdown, not structured data. It needs to capture the full range of what a user might customize, with enough implementation detail that a fresh Claude session can reapply it without having seen the original code. Standard changes (config values, simple logic) can be described briefly. Non-standard changes (specific APIs, custom integrations, unusual patterns) need code snippets and precise instructions.

Two phases: **Extract** (build the migration guide) and **Upgrade** (use it). If a guide already exists, offer to skip to Upgrade.

# Principles

The rest: https://github.com/nanocoai/nanoclaw/blob/HEAD/.claude/skills/migrate-nanoclaw/SKILL.md