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

Installs 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

More from basicmachines-co/basic-memory-skills

All 10
1hugorcd avatarcreate-evlog-adapterhugorcd/evlogCreate a new built-in evlog adapter to send wide events to an external observability platform. Use when adding a new drain adapter (e.g., for Elasticsearch, Hon811skills.sh installs
2softaworks avatarperplexitysoftaworks/agent-toolkitWeb search and research using Perplexity AI. Use when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT 802skills.sh installs
3diodeinc avatarreference-designdiodeinc/pcbGrow a component package into a high-quality, sourceable reusable design in Zener. Use when translating a datasheet, application note, or eval design into circu799skills.sh installs
4lulu-eva avatarevalulu-eva/eva-skillEva-skill 2.2.8 的极薄路由入口。仅在用户调用 /eva、点名 Eva 子入口,提出 Eva 的思考、人群识别、短视频或非虚构文章、发布前审核、学习、Brief、复盘、Lens、Memory、Link、新手教程,或在 Eva 上下文中询问“下一步怎么走、先用哪个功能、入口排序、给我一个工作流”时使用;也处799skills.sh installs
5subframeapp avatardesignsubframeapp/subframeDesign and edit anything in Subframe — pages, components, snippets, design documents, the theme. Also handles deletion of those resources except theme. Always l793skills.sh installs
6alirezarezvani avatarsales-engineeralirezarezvani/claude-skillsAnalyzes RFP/RFI responses for coverage gaps, builds competitive feature comparison matrices, and plans proof-of-concept (POC) engagements for pre-sales enginee788skills.sh installs