Skip to content
Get packs

NanoClaw Migration Assistant

Moves a customized NanoClaw fork onto new upstream code by replaying your changes, not merging them

Source Download skill
Repository
nanocoai/nanoclaw
Stars
31,072
Licence
MIT
Files
2 files

What it does

This skill helps an AI agent upgrade a forked copy of the NanoClaw project. It first catalogs your customizations (config changes, edited source files, persona edits, added skills) into a markdown migration guide. When upstream releases updates, the agent checks out clean upstream code in a separate worktree and reapplies your changes from that guide, instead of running git merge and fighting conflicts. It is designed to back up your state first and to leave data folders like groups/, store/, data/ and .env untouched.

Great for

  • Developers who maintain a heavily customized fork of NanoClaw and find git merge upgrades painful
  • Teams that want a written, replayable record of why each local change was made

Skip it if

  • Small forks with only a few changes: the skill itself suggests the lighter /update-nanoclaw approach, since the full process adds overhead
  • Anyone without a git-based fork of NanoClaw, because the workflow assumes an upstream remote, branches, and a working tree
  • Unattended use on a live production install without review, since it creates branches, tags, stashes or commits, and may stop services

Try asking

  • “Migrate my NanoClaw fork to the latest upstream without merge conflicts”
  • “Extract my customizations into a migration guide so I can upgrade later”
  • “Skip to the upgrade step because my migration guide is already current”
  • “Check how much my fork diverges from upstream and recommend a migration path”
Step-by-step guide: how to use NanoClaw Migration AssistantInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    migrate-nanoclaw.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip migrate-nanoclaw.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip migrate-nanoclaw.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Commit or stash your work before starting, since the skill checks for a clean tree and creates rollback branches and tags
  • Keep the generated migration guide in version control so future upgrades can reuse it
  • Review the migration guide and the upstream diff yourself before accepting the upgraded worktree into your live install

What's inside

  • diagnostics.md
  • SKILL.md

Redistributed unmodified from nanocoai/nanoclaw under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.