Agent skill

Memory Reflect

by basicmachines-co in basicmachines-co/basic-memory

Sleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory.

AGPL-3.0Auto-check passedKnowledge Management

Install Memory Reflect

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install basicmachines-co/basic-memory memory-reflect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/memory-reflect .claude/skills/memory-reflect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
memory-reflect
GitHub stars
4.1k
Used in
1 other repo
Token cost
~763 tokens
SKILL.md length
309 words
Files
1
Skills in repo
49
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Sleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory.

  • Works in 4 steps: Gather Recent Material → Evaluate What Matters → Update Long-Term Memory → …
  • Triggered by cron
  • SKILL.md covers When to Run, Process and Guidelines
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Memory Reflect is an agent skill from basicmachines-co/basic-memory. Sleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory. Use when triggered by cron, heartbeat, or explicit request to reflect on recent activity. Runs as background processing to improve memory quality over time.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management, covering Agent memory, Note-taking and Scheduled and recurring tasks. The repository describes itself as: AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN. The licence is AGPL-3.0.

When your agent uses it

  • Triggered by cron
  • Explicit request to reflect on recent activity

Example prompts

  • “/memory-reflect”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Gather Recent Material
  2. Evaluate What Matters
  3. Update Long-Term Memory
  4. Log the Reflection

What it can do on your machine

Read from SKILL.md and the folder at commit 6982cfc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Memory Reflect loads about 763 tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 309 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~76
When it runs · the whole SKILL.md, loaded when a task matches
~763

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from basicmachines-co/basic-memory at commit 6982cfc, republished under its AGPL-3.0 licence (© basicmachines-co). 309 words, ~763 tokens.

