# memory-reflect

A background skill that reviews recent sessions and daily notes, pulls out what matters and folds it into long-term memory. Runs on a schedule or on demand.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 746 installs · ★ 23
- Author: basicmachines-co
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basicmachines-co/basic-memory-skills/tree/HEAD/memory-reflect/SKILL.md
- Updated: 2026-04-20
- HTML: https://affpapa.org/en/nevibecode/skills/basicmachines-co-memory-reflect

## What it does

Think of memory-reflect as sleep for your agent. It opens notes from the last couple of days, checks active tasks, and decides what deserves to stick around: decisions that shape future work, lessons from mistakes, working-style preferences, details about people. Weather checks and routine steps get dropped.

It then updates `MEMORY.md` in place, following whatever structure the file already has. New sections get added, outdated entries get rewritten instead of duplicated. Today's daily note gets a short reflection log listing what was reviewed, what moved into long-term memory and what was cleaned up. The daily notes themselves stay put — they are the raw record.

The author suggests scheduling it once or twice a day through cron or heartbeat. Another good moment is right after context compaction, when part of the history is gone. The skill leans on the `recent_activity`, `read_note` and `search_notes` tools, so with no note store configured it has nothing to read. While gathering material it also looks for filesystem trouble: recursive nesting like `memory/memory/memory/`, orphaned files, bloated notes. Those are the usual reason a reflection run ends up hoarding junk.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory-skills --skill memory-reflect -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/memory-reflect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/memory-reflect/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory-skills --skill memory-reflect -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/memory-reflect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory-skills --skill memory-reflect -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/memory-reflect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install basicmachines-co/basic-memory-skills memory-reflect
```

2. **Manually: put the files in place**
- File: `.github/skills/memory-reflect/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory-skills --skill memory-reflect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/basicmachines-co/basic-memory-skills --path memory-reflect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/memory-reflect/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory-skills --skill memory-reflect -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/basicmachines-co/basic-memory-skills/tree/HEAD/memory-reflect/SKILL.md

## When to use it
- carry decisions from yesterday's session into long-term memory
- strip duplicates and stale entries out of `MEMORY.md`
- turn a chronological note dump into topical sections
- spot orphaned files and recursive nesting in the note store
- run a memory pass after context compaction

## Example prompts
- Reflect on my recent sessions and update MEMORY.md
- Go through the last two days of daily notes and pull out what's worth keeping
- Check my memory for duplicates and junk files

## Similar
- [memory-onboarding](https://affpapa.org/en/nevibecode/skills/memory-onboarding.md) — skill · 960 installs
- [memory-capture](https://affpapa.org/en/nevibecode/skills/memory-capture.md) — skill · 1300 installs
- [memory-intake](https://affpapa.org/en/nevibecode/skills/memory-intake.md) — skill · 766 installs
- [claude-memory-curator](https://affpapa.org/en/nevibecode/skills/claude-memory-curator.md) — skill · 2600 installs
- [memory-search](https://affpapa.org/en/nevibecode/skills/ruvnet-memory-search.md) — skill · 750 installs
- [ov-experience-memory](https://affpapa.org/en/nevibecode/skills/ov-experience-memory.md) — skill · 564 installs

## Other versions with the same name
- [memory-reflect · basicmachines-co](https://affpapa.org/en/nevibecode/skills/memory-reflect.md) — 1200 installs

From the same set: [basicmachines-co/basic-memory-skills](https://affpapa.org/en/nevibecode/by/basicmachines-co/basic-memory-skills.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md