Skip to main content
affpapa.org
RU EN
skill CX Codex

memory-notes — Claude Code skill: what it does, how to install

Guides coding agents on structuring markdown notes for Basic Memory knowledge graphs. It covers YAML metadata, categorized observations, and wiki-style note relations.

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

What memory-notes does

The skill teaches agents the exact anatomy of notes parsed by Basic Memory. Each document starts with frontmatter containing a title and optional tags. The frontmatter title must match the top heading. Below it, the body holds context and trade-offs in plain prose. Search queries rely on this text.

Structured facts live in the observations section: - [category] text #tag. Categories are arbitrary and queryable through bm_search. Time qualifiers like @effective:YYYY-MM-DD define when a fact applies. Relative terms like yesterday remain plain text, so exact dates are mandatory. Relations form graph edges via directional links.

What it helps with

  • format project notes for Basic Memory knowledge graph ingestion
  • record technical decisions with explicit validity timeframes
  • connect markdown files using typed wiki-link relationships
  • categorize atomic facts and risks with custom bracketed tags

Example prompts for the agent

  • Create a Basic Memory note documenting our database migration decisions.
  • Format this meeting summary with bracketed observations and links to the auth spec.
  • Add a decision observation with an effective date qualifier to the architecture note.

How to install memory-notes

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about memory-notes

How to install memory-notes in Claude Code?

Run npx skills add basicmachines-co/basic-memory --skill memory-notes -a claude-code. The skill file will be placed in ~/.claude/skills/memory-notes/SKILL.md.

What does the memory-notes skill do?

It teaches your AI agent how to write structured markdown documents for the Basic Memory graph. The rules specify how to format frontmatter, categorize atomic facts, and link notes.

How do observations handle dates and deadlines?

Observations take qualifiers such as @due:YYYY-MM-DD or @effective:YYYY-MM-DD directly after the category bracket. Relative words like "yesterday" stay as plain text and are not parsed as date filters.

Similar skills

All skills for Agent setup: memory, context, orchestration →
memory-lifecycle basicmachines-co A Basic Memory skill that moves notes between status folders, updates frontmatter, and archives instead of deleting. CX Codex +1 546installs memory-ingest basicmachines-co Turns meeting transcripts, chat logs and pasted documents into structured Basic Memory notes. Useful when raw text needs to become entities and relations. CX Codex +1 541installs bear-notes openclaw Manages Bear notes on macOS through the grizzly CLI to create notes, search tags, and append text directly from your agent. CX Codex +1 5,100installs consolidate-notes Inkeep Turns a decision your team already made plus its draft research into one canonical article. Useful once the arguing is over and the source of truth needs writing down. CX Codex +1 823installs apple-notes openclaw Manages Apple Notes via the memo CLI directly from your terminal. Helps you search, create, and export notes to Markdown. CX Codex +1 5,900installs release-notes phuryn Creates user-facing release notes from tickets, PRDs, and changelogs. Use it when announcing updates or summarising shipped work. CX Codex +1 2,900installs

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-capture 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. 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-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
Nutra.Club

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