Agent skill

Trusty Memory

by bobmatnyc in bobmatnyc/claude-mpm

Persistent memory palace system with hierarchical storage (palace/wing/room/closet/drawer), progressive retrieval (L0-L3), and temporal knowledge graph for cross-session context

Apache-2.0Auto-check passedAgent Workflows

Install Trusty Memory

skills CLI
$ npx skills add bobmatnyc/claude-mpm --skill trusty-memory -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bobmatnyc/claude-mpm trusty-memory --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bobmatnyc/claude-mpm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/trusty-memory .claude/skills/trusty-memory && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
trusty-memory
GitHub stars
155
Token cost
~2k tokens
SKILL.md length
522 words
Files
2
Skills in repo
52
Repo updated
First seen
Licence
Apache-2.0

At a glance

Persistent memory palace system with hierarchical storage (palace/wing/room/closet/drawer), progressive retrieval (L0-L3), and temporal knowledge graph for cross-session context

  • Works in 3 steps: Auto-loaded: L0 identity + L1 top-15… → Targeted recall: For task-specific context → Check KG for relevant entity relationships
  • Tasks that involve Knowledge graphs
  • SKILL.md covers When to Use, Architecture, Tool Reference and Room Type Selection, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Trusty Memory is an agent skill from bobmatnyc/claude-mpm. Persistent memory palace system with hierarchical storage (palace/wing/room/closet/drawer), progressive retrieval (L0-L3), and temporal knowledge graph for cross-session context

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `metadata.json`). Compatibility notes: claude-code

It sits in Agent Workflows, covering Knowledge graphs, Agent memory and Session handoff. The repository describes itself as: Claude Multi-Agent Project Manager — multi-channel orchestration, GitHub-first SDK mode, and plugin system for Claude. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Knowledge graphs
  • Tasks that involve Agent memory
  • Tasks that involve Session handoff

Example prompts

  • “/trusty-memory”

Requirements

  • Compatibility (from SKILL.md): claude-code

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Auto-loaded: L0 identity + L1 top-15 drawers appear in context automatically.
  2. Targeted recall: For task-specific context
  3. Check KG for relevant entity relationships

What it can do on your machine

Read from SKILL.md and the folder at commit 25203d3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    claude-code

    From compatibility in the SKILL.md frontmatter.

Context cost

Trusty Memory loads about 2k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 522 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bobmatnyc/claude-mpm at commit 25203d3, republished under its Apache-2.0 licence (© bobmatnyc). 522 words, ~2,027 tokens.

Download SKILL.mdSave it as .claude/skills/trusty-memory/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
trusty-memory
description
Persistent memory palace system with hierarchical storage (palace/wing/room/closet/drawer), progressive retrieval (L0-L3), and temporal knowledge graph for cross-session context
compatibility
claude-code
user-invocable
false
disable-model-invocation
false
license
Apache-2.0

trusty-memory

Persistent memory system using the Memory Palace metaphor for organizing context across sessions. Replaces mcp__kuzu-memory__* tools.

When to Use

  • Session start: Recall relevant context for the current task
  • Decision moments: Store key architectural/design decisions
  • Learning capture: Remember new patterns, conventions, gotchas discovered
  • Relationship tracking: Assert facts in the knowledge graph (X depends on Y, A replaces B)
  • Session end: Persist outcomes and next steps

Do NOT use for: ephemeral scratch notes, code snippets (use trusty-search), or content that belongs in source files.

Architecture

Palace (project)     e.g. "claude-mpm"
  └── Wing (area)    e.g. "Backend"
        └── Room     e.g. "Backend", "Frontend", "Testing", "Planning",
                          "Documentation", "Research", "Configuration",
                          "Meetings", "General"
              └── Closet (sub-category)
                    └── Drawer (memory item: uuid, content, tags, importance)
Progressive Retrieval Layers
LayerTokensWhenTrigger
L0~100AlwaysIdentity / project context auto-loaded
L1~800AlwaysTop-15 drawers by importance auto-loaded
L2variableOn topic matchmemory_recall — metadata-filtered vector search
L3exhaustiveExplicitmemory_recall_deep — full HNSW deep search

Always try memory_recall first. Escalate to memory_recall_deep only if results are insufficient.

Tool Reference

Retrieval

memory_recall — Fast progressive retrieval (L0+L1+L2). Use this first.

mcp__trusty-memory__memory_recall(
  query="how does the migration registry work",
  room="Backend",        # optional filter
  limit=10               # optional
)

memory_recall_deep — Full HNSW deep search (L3). Use when memory_recall insufficient.

mcp__trusty-memory__memory_recall_deep(
  query="rare edge case in hook dispatcher",
  limit=20
)

memory_list — Browse drawers by room/tag (no semantic query).

mcp__trusty-memory__memory_list(room="Planning", tag="release-workflow")
Storage

memory_remember — Store a drawer.

mcp__trusty-memory__memory_remember(
  content="The migration runner uses run_pending_migrations() at startup; state in ~/.claude-mpm/migrations.json",
  room="Backend",
  tags=["migrations", "startup"],
  importance=0.8         # 0.0-1.0; higher = more likely to appear in L1
)

