memory-inspect

Scan .claude/agent-memory to report per-agent stats and stale files.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/fjpulidop/specrails-core --skill memory-inspect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-inspect
Source: https://github.com/fjpulidop/specrails-core/tree/main/specrails-plugin/skills/memory-inspect
Command: npx skills add https://github.com/fjpulidop/specrails-core --skill memory-inspect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inspect and manage agent memory directories to keep the sr-* memories tidy, surface stale or orphaned files, and provide actionable cleanup guidance.

Core Features & Use Cases

  • List all sr-* agent memory stores under .claude/agent-memory and show per-agent stats (file count, total size, last modified).
  • Display 5 most recent entries per agent and highlight stale/orphaned files for cleanup.
  • Generate pruning guidance and recommended actions to maintain memory hygiene in ongoing pipelines.

Quick Start

Run /specrails:memory-inspect to audit all sr-* agent memory directories and surface actionable cleanup recommendations.

Frequently Asked Questions about memory-inspect

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

FAQPage Schema
How do I audit agent memory stores for stale or orphaned files?

Auditing agent memory stores involves scanning the .claude/agent-memory directory to compute per-agent stats, list recent entries, detect stale or orphaned files, and generate actionable pruning recommendations. This Skill automates that entire discovery and reporting process.

How do I clean up sr-* agent memory directories in ongoing pipelines?

Cleaning up sr-* agent memory directories requires computing per-agent file counts, total sizes, and last modified dates, then optionally pruning stale files. This Skill provides structured output and recommended actions to maintain memory hygiene across pipelines.

What is agent memory hygiene and when do I need to prune memory files?

Agent memory hygiene is the practice of inspecting and managing memory stores to remove stale or orphaned files that accumulate over time. You need to prune memory files when agent memory directories grow unbounded or pipeline performance degrades.

Can I use memory-inspect to check agent memory usage across multiple sr-* agents?

Yes, you can check agent memory usage across multiple sr-* agents. The Skill discovers all agent memories under .claude/agent-memory, computes per-agent stats, and displays the five most recent entries per agent to surface usage patterns.

Does memory-inspect work without any external dependencies or components?

Yes, memory-inspect works without external dependencies or components. It operates directly on the .claude/agent-memory directory structure, enforcing runtime parsing rules and discovery mechanisms internally to generate cleanup guidance.

What are the limitations of automated memory pruning for agent memory stores?

Automated memory pruning is limited to detecting stale and orphaned files based on parsing rules and modification dates. The Skill provides pruning guidance and recommended actions, but users must evaluate structured output before executing irreversible file deletions.