Agent skill · Databases

migrate-from-v1

Finish migrating a NanoClaw v1 install into v2. Run after `bash migrate-v2.sh` completes. Seeds the owner, migrates legacy memory, reconciles container configs, and helps port custom v1 code. Triggers on "migrate from v1", "finish migration", "v1 migration".

NanoCo30,389★ · +78/wk · 1 repos on radarProfile →
claude-codeMIT
Install
npx skills add nanocoai/nanoclaw --skill migrate-from-v1 --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 11 KB
Bundled scripts: none
Path: .claude/skills/migrate-from-v1/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 30,426 · +37 this week
Language: TypeScript
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Finish v1 → v2 migration `bash migrate-v2.sh` already ran the deterministic migration. It handled: - .env keys merged - v2 DB seeded (agent_groups, messaging_groups, wiring) - Group folders copied (v1 CLAUDE.md → v2 CLAUDE.local.md) - Session data copied with conversation continuity (incl. Claude Code memory + JSONL transcripts) - Scheduled tasks ported - Channel code installed and auth state copied (incl. WhatsApp Baileys keystore) - WhatsApp LIDs resolved from `store/auth` and aliased into `messaging_groups` - Container skills copied - Container image built Your job is the parts that need human judgment: triage failed steps, seed the owner, run the shared-memory migration, reconcile configs, and port fork customizations. Read `logs/setup-migration/handoff.json` first — it has `overall_status`, per-step results in `steps`, and a `followups` list. ## Preflight: was the script run? Before anything else, check that `logs/setup-migration/handoff.json` exists. If it doesn't, the user is invoking this skill before `migrate-v2.sh` ran. Stop and tell them, verbatim: > This skill finishes a migration that `migrate-v2.sh` started. Run that first, in your terminal — not from inside Claude:

What's inside
Steps it walks through
  1. Preflight: was the script run?
  2. Phase 0: Get v2 routing real messages
  3. 0a — Fix blockers only
  4. 0b — Smoke test, then continue
  5. Deferred failures
  6. Phase 1: Owner and access
  7. Access policy
  8. Phase 2: Migrate legacy memory
  9. Phase 3: Container config
  10. Phase 4: Fork customizations
  11. Principles
  12. Setup steps you can run
  13. When done
Commands it runs
bash migrate-v2.sh
cd <v1_path>
git remote -v
git log --oneline <upstream>/main..HEAD 2>/dev/null
pnpm exec tsx setup/index.ts --step <name>
pnpm exec tsx setup/index.ts --step verify
systemctl --user restart "$UNIT"
launchctl kickstart -k "gui/$(id -u)/$LABEL"
More from nanoclaw
All skills →
About this skill
What does the migrate-from-v1 skill do?

Finish migrating a NanoClaw v1 install into v2. Run after `bash migrate-v2.sh` completes. Seeds the owner, migrates legacy memory, reconciles container configs, and helps port custom v1 code. Triggers on "migrate from v1", "finish migration", "v1 migration".

How do I install it?

Run `npx skills add nanocoai/nanoclaw --skill migrate-from-v1 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From nanocoai/nanoclaw, a repository with 30,426 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going