memory_forget — Delete by UUID.

mcp__trusty-memory__memory_forget(drawer_id="<uuid>")
Palace Management
mcp__trusty-memory__palace_list()
mcp__trusty-memory__palace_info(palace="claude-mpm")
mcp__trusty-memory__palace_create(name="new-project")
Knowledge Graph (temporal triples)

kg_assert — Assert a (subject, predicate, object) fact.

mcp__trusty-memory__kg_assert(
  subject="trusty-memory",
  predicate="replaces",
  object="kuzu-memory"
)

kg_query — Query triples for a subject.

mcp__trusty-memory__kg_query(subject="trusty-memory")

Room Type Selection

RoomUse For
BackendServer-side logic, APIs, services, data layer
FrontendUI, components, styling, client-state
TestingTest patterns, fixtures, flaky test notes, coverage decisions
PlanningRoadmaps, architectural decisions, ticket plans
DocumentationDoc conventions, README structure, public API docs
ResearchInvestigations, spike findings, library evaluations
ConfigurationBuild setup, env vars, deploy config, tooling
MeetingsDecisions from sync calls, action items
GeneralCross-cutting concerns, miscellaneous

When unsure, prefer the most-specific room. Tags handle the rest.

KG Triple Patterns

Use consistent predicates for queryable graphs:

PredicateExample
replaces(trusty-memory, replaces, kuzu-memory)
depends_on(release-publish, depends_on, gh-account-bobmatnyc)
implements(migration_runner, implements, run_pending_migrations)
documented_in(release_workflow, documented_in, CLAUDE.md)
owned_by(planner-agent, owned_by, .claude/agents/planner.md)
version_of(6.2.67, version_of, claude-mpm)
triggers(SessionStart, triggers, model_tier_hook)

Workflow Protocols

Session Start Protocol
  1. Auto-loaded: L0 identity + L1 top-15 drawers appear in context automatically.
  2. Targeted recall: For task-specific context:
    memory_recall(query="<current task domain>", limit=10)
  3. Check KG for relevant entity relationships:
    kg_query(subject="<entity being modified>")
Show full SKILL.md (224 more words)Show less
Session End Protocol

For each significant outcome, persist it:

  1. Decisions → memory_remember with high importance (0.7-0.9)

    memory_remember(
      content="Decided to consolidate hook scripts under claude-hook-fast.sh; old per-event scripts deprecated",
      room="Backend",
      tags=["hooks", "decision"],
      importance=0.85
    )
  2. Relationships → kg_assert

    kg_assert(subject="claude-hook-fast.sh", predicate="replaces", object="per-event-hook-scripts")
  3. Gotchas / learnings → memory_remember with tags for discoverability

    memory_remember(
      content="release-publish requires `claude-mpm gh switch` to bobmatnyc first; bob-duetto account causes auth failures",
      room="Configuration",
      tags=["release", "gotcha", "github-auth"],
      importance=0.9
    )
Recall vs Recall-Deep Decision
SituationUse
Standard context lookupmemory_recall
Top-N relevant results enoughmemory_recall
memory_recall returned <3 hitsmemory_recall_deep
Investigating obscure / rare topicmemory_recall_deep
Need exhaustive coverage of a conceptmemory_recall_deep

Importance Scoring

ScoreType
0.9-1.0Critical: release gotchas, security constraints, hard rules
0.7-0.9Architectural decisions, major patterns
0.5-0.7Useful conventions, common patterns
0.3-0.5Project trivia, minor preferences
0.0-0.3Ephemeral, rarely-useful

L1 surfaces the top 15 by importance — score accordingly.

Migration from kuzu-memory

OldNew
mcp__kuzu-memory__kuzu_recallmcp__trusty-memory__memory_recall
mcp__kuzu-memory__kuzu_learnmcp__trusty-memory__memory_remember
mcp__kuzu-memory__kuzu_remembermcp__trusty-memory__memory_remember
mcp__kuzu-memory__kuzu_project_contextAuto-loaded via L0
mcp__kuzu-memory__kuzu_statsmcp__trusty-memory__palace_info

Common pattern: search → understand → remember.

# 1. Find code with trusty-search
search_code(query="migration runner", query_type="Definition")

# 2. After investigating, persist the learning
memory_remember(
  content="Migration runner pattern: registry.py registers each migrate_*.py module; run_pending_migrations iterates by version",
  room="Backend",
  tags=["migrations", "pattern"],
  importance=0.75
)

Best Practices

  • Be specific: "Release workflow requires bobmatnyc gh account" beats "Check gh account before releasing"
  • Include WHY: Decision rationale beats decision alone
  • Tag generously: Tags enable cross-room discovery
  • Use KG for relationships: Don't bury "X replaces Y" in prose — assert it
  • Update over duplicate: Forget stale drawers when superseded
  • Prefer recall over recall_deep: Save the expensive call for when you need it

© bobmatnyc, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .claude/skills/trusty-memory of bobmatnyc/claude-mpm.

  • SKILL.md
  • metadata.json

Open the folder on GitHubat commit 25203d3

