naman10parikh/agentgrid / .claude/skills/memory
memory
VerifiedSearch, store, compress, and recall memories across the Energy platform. Semantic search over LEARNINGS.md, daily logs, vault notes, and rules.
/memory — Energy Memory System
Unified memory interface for the Energy platform. Search across all memory surfaces, store persistent facts, compress old entries, and recall context.
Commands
/memory search "query"
Search across all memory surfaces with relevance scoring.
Steps:
- Run
bash scripts/memory-search.sh "query" --limit 5 - Parse results: file path + line number + surrounding context
- Present top 5 results ranked by: term frequency x recency x source weight
- If no results, try broader search terms
Sources searched: memory/LEARNINGS.md, memory/daily/.md, memory/topics/.md, vault/.md, .claude/rules/.md
/memory store "key" "value"
Store a persistent fact via MCP memory server.
Steps:
- Use the
memoryMCP tool:create_entitieswith entity type based on content - For maintainer directives: entity type = "directive"
- For technical patterns: entity type = "pattern"
- For project state: entity type = "project"
- Confirm storage with entity name
/memory compress
Compress LEARNINGS.md by archiving old entries.
Steps:
- Run
bash scripts/memory-compress.sh(if exists) - Or manually: read LEARNINGS.md, identify entries older than 30 days
- Move old entries to
memory/archive/learnings-YYYY-MM.md - Keep recent 30 days in LEARNINGS.md
- Add compressed index header with category counts
- Report: lines before, lines after, entries archived
/memory recall "topic"
Recall everything known about a topic across all surfaces.
Steps:
- Search memory surfaces (same as
/memory search) - Also search: .claude/auto-memory files, vault notes, maintainer prompts
- Check MCP memory server for stored entities matching topic
- Combine and deduplicate results
- Present as structured brief: what we know, when we learned it, confidence level
Architecture (4 Layers)
Layer 0: MARKDOWN FILES (source of truth — always works)
memory/LEARNINGS.md, memory/daily/, memory/topics/, vault/
Layer 1: SEARCH INDEX (scripts/memory-search.sh)
BM25-style term frequency search with recency weighting
Searches: LEARNINGS, daily, topics, vault, rules
Layer 2: MCP MEMORY SERVERS (persistent K-V + knowledge graph)
@modelcontextprotocol/server-memory — entity-relation graph
mixgram — document semantic search over memory/ directory
Layer 3: FLEET MEMORY (future — Mem0/Graphiti when agent fleet grows)
Agent-to-agent knowledge propagation
Temporal validity tracking
Key Principle
Layer 0 is ALWAYS the source of truth. Upper layers are indexes and caches that can be rebuilt from Layer 0 at any time. If any MCP server fails, grep still works.
When to Use This Skill
- "What do we know about X?" →
/memory recall "X" - "Find that learning about compaction" →
/memory search "compaction" - "Remember this pattern for future sessions" →
/memory store - "LEARNINGS.md is too long" →
/memory compress - At session start: search for context relevant to current task
- Before compaction: store critical facts via MCP for cross-session persistence
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |