Claude Memory Skill

Memory layer operations for persistent session storage (via file-operations-base skill).

What This Skill Provides

• CRUD operations for memory storage files
• Category-based organization
• Timestamp-based file naming for context files
• Age-based cleanup
• Memory file format validation

When to Activate This Skill

Activate this skill when:

• Persisting session context
• Cleaning up old memory files

---

Memory Categories

Category	Purpose	Typical Lifetime
context	Session context snapshots	Short (days)

---

Workflow: Memory Operations

Pattern: Command Chain Execution

Manage the memory layer for session persistence (via file-operations-base skill).

Parameters

• operation (required): One of save, load, list, query, cleanup
• category (optional): One of context
• identifier (optional): File identifier or summary name
• content (optional): JSON content for save operations

Step 1: Execute Operation

python3 .plan/execute-script.py plan-marshall:manage-memories:{operation} [--category {category}] [--identifier {identifier}] [--content '{content}']

Step 2: Process Result

Parse JSON output and handle accordingly.

Operations Reference

Operation	Description	Required Params
save	Save memory file (creates directories on-the-fly)	category, identifier, content
load	Load memory file	category, identifier
list	List files in category	category (optional)
query	Find files by pattern	pattern
cleanup	Remove old files	--older-than

Example Usage

# Save context snapshot (directories created on-the-fly)
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory save --category context --identifier "feature-auth" --content '{"notes": "Working on auth feature"}'

# Load memory file
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory load --category context --identifier "2025-12-02-feature-auth"

# List context files from last 7 days
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory list --category context --since 7d

# Find files matching pattern
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory query --pattern "auth*" --category context

# Cleanup old context files
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory cleanup --category context --older-than 7d

---

Workflow: Validate Memory File

Pattern: Command Chain Execution

Validate memory file format and structure.

Parameters

• file_path (required): Path to memory file

Step 1: Execute Validation

python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory validate {file_path}

Step 2: Process Result

{
  "success": true,
  "valid": true,
  "checks": [
    {"check": "json_syntax", "passed": true},
    {"check": "required_fields", "passed": true}
  ]
}

---

Memory File Format

All memory files use a metadata envelope:

{
  "meta": {
    "created": "2025-11-25T10:30:00Z",
    "category": "context",
    "summary": "feature-auth",
    "session_id": "optional-session-id"
  },
  "content": {
    // Category-specific content
  }
}

Required Meta Fields

Field	Type	Description
created	string	ISO 8601 timestamp with Z suffix
category	string	One of: context
summary	string	Human-readable identifier

---

Scripts

Script	Notation
manage-memory	plan-marshall:manage-memories
validate-memory	plan-marshall:manage-memories

All scripts:

• Use Python stdlib only (json, argparse, pathlib, datetime)
• Output JSON to stdout
• Exit code 0 for success, 1 for errors
• Support --help flag

---

Integration Points

With json-file-operations Skill

• Uses generic JSON operations for low-level file access

With Scripts Library

• Memory scripts are discovered via scripts-library.toon
• Use portable notation from Scripts table above

With planning Bundle

• Memory operations enable task state persistence
• Cleanup operations maintain memory hygiene

---

References

• references/memory-layer-format.md - Complete memory file format documentation