Back to Skills

initializing-memory

Comprehensive guide for initializing or reorganizing agent memory. Load this skill when running /init, when the user asks you to set up your memory, or when you need guidance on creating effective memory blocks.

1,014stars129forksUpdated 2/10/2026

Security Assessment

Safe(100/100)
Security Score100/100

About initializing-memory

The 'initializing-memory' skill is designed to assist in initializing or reorganizing an agent's memory. It provides a systematic way to create, edit, and manage memory blocks that help agents maintain focused and organized information. This skill ensures that the agent's memory structure is both comprehensive and hierarchical, making it easier for the agent to manage vast amounts of data efficiently. The process involves creating 15-25 small, focused memory blocks that are deeply nested in a directory structure, rather than relying on a single or flat file. The memory initialization is critical when the user requests the setup of the agent's memory or when the agent needs guidance on creating effective memory blocks, especially when running the '/init' command. It streamlines the way memory is structured and accessed, ensuring clarity and simplicity for the agent's operation.

FAQ

How should the memory blocks be structured?

Memory blocks should be organized into 15-25 small files, with a maximum of 40 lines per file. The files must follow a hierarchical structure, with 2-3 levels of nested directories using '/' for naming.

What are the anti-patterns to avoid while initializing memory?

Avoid creating too few large files, flat naming, mega-blocks with too many sections, or a single-level hierarchy. Instead, ensure that every new file is nested under a parent using '/' and that files are kept small and focused.

What happens if the memory filesystem feature is enabled?

When the memory filesystem feature is enabled, memory blocks are stored as .md files in a directory hierarchy. Bash commands like 'ls', 'mkdir', and 'mv' can be used to manage these files. This setup requires adherence to the hierarchical structure with 2-3 levels of nesting.

Can I have a flat file structure for memory blocks?

No, a flat file structure is not acceptable. You must create a hierarchical structure with 2-3 levels of directories and subdirectories to ensure a clear and organized memory system.

What should I do if a file exceeds 40 lines?

If a file exceeds 40 lines, it should be split into smaller files to maintain the focus of each block. Keep each file concise and within the target size.

Install initializing-memory

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill