Memory Status Skill | Agent Skills

Memory Status

Display the current state of the Engram memory system.

When to Use

Use when:

The user asks about the memory system status
The user wants to know what's been remembered
Diagnostics are needed (missing files, empty preferences, etc.)
The user asks "what do you know about me?"

Workflow

1. Read Configuration

Read .claude/memory-settings.json for:

Preset type
File names
Language
Search mode

If the file is missing, tell the user to run memory-init first.

2. Inspect Memory Files

For each of the three memory files, gather:

File exists? (yes/no)
File size (approximate line count)
Last modified date (via stat or ls -l)
Number of entries:
- Preferences: count of filled (non-empty) fields
- Conversations: count of ### YYYY-MM-DD entries
- Long-term: count of - YYYY-MM-DD: entries

3. Check CLAUDE.md Integration

Verify that CLAUDE.md contains  /  markers and an @{PREFS_FILE} reference. This is what auto-loads preferences each session.

4. Display Status Report

Format:

Engram Memory System Status
═══════════════════════════

Configuration:
  Preset:      <preset>
  Language:    <language>
  Search mode: <strong|weak>

Memory Files:
  <preferences-file>
    Status:   <exists/missing>
    Size:     <lines> lines
    Modified: <date>
    Fields:   <filled>/<total> filled

  <conversations-file>
    Status:   <exists/missing>
    Size:     <lines> lines
    Modified: <date>
    Entries:  <count> conversations

  <longterm-file>
    Status:   <exists/missing>
    Size:     <lines> lines
    Modified: <date>
    Entries:  <count> memories

CLAUDE.md Integration:
  ENGRAM section: <present/missing>
  @-reference:    <present/missing>

Recent Conversations (last 3):
  - YYYY-MM-DD HH:MM - Topic
  - YYYY-MM-DD HH:MM - Topic
  - YYYY-MM-DD HH:MM - Topic

Health Check:
  ✓ All files present
  ✓ Preferences populated
  ✓ CLAUDE.md integration active
  ✗ No conversation summaries yet

5. Health Check Items

Check for:

Missing memory files → warn and offer to recreate via memory-init
Empty preferences file → suggest filling in
No conversation summaries → note that this is normal for new setups
Missing settings file → offer to run memory-init
Missing CLAUDE.md ENGRAM section → preferences won't auto-load; offer to re-run memory-init to restore

Agent Skills: Memory Status

Install this agent skill to your local

Skill Files