Download SKILL.mdSave it as .claude/skills/memory-reflect/SKILL.md (or your agent's skills folder).
name
memory-reflect
description
Sleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory. Use when triggered by cron, heartbeat, or explicit request to reflect on recent activity. Runs as background processing to improve memory quality over time.

Memory Reflect

Review recent activity and consolidate valuable insights into long-term memory.

Inspired by sleep-time compute — the idea that memory formation happens best between active sessions, not during them.

When to Run

  • Cron/heartbeat: Schedule as a periodic background task (recommended: 1-2x daily)
  • On demand: User asks to reflect, consolidate, or review recent memory
  • Post-compaction: After context window compaction events

Process

1. Gather Recent Material

Find what changed recently, then read the relevant files:

python
# Find recently modified notes — json gives structured rows; text output
# across all projects shows only the top items
recent_activity(timeframe="2d", output_format="json")

# Read specific daily notes
read_note(identifier="memory/<YYYY-MM-DD>")

# Check active tasks
search_notes(note_types=["task"], status="active")
2. Evaluate What Matters

For each piece of information, ask:

  • Is this a decision that affects future work? → Keep
  • Is this a lesson learned or mistake to avoid? → Keep
  • Is this a preference or working style insight? → Keep
  • Is this a relationship detail (who does what, contact info)? → Keep
  • Is this transient (weather checked, heartbeat ran, routine task)? → Skip
  • Is this already captured in MEMORY.md or another long-term file? → Skip
3. Update Long-Term Memory

Write consolidated insights to MEMORY.md following its existing structure:

  • Add new sections or update existing ones
  • Use concise, factual language
  • Include dates for temporal context
  • Remove or update outdated entries that the new information supersedes
4. Log the Reflection

Append a brief entry to today's daily note:

markdown
## Reflection (HH:MM)
- Reviewed: [list of files reviewed]
- Added to MEMORY.md: [brief summary of what was consolidated]
- Removed/updated: [anything cleaned up]

Guidelines

  • Be selective. The goal is distillation, not duplication. MEMORY.md should be curated wisdom, not a copy of daily notes.
  • Preserve voice. If the agent has a personality/soul file, reflections should match that voice.
  • Don't delete daily notes. They're the raw record. Reflection extracts from them; it doesn't replace them.
  • Merge, don't append. If MEMORY.md already has a section about a topic, update it in place rather than adding a duplicate entry.
  • Flag uncertainty. If something seems important but you're not sure, add it with a note like "(needs confirmation)" rather than skipping it entirely.
  • Restructure over time. If MEMORY.md is a chronological dump, restructure it into topical sections during reflection. Curated knowledge > raw logs.

© basicmachines-co, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/memory-reflect of basicmachines-co/basic-memory.

Open the folder on GitHubat commit 6982cfc

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in basicmachines-co/basic-memory, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Memory Reflect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Memory Reflect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memory Reflect this skillbasicmachines-co/basic-memory4.1k1 repos~763Automated safety check: PassAGPL-3.0
Obsidian Project Memorybrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~2.4kAutomated safety check: PassCustom licence
AI BrainOotto-AI/claude-content-skills101—~1.1kAutomated safety check: PassMIT
Second Brain Auditcoleam00/skills670—~4.6kAutomated safety check: PassMIT
Para Memory FilesUndertone0809/rudder292—~2.6kAutomated safety check: PassApache-2.0
C Obsidiandaxaur/openpaw173—~659Automated safety check: PassMIT

Similar skills

  • Obsidian Project Memory

    brycewang-stanford/Auto-Empirical-Research-Skills

    This skill should be used when the user asks to maintain an Obsidian knowledge base for a research project, import an existing research repository into Obsidian, keep project memory or daily notes…

    4.5k GitHub stars~2.4k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • AI Brain

    Ootto-AI/claude-content-skills

    Give Claude a permanent, searchable long-term memory using an Obsidian vault as the store.

    101 GitHub stars~1.1k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Second Brain Audit

    coleam00/skills

    Audit any second brain, notes folder, or agent memory for facts that have quietly stopped being true, then fix the worst one so it stops recurring.

    670 GitHub stars~4.6k tokensUpdated 20 days ago
    Knowledge ManagementAuto-check passed
  • Para Memory Files

    Undertone0809/rudder

    File-based memory system using Tiago Forte's PARA method. An agent skill from Undertone0809/rudder.

    292 GitHub stars~2.6k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • C Obsidian

    daxaur/openpaw

    Obsidian vault as persistent memory — daily notes, session logs, knowledge capture, and search across your entire vault.

    173 GitHub stars~659 tokensUpdated 4 mo ago
    Knowledge ManagementAuto-check passed
  • Agent Carnet Notebook

    yamadashy/repomix

    Saves and recalls markdown notes between agent sessions with the agent-carnet CLI, tracking which notes proved useful so stale ones expire and good ones stay.

    29k GitHub stars~1.2k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed

More from basicmachines-co/basic-memory

All 49 skills in this repo
  • cmux Settings Editor

    basicmachines-co/basic-memory

    Views, sets, unsets and validates cmux settings in ~/.config/cmux/cmux.json with a helper script that checks keys against the schema.

    4.1k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • cmux Window and Pane Control

    basicmachines-co/basic-memory

    End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs…

    4.1k GitHub starsUsed in 2 repos~842 tokens
    Auto-check passed
  • Cmux Markdown Viewer Panel

    basicmachines-co/basic-memory

    Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists.

    4.1k GitHub starsUsed in 2 repos~527 tokens
    Auto-check passed
  • cmux Workspace Scoping

    basicmachines-co/basic-memory

    Keeps agent actions scoped to the cmux workspace and terminal that invoked it, and lays out pane and surface commands that avoid disrupting the user's own focus.

    4.1k GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Basic Memory Repo Images

    basicmachines-co/basic-memory

    Produces PR, changelog and two-week retro images for the Basic Memory repository from evidence in PR bodies, saved to fixed paths under docs/assets/infographics.

    4.1k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Logfire Instrumentation

    basicmachines-co/basic-memory

    Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.

    4.1k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Questions about Memory Reflect

What does Memory Reflect do?

Sleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory. Memory Reflect is an agent skill from basicmachines-co/basic-memory. Sleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory.

When should I use Memory Reflect?

Memory Reflect fits situations like: triggered by cron; explicit request to reflect on recent activity.

How do I install Memory Reflect in Claude Code?

Run `npx skills add basicmachines-co/basic-memory --skill memory-reflect -a claude-code`. Or copy the skill folder (skills/memory-reflect in basicmachines-co/basic-memory) into .claude/skills/memory-reflect in your project. Claude Code loads it when a task matches its description.

How do I install Memory Reflect in Codex?

Run `npx skills add basicmachines-co/basic-memory --skill memory-reflect -a codex`. Or copy the skill folder (skills/memory-reflect in basicmachines-co/basic-memory) into .agents/skills/memory-reflect in your project. Codex loads it when a task matches its description.

Can I use Memory Reflect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add basicmachines-co/basic-memory --skill memory-reflect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memory-reflect, .gemini/skills/memory-reflect, .github/skills/memory-reflect and .opencode/skills/memory-reflect in your project.

What does Memory Reflect need to run?

SKILL.md names no scripts, command-line tools or credentials: Memory Reflect is instructions for the agent only. Our summary lists: Python 3.

Does Memory Reflect access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Memory Reflect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Memory Reflect use?

Memory Reflect is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Memory Reflect use?

About 763 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Memory Reflect?

Skills that share tags, products or a category with Memory Reflect: Obsidian Project Memory (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars), AI Brain (Ootto-AI/claude-content-skills, 101 stars), Second Brain Audit (coleam00/skills, 670 stars) and Para Memory Files (Undertone0809/rudder, 292 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memory Reflect?

basicmachines-co (a GitHub organization) maintains it in basicmachines-co/basic-memory, which has 4,107 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.

Source: basicmachines-co/basic-memory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.