Compare with similar skills

Trusty Memory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Trusty Memory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trusty Memory this skillbobmatnyc/claude-mpm155—~2kAutomated safety check: PassApache-2.0
Using LWC Memory and Graphssickn33/agentic-awesome-skills47k1 repos~2kAutomated safety check: PassApache-2.0
Ogham Maintainogham-mcp/ogham-mcp115—~1.1kAutomated safety check: PassMIT
Ogham Recallogham-mcp/ogham-mcp115—~1kAutomated safety check: PassMIT
Memoryautomateyournetwork/netclaw675—~1.2kAutomated safety check: PassApache-2.0
Git Notes Memorysundial-org/awesome-openclaw-skills663—~2.7kAutomated safety check: PassNone

Similar skills

  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed
  • Ogham Maintain

    ogham-mcp/ogham-mcp

    Admin and maintenance workflows for Ogham shared memory. An agent skill from ogham-mcp/ogham-mcp.

    115 GitHub stars~1.1k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Ogham Recall

    ogham-mcp/ogham-mcp

    Smart retrieval from Ogham shared memory. An agent skill from ogham-mcp/ogham-mcp.

    115 GitHub stars~1k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Memory

    automateyournetwork/netclaw

    NetClaw's native persistent memory (spec 033) — structured facts with temporal validity, semantic search across past sessions, decision logging, and entity relationships, backed by SQLite + ChromaDB…

    675 GitHub stars~1.2k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Git Notes Memory

    sundial-org/awesome-openclaw-skills

    Git-Notes-Based knowledge graph memory system. An agent skill from sundial-org/awesome-openclaw-skills.

    663 GitHub stars~2.7k tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed
  • Coding Agent Session Finder

    code-yeongyu/oh-my-openagent

    Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.

    70k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed

More from bobmatnyc/claude-mpm

All 52 skills in this repo
  • Build MCP Server

    bobmatnyc/claude-mpm

    Create high-quality MCP servers that enable LLMs to effectively interact with external services.

    155 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Env Manager

    bobmatnyc/claude-mpm

    Environment variable validation, synchronization, and management across local development, CI/CD, and deployment platforms

    155 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check: notes
  • Session Analyzer

    bobmatnyc/claude-mpm

    Debug and teach agentic coding: a deterministic-first session timeline + cost report, with optional narrative polish and a standalone JSX visualiser.

    155 GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Software Patterns

    bobmatnyc/claude-mpm

    Decision framework for architectural patterns including DI, SOA, Repository, Domain Events, Circuit Breaker, and Anti-Corruption Layer.

    155 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Verification Before Completion

    bobmatnyc/claude-mpm

    Run verification commands and confirm output before claiming success

    155 GitHub starsUsed in 2 repos~1k tokens
    Auto-check passed
  • Dependency Audit

    bobmatnyc/claude-mpm

    Dependency audit and cleanup workflow for maintaining healthy project dependencies.

    155 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Trusty Memory

What does Trusty Memory do?

Persistent memory palace system with hierarchical storage (palace/wing/room/closet/drawer), progressive retrieval (L0-L3), and temporal knowledge graph for cross-session context. Trusty Memory is an agent skill from bobmatnyc/claude-mpm.

When should I use Trusty Memory?

Trusty Memory fits situations like: tasks that involve Knowledge graphs; tasks that involve Agent memory; tasks that involve Session handoff.

How do I install Trusty Memory in Claude Code?

Run `npx skills add bobmatnyc/claude-mpm --skill trusty-memory -a claude-code`. Or copy the skill folder (.claude/skills/trusty-memory in bobmatnyc/claude-mpm) into .claude/skills/trusty-memory in your project. Claude Code loads it when a task matches its description.

How do I install Trusty Memory in Codex?

Run `npx skills add bobmatnyc/claude-mpm --skill trusty-memory -a codex`. Or copy the skill folder (.claude/skills/trusty-memory in bobmatnyc/claude-mpm) into .agents/skills/trusty-memory in your project. Codex loads it when a task matches its description.

Can I use Trusty Memory in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bobmatnyc/claude-mpm --skill trusty-memory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trusty-memory, .gemini/skills/trusty-memory, .github/skills/trusty-memory and .opencode/skills/trusty-memory in your project.

What does Trusty Memory need to run?

SKILL.md names no scripts, command-line tools or credentials: Trusty Memory is instructions for the agent only. Compatibility (from SKILL.md): claude-code.

Does Trusty Memory access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Trusty Memory safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Trusty Memory use?

Trusty Memory is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Trusty Memory use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Trusty Memory?

Skills that share tags, products or a category with Trusty Memory: Using LWC Memory and Graphs (sickn33/agentic-awesome-skills, 47k stars), Ogham Maintain (ogham-mcp/ogham-mcp, 115 stars), Ogham Recall (ogham-mcp/ogham-mcp, 115 stars) and Memory (automateyournetwork/netclaw, 675 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trusty Memory?

bobmatnyc (a GitHub user) maintains it in bobmatnyc/claude-mpm, which has 155 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on August 31, 2026.

Source: bobmatnyc/claude-mpm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.