mirror of https://github.com/basicmachines-co/basic-memory synced 2026-06-21 13:47:35 +00:00

Files

T

phernandez 877e52fd73 feat(skills): port useful retired plugin skills into the shared memory-* set

Following the evaluation on #866, the genuinely-useful behavior from the deleted
Claude Code plugin skills is preserved as framework-agnostic shared skills (usable
by any MCP agent — Claude Desktop, OpenClaw, etc.), instead of being lost in the
v0.4 clean-break. The Claude Code plugin itself is unchanged — it deliberately
relies on hooks + the output style for capture/recall and pulls these shared skills
via /basic-memory:setup.

New shared skills (ported from the deleted set, CC-specific glue stripped):
- memory-curate (from knowledge-organize) — the real coverage gap: knowledge-GRAPH
  curation (orphan notes, relation suggestion, duplicate merge, tag/folder audit,
  hub notes, sparse-note enrichment). Distinct from memory-defrag, which is
  agent-memory-FILE hygiene.
- memory-continue (from continue-conversation) — resume prior work by rebuilding
  context from the graph (build_context / recent_activity / search), timeframe table,
  resume playbooks.
- memory-capture (from knowledge-capture) — synthesize a thread's current state into
  one note, rewriting in place via a thread_id key. The Claude-Code-specific session
  UUID is generalized to "any stable thread id your host exposes."

Also completed memory-notes' edit reference (added prepend / replace_section to the
two existing operations). Updated skills/README.md and skills/CLAUDE.md.

`just package-check-skills` validates 13 skills. NOTE: skills/skills-lock.json is a
generated artifact of the `npx skills` CLI (not used by Claude Code or OpenClaw) and
should be regenerated once the set is final — not hand-edited here.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: phernandez <paul@basicmachines.co>

2026-05-31 12:31:08 -05:00

3.0 KiB

Raw Permalink Blame History

AGENTS.md

This file provides guidance to coding agents when working with Basic Memory skills in this repository.

Project Overview

Skills collection for Basic Memory — a local-first knowledge graph built on markdown files and MCP. Each skill teaches AI assistants how to effectively use Basic Memory's MCP tools.

Skills can be installed via npx skills add or copied manually into any agent's skills directory.

Repository Structure

Each skill is a single SKILL.md file in its own directory:

memory-tasks/SKILL.md           # Task tracking across context compaction
memory-schema/SKILL.md          # Schema lifecycle (discover, infer, validate, drift)
memory-reflect/SKILL.md         # Sleep-time memory consolidation
memory-notes/SKILL.md           # Note writing patterns and knowledge graph design
memory-defrag/SKILL.md          # Memory reorganization and cleanup
memory-metadata-search/SKILL.md # Structured metadata filtering and queries
memory-lifecycle/SKILL.md       # Entity status transitions and folder-based archival
memory-ingest/SKILL.md          # Process external input into structured entities
memory-research/SKILL.md        # Web research synthesized into Basic Memory entities
memory-literary-analysis/SKILL.md # Literary analysis knowledge graph pipeline
memory-curate/SKILL.md          # Knowledge-graph curation: orphans, relations, tags, hub notes
memory-continue/SKILL.md        # Resume prior work by rebuilding context from the graph
memory-capture/SKILL.md         # Capture a thread's current state into one coherent note

There is no code to compile — this is a pure markdown project. Run just check from skills/ or just package-check-skills from the monorepo root to validate the memory-*/SKILL.md frontmatter before committing changes.

SKILL.md Format

Every skill file has YAML frontmatter with name (kebab-case identifier) and description (one-sentence summary), followed by markdown content:

---
name: memory-<name>
description: "What the skill does and when to use it."
---

# Skill Title

[Sections: When to Use, Key Concepts, How-to, Examples, Guidelines]

Adding a New Skill

Create memory-<name>/SKILL.md with frontmatter and markdown instructions
Update README.md with the new skill's summary
Commit and push

Key Concepts Referenced in Skills

Notes: Markdown files representing entities in the Basic Memory knowledge graph
Frontmatter: YAML metadata (title, type, tags, custom fields)
Observations: Categorized facts — - [category] content #tags
Relations: Wiki-links creating graph edges — - relation_type [[Target Note]]
Schema / Picoschema: Compact YAML definitions for note structure validation
Memory URLs: memory://path-to-note for programmatic access
MCP Tools: write_note, read_note, edit_note, move_note, delete_note, search_notes, build_context, schema_validate, schema_infer, schema_diff

3.0 KiB Raw Permalink Blame History