Claude-skill-registry-data manage-memories

Memory layer operations for persistent session storage

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry-data

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/manage-memories" ~/.claude/skills/majiayu000-claude-skill-registry-data-manage-memories && rm -rf "$T"

manifest: data/manage-memories/SKILL.md

source content

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