Skip to content
Get packs

Migrate legacy memory

Moves old NanoClaw and Claude memory files into the shared memory layout safely

Source Download skill
Repository
nanocoai/nanoclaw
Stars
31,072
Licence
MIT
Files
1 file

What it does

This skill helps an AI coding agent move older memory and standing instructions from the NanoClaw chat-agent setup into a new shared memory folder that works across different AI providers. It follows a careful sequence: it pauses scheduled tasks and stops the group's container, moves legacy files without reading their contents, quarantines symlinks without following them, and only then has the agent read and organize the moved files, asking the operator for approval at key points.

Great for

  • NanoClaw operators who see the shared-memory breaking change after an update
  • Teams switching a NanoClaw group between AI providers and finding the agent has lost its memory
  • Operators who want an auditable, reversible migration with explicit approval steps

Skip it if

  • Users who have never run NanoClaw, since it only applies to its group folder layout and commands like ncl, because it will not make sense outside that setup
  • Anyone wanting to migrate memory without reviewing file moves, since the skill asks for approval and records each rename so it can be reversed, and skipping that review could misplace or lose context
  • Groups with unusual file types or active conversations, since the skill stops the group for operator review and pauses scheduled tasks, which interrupts service during the window

Try asking

  • “Migrate legacy memory after the update reports the shared-memory breaking change”
  • “The agent forgot everything after the switch, so migrate legacy memory for group folder main”
  • “Check whether a group still has .seed.md or CLAUDE.local.md files and move them into the shared memory tree”
  • “Index the imported-agent-memory.md file for this group”
Step-by-step guide: how to use Migrate legacy memoryInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    migrate-memory.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip migrate-memory.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

  • Review the list of planned renames and symlink warnings before approving, since moves are only reversible if you keep the recorded mapping
  • Expect scheduled tasks to be paused during the window and resume them yourself afterward, because the skill does not resume tasks that were paused before it started
  • Tell group users not to message during migration, since messages are held while the container is stopped

What's inside

  • 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.