memory-audit

Consolidate and prune project memory files with guided delete, merge, and promote actions.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/dgowrie/claude-workflows --skill memory-audit-dgowrie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-audit
Source: https://github.com/dgowrie/claude-workflows/tree/main/skills/memory-audit
Command: npx skills add https://github.com/dgowrie/claude-workflows --skill memory-audit-dgowrie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review, consolidate, and prune a project's memory files. Merges duplicates, sharpens durable entries, retires dated ones, fixes relative time references, flags oversized files, surfaces promotion candidates for global CLAUDE.md, and tidies the MEMORY.md index. Defaults to the current project; offers a cross-project sweep after the main report.

Core Features & Use Cases

  • Consolidates duplicate memories across a project to reduce noise.
  • Prunes dated or irrelevant memories and surfaces durable takeaways for long-term reuse.
  • Flags oversized memory files for review and potential relocation to plans or global docs.
  • Provides a cross-project sweep to identify promotion candidates for global CLAUDE.md.
  • Tidies and aligns the MEMORY.md index to improve re-findability and loading performance.

Quick Start

Audit the current project's MEMORY.md and memory files to consolidate duplicates, prune dated entries, and surface promotion candidates.

Frequently Asked Questions about memory-audit

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

FAQPage Schema
How do I clean up and consolidate duplicate memory files in my project?

To consolidate duplicate memory files, this audit merges redundant entries, prunes dated or irrelevant memories, and sharpens durable takeaways for long-term reuse. It applies staleness, size, and duplicate rules to tidy your project's MEMORY.md index.

What is the best way to prune stale entries and fix relative time references in project memory?

The best way to prune stale entries and fix relative time references is to run a memory audit enforcing staleness and time reference rules. It retires dated memories and provides guided actions to delete, resize, drop, or merge flagged files.

Can I identify memories to promote to a global CLAUDE.md file across multiple projects?

Yes, you can identify promotion candidates for a global CLAUDE.md file by running a cross-project sweep. After auditing the current project, the sweep surfaces organization improvements and durable entries suitable for global reuse.

How do I flag and relocate oversized memory files that bloat my project?

To flag and relocate oversized memory files, the audit checks file sizes against enforced rules and flags them for review. It provides guided actions to resize or relocate bloated files to plans or global docs, improving loading performance and re-findability.

When should I not use an automated memory file cleanup workflow?

You should avoid an automated memory file cleanup workflow when your project lacks an established MEMORY.md index or memory files to audit. The workflow targets existing projects needing cross-project sweeps, staleness enforcement, and duplicate consolidation.