memory-onboarding — Claude Code skill: what it does, how to install
Guides you through designing a Basic Memory knowledge base and wiring it into your assistant so project context persists across sessions.
npx skills add basicmachines-co/basic-memory --skill memory-onboarding -a claude-codeWhat memory-onboarding does
This skill builds a markdown-based knowledge graph for your project. It interviews you about the domains you want to track, such as tasks or contacts, and creates structured note templates. Notes receive explicit schemas and categorized facts with links. Plain text turns into queryable data.
The onboarding follows phased steps, requiring your explicit blueprint sign-off before writing any files. It sets up a startup router note so future assistant sessions automatically load relevant instructions. Your setup requires active Basic Memory tools like bm_write and bm_read. Without them, the assistant pauses the workflow immediately.
What it helps with
- design schemas and note templates for Basic Memory
- preserve assistant context across multiple work sessions
- turn scattered markdown notes into a structured knowledge graph
- create a startup router note to load project rules automatically
Example prompts for the agent
- Help me set up a Basic Memory knowledge system for this project
- Run memory-onboarding to organize my scattered research notes
- I want to structure my tasks and contact notes using Basic Memory
How to install memory-onboarding
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-onboarding -a claude-code2Manually: put the files in place
~/.claude/skills/memory-onboarding/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/memory-onboarding/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-onboarding -a codex2Manually: put the files in place
.agents/skills/memory-onboarding/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-onboarding -a cursor2Manually: put the files in place
.cursor/skills/memory-onboarding/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory memory-onboarding2Manually: put the files in place
.github/skills/memory-onboarding/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-onboarding -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory --path skills/memory-onboardingManually: put the files in place
.devin/skills/memory-onboarding/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill memory-onboarding -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about memory-onboarding
How to install memory-onboarding in Claude Code?
Run npx skills add basicmachines-co/basic-memory --skill memory-onboarding -a claude-code in your terminal.
What does memory-onboarding do?
It interviews you to map tracking needs, builds structured note schemas, and configures a startup router note so your assistant reads project rules every session.
What prerequisites does this skill require?
It requires access to Basic Memory MCP tools like bm_write, bm_read, bm_search, and bm_list. The assistant halts onboarding until these tools are connected.