# memory-reflect

The skill reviews what changed in Basic Memory and carries the durable parts into the notes where they belong. Run it daily or after a burst of work.

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

## What it does

This skill sits on top of a Basic Memory notes graph. It collects material added since the previous reflection, opens every changed note in full, and sorts what should still matter next month from what was routine. Decisions, lessons, preferences, owners and dated commitments survive; a moved file or a passing check does not.

The SKILL.md walks through four stages: gather, filter, file the results into topic notes, then log the reflection itself as a dated entry under `reflections/`. The next run reads that entry as its starting checkpoint. Edits to existing notes carry `expected_checksum`, so a file touched after it was read triggers a fresh read instead of a blind overwrite. Raw notes stay in place.

Every call goes through Basic Memory tools: `bm_list`, `bm_project`, `bm_read`, `bm_search`, `bm_edit`, `bm_write`. With no Basic Memory MCP server connected the skill has nothing to work with. The `recent` command reaches back one year at most, so if the last reflection is older, the run takes `since="365d"` and flags the uncovered period in its own report.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --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 --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 --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 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 --skill memory-reflect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/basicmachines-co/basic-memory --path skills/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 --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/tree/HEAD/skills/memory-reflect/SKILL.md

## When to use it
- turn meeting decisions into durable project notes
- date a fact and link it back to its source note
- close an outdated decision with a date range instead of deleting it
- sort lasting agreements from one-off details in a log
- log a reflection run so the next one can start from it

## Example prompts
- Reflect on what changed in Basic Memory since the last run
- Consolidate the recent notes — keep what deserves to last
- Go through my latest edits and file the decisions into topic notes

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

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

From the same set: [basicmachines-co/basic-memory](https://affpapa.org/en/nevibecode/by/basicmachines-co/basic-memory.md) — 14 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