Memory audit

Skill vergil-project/vergil-claude-plugin/skills/memory-audit

Review memory files collaboratively with the human. Use when the human asks to audit, review, clean up, prune, or check memory ("audit my memory", "review MEMORY.md", "are these memories still accurate", "clean up memory"). Verifies each entry, assesses staleness, and routes it to the correct scope with human approval.From its SKILL.md

Install

npx -y skills add vergil-project/vergil-claude-plugin --skill memory-audit

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.2 KB, as published. Nobody here has run it

Memory Audit

Structured walk-through of a project's memory files. For each file, verify its claims against the codebase, suggest a disposition, and wait for the human to decide before acting.

Workflow

1. Inventory

Read MEMORY.md and list all .md files in the memory directory. Report:

File count and breakdown by type (feedback, project, reference, user, handoff).
Last-modified date for each file.
Orphan files — present in the directory but not indexed in MEMORY.md.
Broken links — entries in MEMORY.md pointing to files that no longer exist.

2. Walk-through

Present each memory file one at a time. For each:

Show: Name, type (from frontmatter), and content. Summarize if the file exceeds ~30 lines.

Verify: Actively check claims against the codebase:

If the memory references a file path, check it exists.
If it references a function, pattern, or convention, grep for it.
If it references a tool or command, check if it is on PATH.

Present verification findings alongside the content.

Assess: Based on verification results, is this entry still accurate?

Suggest disposition with reasoning — one of:

Disposition	When to use
Keep	Still accurate, correctly scoped to this repo.
Update	Substance is right, content needs refreshing.
Relocate → global CLAUDE.md	Cross-repo preference, not repo-specific.
Relocate → plugin/skill issue	About vergil-tooling suite behavior.
Delete	Stale, redundant, or no longer relevant.

3. Human decides

Wait for the human to confirm or override the suggestion. Do not proceed until the human responds. One file at a time — no batching.

4. Execute

After the human decides:

Keep: No change.
Update: Edit the file. Show the diff before and after.
Relocate → global CLAUDE.md: Draft the addition to ~/.claude/CLAUDE.md. Show the draft. Write on approval.
Relocate → plugin/skill issue: Draft the issue body. Show the draft. On approval, create it with vrg-triage-create --kind triage --title … --body-file <tmp> — an unlinked intake issue in the org .github (the tool's default) that triage-review routes to an epic later.
Delete: Remove the file and its index entry from MEMORY.md.

5. Reconcile index

After all files are reviewed:

Update MEMORY.md to reflect the final state (removed entries, newly indexed orphans, etc.).
Ensure the policy header is intact. If missing or outdated, restore it per the memory-init skill's canonical header.

Constraints

One repo per audit. Operates on the current project's memory directory only.
No batch mode. Every disposition requires human confirmation.
Policy header is sacred. Never remove or modify the policy header except to update it to the canonical version.