memory-index-sync

Detect and resolve drift between index.md and files on disk.

157|28|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/Fr-e-d/GAAI-framework --skill memory-index-sync-fr-e-d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-index-sync
Source: https://github.com/Fr-e-d/GAAI-framework/tree/main/.gaai/core/skills/cross/memory-index-sync
Command: npx skills add https://github.com/Fr-e-d/GAAI-framework --skill memory-index-sync-fr-e-d

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill ensures that your AI's memory index (index.md) accurately reflects the actual files present on disk, preventing data inconsistencies and ensuring reliable memory access.

Core Features & Use Cases

  • Detects Drift: Identifies files in memory directories that are not registered in index.md.
  • Registers Missing Files: Adds unregistered files to the index.md registry.
  • Flags Anomalies: Reports inconsistencies like registered entries with missing files or unregistered files on disk.
  • Use Case: After a batch of memory files were created outside the standard process, run this skill to automatically update the index.md and confirm all memory is accounted for.

Quick Start

Run the memory-index-sync skill to ensure the memory index is up-to-date.

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 files are missing from the registry?

To fix memory index drift, you can run a sync operation to compare the index.md file against actual files on disk, automatically registering missing files and flagging anomalies like orphaned summaries to ensure data integrity.

What causes unregistered files in AI memory directories?

Unregistered files in AI memory directories occur when memory files are created or modified outside the standard process, causing a drift between the actual files on disk and the index.md registry that tracks them.

How do I sync index.md with actual files on disk?

You sync index.md with actual files on disk by running a detection script that identifies unregistered files, adds them to the registry, and flags missing files or orphaned summaries to restore memory index integrity.

When should I run a memory index integrity check?

You should run a memory index integrity check after creating a batch of memory files outside the standard process, ensuring all new data is registered in index.md and no orphaned summaries or missing entries exist.

Does memory index sync require any external dependencies?

No, memory index sync requires no external dependencies, operating entirely through internal scripts and references to detect drift, register files, and flag anomalies within your memory directories.

What anomalies does memory drift detection flag?

Memory drift detection flags anomalies such as registered entries pointing to missing files on disk and unregistered files on disk that have no corresponding entry in the index.md registry.