
Memory Notes
Shows you how to write markdown notes that Basic Memory can parse into a knowledge graph. Covers the three core pieces: YAML frontmatter with title and tags, observations with semantic categories like [decision] or [risk], and relations that link notes together with wiki-style brackets. The guide is thorough on syntax details, like how permalinks get auto-generated and how inline links create graph edges automatically. Worth reading if you're setting up a new memory system or your notes aren't surfacing in searches the way you expect.
- skills.sh installs
- 833
- GitHub stars
- 23
- last updated
- Aug 21, 2026
Install
$ npx -y skills add basicmachines-co/basic-memory-skills --skill memory-notes --agent claude-codeInstalls into .claude/skills of the current project.
Files
Memory Notes
Write well-structured notes that Basic Memory can parse into a searchable knowledge graph. Every note is a markdown file with three key sections: frontmatter, observations, and relations.
Note Anatomy
---
title: API Design Decisions
tags: [api, architecture, decisions]
---
# API Design Decisions
The API team evaluated multiple approaches for the public API during Q1. After
prototyping both REST and GraphQL, the team chose REST due to broader ecosystem
support and simpler caching semantics. This note captures the key decisions and
their rationale, along with open questions still to resolve.
## Observations
- [decision] Use REST over GraphQL for simplicity #api
- [requirement] Must support versioning from day one
- [risk] Rate limiting needed for public endpoints
## Relations
- implements [[API Specification]]
- depends_on [[Authentication System]]
- relates_to [[Performance Requirements]]
Frontmatter
Every note starts with YAML frontmatter:
Sponsors
Details
- Repository
- github.com/basicmachines-co/basic-memory-skills
- Category
- Documentation
- First seen
- Jun 3, 2026