migrating-memory

Export and import memory blocks between agents using a memfs-first workflow.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Kastalien-Research/kastalien-factory --skill migrating-memory-kastalien-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrating-memory
Source: https://github.com/Kastalien-Research/kastalien-factory/tree/main/letta-code/src/skills/builtin/migrating-memory
Command: npx skills add https://github.com/Kastalien-Research/kastalien-factory --skill migrating-memory-kastalien-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrate memory blocks from an existing agent to a new agent, enabling inheritance or sharing of memory across agents, including during /init when setting up a new agent that should inherit memory from an existing one.

Core Features & Use Cases

  • Memfs-first migration workflow: export memfs from the source agent, copy memory into the current agent's memory (system/ for attached blocks, root for detached), and then sync to the API.
  • Legacy fallback (when memfs is disabled): use block-level commands to export and attach memory with appropriate safeguards.
  • Duplicate label handling: rename or override blocks to avoid conflicts, or detach existing blocks before copying.

Quick Start

Ask for the source agent's ID, export their memfs, copy the relevant memory into your memfs, and run memfs sync.

Frequently Asked Questions about migrating-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate memory blocks between agents?

Migrate memory blocks between agents by exporting memfs from the source agent, copying the relevant memory into your memfs, and running memfs sync to finalize the transfer.

What is memory inheritance during agent onboarding?

Memory inheritance during onboarding allows a new agent to share memory from an existing agent by importing exported memory blocks, ensuring continuity across multiple agents.

How does duplicate label handling work when sharing memory across agents?

Duplicate label handling resolves memory conflicts by renaming or overriding blocks to avoid collisions, or detaching existing blocks before copying new ones to maintain consistency.

Can I migrate memory if memfs is disabled?

If memfs is disabled, you can use a legacy fallback with block-level commands to export and attach memory directly, applying appropriate safeguards to maintain consistency.

What is the difference between attached and detached memory blocks during migration?

Attached memory blocks are copied into the system directory, while detached blocks are placed in the root directory, determining how they integrate with the target agent's memory structure.

When should I detach existing blocks before copying memory?

Detach existing blocks before copying when duplicate labels are detected during migration, preventing conflicts and ensuring the imported memory blocks attach cleanly without overriding.