agent-memory-hygiene

Refactor MEMORY.md by migrating operational content to TOOLS.md and creating Obsidian extracts.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/ramirlm/skillshare-ramir --skill agent-memory-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-memory-hygiene
Source: https://github.com/ramirlm/skillshare-ramir/tree/main/agent-memory-hygiene
Command: npx skills add https://github.com/ramirlm/skillshare-ramir --skill agent-memory-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines agent memory management by separating durable rules from operational runbooks and standardizing documentation across agents.

Core Features & Use Cases

  • Memory Refactoring: Moves operational content (runbooks, commands) from MEMORY.md to TOOLS.md.
  • Content Enrichment: Adds metadata and structures TODO items for better tracking.
  • Obsidian Integration: Dumps migrated content into Obsidian for human reference.
  • Ontology Update: Creates/updates entities in the Ontology for agents and documents.
  • Use Case: Automatically clean up and organize the documentation for multiple AI agents, ensuring that critical rules are preserved while operational details are easily accessible in a dedicated tools file and searchable in Obsidian.

Quick Start

Run the agent-memory-hygiene skill to refactor the memory of all agents.

Frequently Asked Questions about agent-memory-hygiene

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

FAQPage Schema
How do I separate operational runbooks from durable rules in agent memory files?

Agent memory refactoring separates durable rules from operational runbooks by migrating command details from MEMORY.md into a dedicated TOOLS.md file. This ensures critical behavioral rules remain preserved while operational instructions become independently accessible.

What is the best way to track TODO items and metadata in an agent ontology?

Normalizing ontology entries structures TODO items and extracts metadata from agent memory files. This process updates the ontology with standardized status tracking for TODOs and enriches document entities to improve searchability and lifecycle management.

Does agent memory refactoring work with Obsidian for human-readable documentation?

Yes, agent memory refactoring integrates with Obsidian by generating extracts from migrated operational content. This creates a searchable, human-readable reference layer for agent tools and runbooks outside the core memory files.

Do I need Python 3 and specific agent directories to refactor agent memory files?

Yes, refactoring agent memory requires Python 3 installed and specific agent directories already present in your environment. These prerequisites enable the scripts to locate, parse, and migrate content between MEMORY.md, TOOLS.md, and the Ontology.

What happens to operational content when cleaning up documentation for multiple AI agents?

Operational content is automatically moved from MEMORY.md to TOOLS.md when cleaning up documentation for multiple AI agents. The process preserves critical rules in memory while organizing commands and runbooks into dedicated tool files and Obsidian extracts.