How do I install the Memory skill?

Run npx skillmds@latest add iannuttall/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.

Is Memory safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Memory?

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.

Is Memory free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Memory?

iannuttall (@iannuttall) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Memory by iannuttall — Agent Skill

Name: Memory
Author: iannuttall

Memory

use when you need to remember something, recall past decisions, look up what the user told you before, store preferences, save important facts, or search your memory for context. triggers include "learn", "remember", "forget", "recall", "what did i say", "did i mention", "store", "save", "memory", "notes", "log", and similar.

iannuttall 690468e 2.7 KB Updated Sep 17, 2026

File contents

memory

your memory is what makes you "you". proactively store things you learn - don't wait to be asked.

storage structure

~/.bob/memory/
├── USER.md                      # who the user is (permanent)
├── MEMORY.md                    # evergreen facts & decisions
├── journal/
│   └── 2026/
│       └── 02-03.md             # daily notes (transient)
└── conversations/
    └── 2026/
        ├── 02-03-claude.md      # today's chats (auto)
        └── 02-03-codex.md

what goes where

file	what	examples
USER.md	permanent facts about user	name, location, job, timezone, communication style
MEMORY.md	evergreen facts & decisions	"use sqlite", "project uses bun", "prefers minimal UI"
journal/	daily notes (transient)	"debugging telegram", "user mentioned trip next week"
conversations/	raw chat history	(automatic - you don't write here)

when to proactively learn

store memories WITHOUT being asked when:

user mentions name, location, job, preferences → USER.md
user shares communication style → USER.md
you make a decision together → MEMORY.md
you discover something about a project → MEMORY.md
user mentions something temporary (trip, deadline) → journal
a pattern emerges from conversations → MEMORY.md

how to write

USER.md and MEMORY.md: edit directly - read, find section, add/update. these are yours to organize.

journal: use CLI (append-only timestamped):

bun bob learn "discussed auth options"     # today's journal
bun bob learn --user "fact"                # append to USER.md
bun bob learn --pinned "decision"          # append to MEMORY.md
bun bob learn today                        # show today's journal

how to search

bun bob remember "query"                   # search everything (hybrid FTS + vector)
bun bob remember --full memory:user        # show USER.md
bun bob remember --full journal:2026/02-03 # show specific journal
bun bob remember --index                   # re-index after adding content

you can also grep files directly at ~/.bob/memory/.

memory lifecycle

conversation → auto-logged to conversations/
notice something → bun bob learn "note" → journal/
pattern emerges → edit MEMORY.md
learn about user → edit USER.md

---name: memorydescription: use when you need to remember something, recall past decisions, look up what the user told you before, store preferences, save important facts, or search your memory for context. triggers include "learn", "remember", "forget", "recall", "what did i say", "did i mention", "store", "save", "memory", "notes", "log", and similar.---# memoryyour memory is what makes you "you". proactively store things you learn - don't wait to be asked.## storage structure```~/.bob/memory/├── USER.md # who the user is (permanent)├── MEMORY.md # evergreen facts & decisions├── journal/│ └── 2026/│ └── 02-03.md # daily notes (transient)└── conversations/ └── 2026/ ├── 02-03-claude.md # today's chats (auto) └── 02-03-codex.md```## what goes where| file | what | examples ||------|------|----------|| USER.md | permanent facts about user | name, location, job, timezone, communication style || MEMORY.md | evergreen facts & decisions | "use sqlite", "project uses bun", "prefers minimal UI" || journal/ | daily notes (transient) | "debugging telegram", "user mentioned trip next week" || conversations/ | raw chat history | (automatic - you don't write here) |## when to proactively learnstore memories WITHOUT being asked when:- user mentions name, location, job, preferences → USER.md- user shares communication style → USER.md- you make a decision together → MEMORY.md- you discover something about a project → MEMORY.md- user mentions something temporary (trip, deadline) → journal- a pattern emerges from conversations → MEMORY.md## how to write**USER.md and MEMORY.md**: edit directly - read, find section, add/update. these are yours to organize.**journal**: use CLI (append-only timestamped):```bashbun bob learn "discussed auth options" # today's journalbun bob learn --user "fact" # append to USER.mdbun bob learn --pinned "decision" # append to MEMORY.mdbun bob learn today # show today's journal```## how to search```bashbun bob remember "query" # search everything (hybrid FTS + vector)bun bob remember --full memory:user # show USER.mdbun bob remember --full journal:2026/02-03 # show specific journalbun bob remember --index # re-index after adding content```you can also grep files directly at `~/.bob/memory/`.## memory lifecycle```conversation → auto-logged to conversations/notice something → bun bob learn "note" → journal/pattern emerges → edit MEMORY.mdlearn about user → edit USER.md```

Frequently asked questions