memory-reflection

hughescr's avatarfrom hughescr

This skill should be used when the user asks to review, consolidate, organize, or clean up memories. Triggers on requests like "review what you remember," "consolidate my memories," "what patterns do you notice," "organize your memory," "perform memory maintenance," or "clean up old memories." Also use proactively during long sessions to maintain memory hygiene and prevent context overload.

⭐1stars🔀1forks📁View on GitHub🕐Updated Jan 5, 2026⬇️1downloads

When & Why to Use This Skill

The Memory Reflection skill is a specialized utility designed to optimize an agent's long-term memory and context efficiency. It systematically reviews recent interactions to consolidate key learnings, update user profiles, and prune redundant data. By maintaining high-quality memory hygiene, this skill prevents context overload and ensures the agent remains accurately aligned with the user's evolving preferences and goals over time.

Use Cases

  • Memory Maintenance: Periodically cleaning up cluttered or disorganized memory logs during long-running sessions to prevent performance degradation and context window bloat.
  • User Profile Consolidation: Merging scattered observations and recurring patterns about a user's specific habits, preferences, and identity into a unified, actionable knowledge base.
  • Knowledge Synthesis: Analyzing recent conversation history to extract significant insights and promote them to a persistent state layer for future reference.
  • Context Optimization: Archiving outdated or superseded information to reduce noise and minimize the risk of the AI referencing conflicting or irrelevant historical data.
namememory-reflection
version1.0.0
descriptionThis skill should be used when the user asks to review, consolidate, organize, or clean up memories. Triggers on requests like "review what you remember," "consolidate my memories," "what patterns do you notice," "organize your memory," "perform memory maintenance," or "clean up old memories." Also use proactively during long sessions to maintain memory hygiene and prevent context overload.

Memory Reflection Skill

Reflect on recent experiences and consolidate learnings to maintain organized, useful memory.

When to Use

Invoke this skill when:

  • Starting a new day or session
  • Completing significant conversations
  • Noticing cluttered or disorganized memory

Reflection Process

  1. Review Recent Events

    • Call mcp__memory__list on /events/ to retrieve recent activity
    • Identify patterns, recurring topics, or themes
  2. Identify Key Learnings

    • Extract new information discovered
    • Note preferences or patterns that emerged from user interactions
    • Assess what worked well and what did not
  3. Update Identity/State

    • Promote important learnings to /state/ layer
    • Update /identity/ when core understanding has evolved
  4. Consolidate User Knowledge

    • Review /users/{userId}/ entries
    • Merge related observations about each user
  5. Clean Up

    • Remove redundant event entries
    • Archive information that has been consolidated

Output

Summarize after reflection:

  • Key learnings consolidated
  • Memories archived or removed
  • Areas needing more information