memory-health

Validate memory artifact counts, indexes, and references via automated tests.

17|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/vasilievyakov/miracle-infrastructure --skill memory-health-vasilievyakov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-health
Source: https://github.com/vasilievyakov/miracle-infrastructure/tree/main/skills/memory-health
Command: npx skills add https://github.com/vasilievyakov/miracle-infrastructure --skill memory-health-vasilievyakov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The memory system is a collection of interconnected markdown files. MEMORY.md references dossiers, dossiers reference observations, observation indexes should match their detail sections, and problem counts should stay in sync. Over time, things drift. You resolve a problem but forget to update the index. You delete a dossier but leave it in the project table. You add observations but the count in MEMORY.md still says "3 entries" when there are 7. /memory-health runs integrity checks across everything and tells you exactly what is broken and how to fix it.

Core Features & Use Cases

  • Automated tests validate memory integrity by cross-checking counts, references, and required sections.
  • Manual checks assess freshness, size, and duplicates to surface actionable cleanups.
  • Reports summarize tests, issues, and suggested fixes to keep memory data consistent.

Quick Start

Run memory-health to perform automated integrity checks and generate a health report.

Frequently Asked Questions about memory-health

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

FAQPage Schema
How do I validate memory data integrity in markdown files?

To validate memory data integrity, run automated tests that cross-check file counts, indexes, and references across interconnected markdown files. This process identifies desyncs and generates a health report detailing exactly what is broken and how to fix it.

Why does my markdown memory system have inconsistent problem counts and missing references?

Inconsistent problem counts and missing references occur because interconnected markdown files drift over time after bulk edits or deletions. Running an integrity health check validates file counts, indexes, and details across all memory artifacts to surface these mismatches.

What's the best way to fix data desync in a markdown-based memory system?

The best way to fix data desync is to execute an integrity check tool that validates file counts, indexes, and details across all memory artifacts. It enforces automated tests and manual checks to produce a final health report with suggested fixes.

When should I run a memory health check on my markdown files?

You should run a memory health check when you suspect data desync, after performing bulk edits, or for periodic maintenance. This ensures that dossier references, observation indexes, and problem counts stay synchronized across your markdown files.

What does a markdown memory integrity test actually validate?

A memory integrity test validates cross-references between markdown files, ensuring dossier references, observation indexes, and problem counts match their detail sections. It also assesses freshness, file size, and duplicates to surface actionable cleanups.