skill CX Codex

memory-reflect · basicmachines-co — Claude Code skill for reflecting on agent memory

Q: How do I install memory-reflect in Claude Code?

Run `npx skills add basicmachines-co/basic-memory --skill memory-reflect -a claude-code`, then look for `~/.claude/skills/memory-reflect/SKILL.md`.

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add basicmachines-co/basic-memory --skill memory-reflect -a claude-code

Open on GitHub

What memory-reflect 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.

What it helps with

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 for the agent

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

How to install memory-reflect

1Skills CLI (Vercel)

npx skills add basicmachines-co/basic-memory --skill memory-reflect -a claude-code

2Manually: put the files in place

~/.claude/skills/memory-reflect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/memory-reflect/

1Skills CLI (Vercel)

npx skills add basicmachines-co/basic-memory --skill memory-reflect -a codex

2Manually: put the files in place

.agents/skills/memory-reflect/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add basicmachines-co/basic-memory --skill memory-reflect -a cursor

2Manually: put the files in place

.cursor/skills/memory-reflect/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install basicmachines-co/basic-memory memory-reflect

2Manually: put the files in place

.github/skills/memory-reflect/SKILL.md

1Skills CLI (Vercel)

npx skills add basicmachines-co/basic-memory --skill memory-reflect -a gemini-cli

2Platform CLI

gemini skills install https://github.com/basicmachines-co/basic-memory --path skills/memory-reflect

Manually: put the files in place

.devin/skills/memory-reflect/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add basicmachines-co/basic-memory --skill memory-reflect -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about memory-reflect

How do I install memory-reflect in Claude Code?

Run npx skills add basicmachines-co/basic-memory --skill memory-reflect -a claude-code, then look for ~/.claude/skills/memory-reflect/SKILL.md.

What does memory-reflect do?

It reads Basic Memory notes changed since the previous reflection and folds lasting facts into the topic notes. Each pass leaves a separate record in reflections/.

What does the skill need to work?

A connected Basic Memory MCP server, since every read and write goes through its bm_* tools. The expected_checksum check keeps an edit from overwriting a revision someone else made.

memory-reflect by other authors comes first.

memory-reflect basicmachines-co 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. CX Codex +1 746installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set14

memory-literary-analysis Turns a complete literary work into a Basic Memory knowledge graph with schemas, chapter notes, linked entities, and validation. CX Codex +1 1,200installs memory-lifecycle Automates note status transitions in Basic Memory. It archives completed work into appropriate folders and updates frontmatter without deleting records. CX Codex +1 1,200installs memory-defrag This skill tidies a Basic Memory project by splitting bloated notes, consolidating facts, and flagging contradictions for review. CX Codex +1 1,200installs memory-tasks Keeps work-in-progress as notes in the Basic Memory knowledge graph, so you can find active tasks and resume them after compaction or a restart. CX Codex +1 1,200installs memory-schema Manages note schemas in Basic Memory by finding untyped entries, generating schema definitions, checking field consistency, and catching structural drift. CX Codex +1 1,200installs memory-metadata-search Search Basic Memory notes by YAML frontmatter fields, from status and tags to nested values. Useful when a text query alone cannot narrow the results. CX Codex +1 1,200installs memory-onboarding Guides you through designing a Basic Memory knowledge base and wiring it into your assistant so project context persists across sessions. CX Codex +1 960installs basic-memory A local MCP server that keeps your knowledge in Markdown files on disk and lets the AI read, write and search them. Useful when you are tired of re-explaining project context. CX Codex +1 ★ 4,357repo stars