memory-manager

Detect memory-worthy user preferences and update CLAUDE.md files hierarchically.

3|1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/nsheaps/ai-mktpl --skill memory-manager-nsheaps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-manager
Source: https://github.com/nsheaps/ai-mktpl/tree/main/plugins/memory-manager/skills/memory-manager
Command: npx skills add https://github.com/nsheaps/ai-mktpl --skill memory-manager-nsheaps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically detects and maintains user preferences, instructions, and rules in CLAUDE.md and other rules files. Activates when user says phrases like 'always', 'never', 'don't forget', 'prefer', 'remember to', or 'from now on'. Intelligently determines whether preferences should be stored globally or per-project, organizes memories hierarchically with categories, and confirms updates with 🧠 and 📝 messages.

Core Features & Use Cases

  • Detect Memory-Worthy Statements: Watches for phrases like always, never, don't forget, remember to, or from now on, and classifies them as memories.
  • Scope Determination: Decides global vs project-specific storage (e.g., $HOME/.claude/CLAUDE.md vs project CLAUDE.md) based on context.
  • Hierarchical Organization: Creates categorized memory sections and supports references to external docs via @references for long sections.
  • Safe Updates: Preserves existing CLAUDE.md structure, creates missing files, and confirms updates with clear messages.

Quick Start

Detect memory-worthy statements in user input and update CLAUDE.md with global or project-specific memories.

Frequently Asked Questions about memory-manager

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

FAQPage Schema
How do I save user preferences to CLAUDE.md automatically?

Memory management detects phrases like 'always', 'never', or 'prefer' in your input and updates CLAUDE.md files automatically. It classifies statements as memories and stores them hierarchically with clear confirmation messages.

How does scope determination work for global vs project-specific memories?

Scope determination evaluates the context of your statement to decide whether a memory belongs in a global $HOME/.claude/CLAUDE.md file or a project-specific CLAUDE.md file, ensuring preferences are organized correctly for their intended reach.

What is the best way to organize long rules and instructions in CLAUDE.md?

Organizing long rules hierarchically in CLAUDE.md involves creating categorized memory sections and using @references to link to external documentation. This approach preserves existing file structure while keeping rules easy to review.

Can I preserve existing CLAUDE.md structure when adding new memories?

Yes, adding new memories preserves your existing CLAUDE.md structure. The memory management process validates inputs, creates missing files if necessary, and updates content safely without overwriting your current configuration.

When do I need memory management for my user instructions?

You need memory management when you express preferences using trigger phrases like 'don't forget', 'remember to', or 'from now on'. It captures these instructions and converts them into persistent rules across your files.