memory-index-sync

Detects and heals mismatches between disk memory files and index.md registry, outputting a Sync Report.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill memory-index-sync-petrsimonidesxart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-index-sync
Source: https://github.com/petrSimonidesXart/xPmGateway/tree/main/.gaai/core/skills/cross/memory-index-sync
Command: npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill memory-index-sync-petrsimonidesxart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Memory drift between on-disk memory files and the central memory index (index.md) can cause stale references and missed content. This Skill identifies unregistered memory files and safely registers them to restore index integrity without creating new knowledge.

Core Features & Use Cases

  • Scan memory on disk and compare with index.md to identify unregistered files.
  • Update memory/index registries and frontmatter counts, while preserving existing knowledge.
  • Produce an inline Sync Report detailing changes and anomalies.
  • Non-destructive: never creates new memory; only registers existing items.

Quick Start

Run the memory-index-sync skill to scan for unregistered memory files on disk and update index.md accordingly.

Frequently Asked Questions about memory-index-sync

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

FAQPage Schema
How do I fix memory index drift when on-disk files are not registered in index.md?

Unregistered memory files occur when artifacts are created outside the normal workflow. A sync scan compares on-disk files against index.md, detects the drift, and registers missing items to restore index integrity without generating new knowledge.

How do I update memory registry counts and frontmatter after creating files outside the normal workflow?

Run a memory index sync to update memory/index registries and frontmatter counts. The process reads on-disk files, re-counts them against index.md, and outputs a Sync Report detailing all applied changes and detected anomalies.

When should I run a memory index sync to ensure registry integrity?

Run a memory index sync as a lightweight post-delivery gate after batches of memory artifacts are created outside the normal workflow. It should also be applied whenever a status report indicates unregistered memory files on disk.

Does memory index sync create new memory artifacts during the repair process?

No, memory index sync is a non-destructive process. It never creates new memory; it only registers existing on-disk files to index.md and updates related summaries to ensure all current content is accurately referenced.

What is the best way to detect unregistered memory files on disk?

The best way to detect unregistered memory files is to perform a sync scan that reads on-disk memory files and compares them against the central memory index. This process identifies drift and safely updates the registry.