memory/MEMORY.md — Long-term facts (preferences, project context, relationships). Always loaded into your context.
memory/HISTORY.md — Append-only event log. NOT loaded into context. Search it with grep. Each entry starts with [YYYY-MM-DD HH:MM].
Search Past Events
grep -i "keyword" memory/HISTORY.md
Use the exec tool to run grep. Combine patterns: grep -iE "meeting|deadline" memory/HISTORY.md
When to Update MEMORY.md
Write important facts immediately using edit_file or write_file:
User preferences ("I prefer dark mode")
Project context ("The API uses OAuth2")
Relationships ("Alice is the project lead")
Auto-consolidation
Old conversations are automatically summarized and appended to HISTORY.md when the session grows large. Long-term facts are extracted to MEMORY.md. You don't need to manage this.
1---2name: memory3description: Two-layer memory system with grep-based recall.4---56# Memory78## Structure910- `memory/MEMORY.md` — Long-term facts (preferences, project context, relationships). Always loaded into your context.11- `memory/HISTORY.md` — Append-only event log. NOT loaded into context. Search it with grep. Each entry starts with [YYYY-MM-DD HH:MM].1213## Search Past Events1415```bash16grep -i "keyword" memory/HISTORY.md17```1819Use the `exec` tool to run grep. Combine patterns: `grep -iE "meeting|deadline" memory/HISTORY.md`2021## When to Update MEMORY.md2223Write important facts immediately using `edit_file` or `write_file`:24- User preferences ("I prefer dark mode")25- Project context ("The API uses OAuth2")26- Relationships ("Alice is the project lead")2728## Auto-consolidation2930Old conversations are automatically summarized and appended to HISTORY.md when the session grows large. Long-term facts are extracted to MEMORY.md. You don't need to manage this.
Run npx get-skill add simplified-reasoning/memory in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Two-layer memory system with grep-based recall. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
simplified-reasoning (@simplified-reasoning) published this skill. Their other Agent Skills are listed on their SkillMD profile.