memory
Use this skill when the user asks to save, remember, recall, or organize memories. Triggers on: 'remember this', 'save this', 'note this', 'what did we discuss about...', 'check your notes', 'clean up memories'. Also use proactively when discovering valuable findings worth preserving.
SKILL.md
Full skill instructions
Agent Memory
A persistent memory space for storing knowledge that survives across conversations.
Location: .claude/skills/memory/memories/
Proactive Usage
Save memories when you discover something worth preserving:
- Research findings that took effort to uncover
- Non-obvious patterns or gotchas in the codebase
- Solutions to tricky problems
- Architectural decisions and their rationale
Check memories when starting related work:
- Before investigating a problem area
- When working on a feature you've touched before
Organize memories when needed:
- Consolidate scattered notes on the same topic
- Remove outdated or superseded information
Operations
Save
# Create or update a memory file
echo "content" > .claude/skills/memory/memories/filename.md
Keep it simple. A memory can be as minimal as:
# Problem X Solution
The fix was Y because Z.
Related: `src/path/file.ts:123`
Or more structured when needed:
---
created: 2025-01-15
tags: [performance, worker]
---
# Worker Thread Analysis
## Findings
...
## Recommendations
...
Recall
# List all memories
fd . .claude/skills/memory/memories/ --type f
# Search by content
rg "<query>" .claude/skills/memory/memories/ -g "*.md"
Maintain
- Update memories when information changes
- Delete memories that are no longer relevant
- Consolidate related memories when they grow
Suggested Structure
memories/
├── research/ # Investigation results
├── decisions/ # Architecture choices
├── troubleshooting/ # Problem-solution pairs
└── (any structure that makes sense)
Structure is flexible. Organize as needed.
Guidelines
- Write for your future self: Include enough context to be useful later
- Keep it searchable: Use clear titles and relevant keywords
- Stay current: Update or delete outdated information
- Be practical: Save what's actually useful, not everything
