Skip to main content
skill CX Codex

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.

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

What 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-code

2Manually: put the files in place

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

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

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.

Similar skills

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

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-reflect 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. CX Codex +1 1,200installs 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

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