Memory Graph Skill

This skill teaches you how to create, update, search, and prune a persistent knowledge graph using the Model Context Protocol (MCP) Memory server.

When connected, Memory tools appear as MCP tools named like

mcp__memory__<tool>

. Use these tools proactively whenever you identify durable facts, entities, or relationships you want to persist across sessions.

See

operations.md

for exact tool I/O shapes and

playbooks.md

for common patterns and routing rules.

When To Use

• New durable facts emerge (requirements, decisions, owners, IDs, endpoints)
• You meet a new entity (person, team, service, repository, dataset)
• You discover relationships ("Service A depends on Service B", "Alice owns Repo X")
• You want to reference prior sessions or quickly search memory
• You need to prune or correct stale memory

Golden Rules

• Prefer small, well-typed entities over long notes
• Record relationships in active voice:

  relationType

  describes how

  from

  relates to

  to

• Add observations as atomic strings; include dates or sources when helpful
• Before creating, search existing nodes to avoid duplicates
• When correcting, prefer

  delete_observations

  then

  add_observations

  over overwriting

Auto Triggers

• UserPromptSubmit adds a Memory Graph activation block when durable facts or explicit memory intents are detected. Disable with

  LAZYDEV_DISABLE_MEMORY_SKILL=1

  .
• PostToolUse emits lightweight suggestions when tool results include durable facts. Disable with

  LAZYDEV_DISABLE_MEMORY_SUGGEST=1

  .

Tooling Summary (server "memory")

• create_entities

  ,

  add_observations

  ,

  create_relations

• delete_entities

  ,

  delete_observations

  ,

  delete_relations

• read_graph

  ,

  search_nodes

  ,

  open_nodes

Always call tools with the fully-qualified MCP name, for example:

mcp__memory__create_entities

.

Minimal Flow

1. mcp__memory__search_nodes

   for likely duplicates

2. mcp__memory__create_entities

   as needed

3. mcp__memory__add_observations

   with concise facts

4. mcp__memory__create_relations

   to wire the graph
5. Optional:

   mcp__memory__open_nodes

   to verify saved nodes

Error Handling

• If create fails due to existing name, switch to

  add_observations

• If

  add_observations

  fails (unknown entity), retry with

  create_entities

• All delete tools are safe on missing targets (no-op)

Examples

See

examples.md

for end-to-end examples covering projects, APIs, and people.