Skip to main content
skill CX Codex

memory-capture — Claude Code skill: save a thread's outcome to Basic

Turns the current state of a working thread into one Basic Memory note. Useful mid-thread or at the end, once decisions and context are worth keeping.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add basicmachines-co/basic-memory --skill memory-capture -a claude-code
Open on GitHub

What memory-capture does

The skill reads where a conversation has landed and writes it up as a single Basic Memory note. Not a transcript — the decisions made, the insights surfaced, the trade-off that got settled. Because the note should read top-to-bottom as one document, a second capture in the same thread rewrites it in place rather than appending.

Re-capture needs a stable key to find the same note. If your agent exposes a session or thread id, it goes into thread_id in the frontmatter, and the lookup runs through bm_search with filters rather than query — full-text search does not reliably match custom YAML fields. Without an id, the skill matches by topic and keeps a consistent title. The overwrite goes through bm_write with overwrite=True and expected_checksum; if another session edited the note in between, you get REVISION_CONFLICT and have to read it again.

All of this runs on the Basic Memory MCP server, so bm_search, bm_read and bm_write need somewhere to go. The note layout is fixed: context, topical sections, an observations block tagged [decision], [tradeoff] and similar, plus relations via relates_to. There is no changelog section at the bottom — revisions sit in the prose where they matter. Ask for a separate note explicitly and the skill skips the thread lookup and creates a fresh one without thread_id.

What it helps with

  • keep decisions from evaporating when a thread closes
  • condense a design discussion into one note
  • rewrite a previous capture instead of duplicating it
  • record which option was chosen and why
  • summarize a session at the end

Example prompts for the agent

  • Capture the current state of this thread into Basic Memory
  • Save the decisions and insights from this session as one note
  • Update the note for this thread with the latest changes

How to install memory-capture

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about memory-capture

How do I install memory-capture in Claude?

Run npx skills add basicmachines-co/basic-memory --skill memory-capture -a claude-code. The skill lands at ~/.claude/skills/memory-capture/SKILL.md.

What does memory-capture do?

It captures the decisions, insights and context of a working thread into one Basic Memory note. Invoke it again in the same thread and it rewrites that note so the document stays coherent.

What does memory-capture need to work?

The Basic Memory MCP server, since the skill calls bm_search, bm_read and bm_write. Rewriting in place also needs a stable thread id or a matching note title.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set14

memory-curate Curates your Basic Memory knowledge graph by connecting orphan notes, proposing typed relations, merging duplicates, and building hub indexes. Useful when accumulated notes become disorganized. CX Codex +1 1,300installs memory-continue This skill rebuilds context from the Basic Memory graph so your assistant picks up previous work instead of starting cold. CX Codex +1 1,300installs memory-notes Guides coding agents on structuring markdown notes for Basic Memory knowledge graphs. It covers YAML metadata, categorized observations, and wiki-style note relations. CX Codex +1 1,300installs memory-research Researches companies, people, and tools across the web and synthesizes findings into Basic Memory notes. Useful when you need to record structured facts about an external subject. CX Codex +1 1,200installs 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

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor