migrate-nanoclaw

Extracts fork customizations into a migration guide and reapplies them onto clean upstream.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Upgrading a customized NanoClaw fork with git merge produces painful conflicts because the same core files were changed on both sides. This Skill replaces merge-based upgrades with intent-based migration: it captures what you customized and why, then reapplies those changes on a clean upstream checkout. ## Core Features & Use Cases - Customization Extraction: Spawns sub-agents to diff your fork against the upstream merge-base, identifies applied skills and manual changes, and writes a structured migration guide to .nanoclaw-migrations/ with code snippets where needed. - Worktree-Based Upgrade: Checks out clean upstream in a git worktree, reapplies skills and customizations from the guide, validates with build and tests, then swaps the result into the main tree. - Safety Mechanisms: Creates backup branches and tags before touching anything, refuses to run on a dirty working tree, warns about changes made since the guide was generated, and never touches data directories like groups/, store/, or .env. - Use Case: You forked NanoClaw, changed the assistant name, added a DeepL translation step in the router, and applied the Telegram skill. When upstream ships a refactor, run this Skill to regenerate your exact setup on the new version without resolving a single merge conflict. ## Quick Start Ask the assistant to migrate my NanoClaw fork to the latest upstream version using the migrate-nanoclaw skill.

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 repository without merge conflicts?

Extract your customizations into a migration guide that records intent and implementation details, then check out clean upstream in a git worktree and reapply each change from the guide. This avoids merging entirely because there is nothing to merge.

How do I migrate NanoClaw to the latest upstream version?

Run the migrate-nanoclaw skill, which fetches upstream, analyzes your fork's divergence with sub-agents, writes a migration guide, reapplies skills and customizations in a worktree, validates the build, and swaps the result into your main tree.

Does the migration touch my data directories or environment files?

No. Data directories such as groups/, store/, data/, and .env are never modified; only code is migrated. For optional live testing, the worktree symlinks to your existing data and the symlinks are removed afterward.

What happens if the upgrade fails or breaks my install?

The skill creates a backup branch and tag before making any changes, so you can roll back with git reset --hard <backup-tag>. Validation builds and tests run in an isolated worktree before anything touches your live install.

When should I use a simple merge-based update instead of full migration?

For small divergences, such as fewer than five upstream commits and fewer than three changed files, the skill itself suggests the lighter merge-based update path. Full migration is suited to forks with deep source changes or multiple applied skills.