Back to Skills

Status

Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations.

$ npx promptcreek add status

Auto-detects your installed agents and installs the skill to each one.

What This Skill Does

This skill provides a memory health dashboard for a project, offering a quick overview of the memory state across different memory systems. It reports on the number of lines in memory files, topic files, and identifies stale entries. It's helpful for developers to monitor and maintain the health of their project's memory.

When to Use

  • Check overall memory health.
  • Identify stale file references.
  • Monitor memory capacity.
  • Detect duplicate entries.
  • Get a brief memory summary.
  • Troubleshoot memory issues.

Key Features

Locates and analyzes memory files.
Reports on memory capacity.
Checks for stale file references.
Provides a health assessment.
Offers recommendations for improvement.
Includes a brief mode for quick summaries.

Installation

Run in your project directory:
$ npx promptcreek add status

Auto-detects your installed agents (Claude Code, Cursor, Codex, etc.) and installs the skill to each one.

View Full Skill Content

/si:status — Memory Health Dashboard

Quick overview of your project's memory state across all memory systems.

Usage

/si:status                    # Full dashboard

/si:status --brief # One-line summary

What It Reports

Step 1: Locate all memory files

# Auto-memory directory

MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"

Count lines in MEMORY.md

wc -l "$MEMORY_DIR/MEMORY.md" 2>/dev/null || echo "0"

List topic files

ls "$MEMORY_DIR/"*.md 2>/dev/null | grep -v MEMORY.md

CLAUDE.md

wc -l ./CLAUDE.md 2>/dev/null || echo "0"

wc -l ~/.claude/CLAUDE.md 2>/dev/null || echo "0"

Rules directory

ls .claude/rules/*.md 2>/dev/null | wc -l

Step 2: Analyze capacity

| Metric | Healthy | Warning | Critical |

|--------|---------|---------|----------|

| MEMORY.md lines | < 120 | 120-180 | > 180 |

| CLAUDE.md lines | < 150 | 150-200 | > 200 |

| Topic files | 0-3 | 4-6 | > 6 |

| Stale entries | 0 | 1-3 | > 3 |

Step 3: Quick stale check

For each MEMORY.md entry that references a file path:

# Verify referenced files still exist

grep -oE '[a-zA-Z0-9_/.-]+\.(ts|js|py|md|json|yaml|yml)' "$MEMORY_DIR/MEMORY.md" | while read f; do

[ ! -f "$f" ] && echo "STALE: $f"

done

Step 4: Output

📊 Memory Status

Auto-Memory (MEMORY.md):

Lines: {{n}}/200 ({{bar}}) {{emoji}}

Topic files: {{count}} ({{names}})

Last updated: {{date}}

Project Rules:

CLAUDE.md: {{n}} lines

Rules: {{count}} files in .claude/rules/

User global: {{n}} lines (~/.claude/CLAUDE.md)

Health:

Capacity: {{healthy/warning/critical}}

Stale refs: {{count}} (files no longer exist)

Duplicates: {{count}} (entries repeated across files)

{{if recommendations}}

💡 Recommendations:

- {{recommendation}}

{{endif}}

Brief mode

/si:status --brief

Output: 📊 Memory: {{n}}/200 lines | {{count}} rules | {{status_emoji}} {{status_word}}

Interpretation

  • Green (< 60%): Plenty of room. Auto-memory is working well.
  • Yellow (60-90%): Getting full. Consider running /si:review to promote or clean up.
  • Red (> 90%): Near capacity. Auto-memory may start dropping older entries. Run /si:review now.

Tips

  • Run /si:status --brief as a quick check anytime
  • If capacity is yellow+, run /si:review to identify promotion candidates
  • Stale entries waste space — delete references to files that no longer exist
  • Topic files are fine — Claude creates them to keep MEMORY.md under 200 lines
0Installs
0Views

Supported Agents

Claude CodeCursorCodexGemini CLIAiderWindsurfOpenClaw

Details

License
MIT
Source
seeded
Published
3/17/2026

Related Skills