Skip to main content
skill CX Codex

memory-doctor — Claude Code skill: Basic Memory checks

The memory-doctor Claude Code skill checks local Basic Memory projects and explains its findings. It runs when search misses or repeats notes, or a save seems to have gone missing.

AGPL-3.0 249 installs ★ 4,660 updated 2026-10-24

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

What memory-doctor does

The skill runs bm doctor, interprets its project reports, and explains the issues it finds. The check reads data only. It shows suggested repair commands and runs them only after the user approves.

A shell with the bm or basic-memory command is required. The default check skips the self-test; run that test if the report is clean but the issue persists. It writes a note in a temporary sandbox, then indexes and searches for it. Cloud projects appear separately because local commands cannot repair them.

After approved repairs, the skill runs the check again. A full search reindex reads every project file and may take a while on a large project.

What it helps with

  • find why search misses an existing note
  • investigate duplicate search results
  • check whether a saved note changed its file
  • diagnose Basic Memory after a crash or interrupted import
  • apply a suggested repair after approval

Example prompts for the agent

  • Check Basic Memory: search misses a note that should be there.
  • Check the work project and explain why search returns duplicates.
  • Run a check after an interrupted import and show the repair commands.

How to install memory-doctor

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about memory-doctor

How do I install memory-doctor in Claude Code?

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

What does memory-doctor do?

It checks local Basic Memory projects with bm doctor, explains the results, and offers repair commands. It runs those commands only after the user agrees.

What does memory-doctor need to run?

It needs a shell with the bm or basic-memory command. Cloud projects are indexed on the server, so local commands cannot repair them.

Similar skills

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

From the same set23

The whole set →
memory-comark memory-comark adds charts, tables, task boards and live views to Basic Memory notes via ::bm-* Comark components. Helpful when a note reads better as a figure or board. CX Codex +1 342installs memory-quest memory-quest is a Claude Code skill that verifies an assistant’s connection to Basic Memory Cloud and records the final verification note for Mission 8. CX Codex +1 327installs memory-okf memory-okf — a skill for Claude Code that finds and fixes blockers to exporting a Basic Memory project as OKF v0.2. It runs before publishing, handing off a project, or checking an export bundle. CX Codex +1 305installs memory-agents The memory-agents Claude Code skill creates, runs, and checks Basic Memory Cloud agents. Agents follow instructions on notes and can start when someone creates a note in watched paths. CX Codex +1 268installs bm-setup This Claude Code skill configures Basic Memory through a short interview. It starts when asked to set up Basic Memory or when /basic-memory:bm-setup is run. CX Codex +1 160installs bm-remember A skill for quick capture of thoughts, facts, or reminders into Basic Memory. Responds to /basic-memory:bm-remember or natural language like "remember that…" — saves text as-is, preserving your wording. CX Codex +1 155installs bm-status bm-status is a Claude Code skill that checks Basic Memory's current health and configuration, including CLI access, hook queues, and recent session checkpoints. CX Codex +1 154installs bm-share bm-share copies notes from your personal Basic Memory workspace to a shared team project with author attribution and source permalinks. CX Codex +1 148installs

Project sponsors

Companies that keep this analytics open