custodian

Audit and repair filesystem-based AI memory systems.

20|4|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/zircote/mnemonic --skill custodian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: custodian
Source: https://github.com/zircote/mnemonic/tree/main/skills/custodian
Command: npx skills add https://github.com/zircote/mnemonic --skill custodian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures the reliability and accuracy of your AI's memory system by performing regular health checks, validating data integrity, and fixing broken links or inconsistencies.

Core Features & Use Cases

  • Memory Auditing: Performs comprehensive checks on memory files, including frontmatter validation, link integrity, and relationship consistency.
  • Link Repair: Automatically fixes broken internal links within the memory system.
  • Decay Management: Updates memory decay scores to ensure relevance.
  • Orphaned Memory Handling: Identifies and optionally links memories that have no incoming references.
  • Use Case: After a major refactor of your project's knowledge base, run the custodian audit --fix command to ensure all internal references are updated and no memories have become orphaned.

Quick Start

Run a full audit of the memory system and fix any detected issues.

Frequently Asked Questions about custodian

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

FAQPage Schema
How do I audit AI memory files for broken links and data consistency?

To validate AI memory system integrity, run an audit that checks frontmatter consistency, verifies internal links, and identifies orphaned memories. This process repairs broken references and updates decay scores to maintain memory health.

How does memory decay management work for filesystem-based AI memory?

Memory decay management updates decay scores within the filesystem-based AI memory system to ensure ongoing relevance. By recalculating these scores, the system identifies outdated memories and maintains the accuracy of the knowledge base.

Can I automatically fix orphaned memories after refactoring a knowledge base?

Yes, you can automatically fix orphaned memories after a knowledge base refactor. The system identifies memories lacking incoming references and optionally re-links them, ensuring all data remains connected and accessible.

What is the best way to maintain AI memory health and repair internal links?

The best way to maintain AI memory health is to perform regular audits that validate file integrity and repair internal links. Executing an automated audit with fix commands resolves broken links and manages decay scores.

Do I need Python to validate memory file integrity and frontmatter?

Yes, Python is required to validate memory file integrity and frontmatter. The system operates using Python modules for parsing, validation, and file operations to ensure data consistency and reliability across the memory system.