Skip to content
Skills Library
AI & agents · Tool integration

memory

/memory

Deliberately search, add to, or curate your long-term memory with the `memory` tool — beyond the automatic recall/capture every turn already does. Use when asked who someone is or what they're working on, when you learn a durable fact worth keeping now, or when your notebook holds stale or wrong entries you should clean up.

Repository
qm ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Deliberately search, add to, or curate your long-term memory with the `memory` tool — beyond the automatic recall/capture every turn already does. Use when asked who someone is or what they're working on, when you learn a durable fact worth keeping now, or when your notebook holds stale or wrong entries you should clean up.

Original author description

Deliberately search, add to, or curate your long-term memory with the `memory` tool — beyond the automatic recall/capture every turn already does. Use when asked who someone is or what they're working on, when you learn a durable fact worth keeping now, or when your notebook holds stale or wrong entries you should clean up.

How it works

  1. Org-wide notebook (admins)
  2. Failure modes
Original SKILL.md headings · 68 lines, 599 words
SKILL.md preview
---
name: memory
description: Deliberately search, add to, or curate your long-term memory with the `memory` tool — beyond the automatic recall/capture every turn already does. Use when asked who someone is or what they're working on, when you learn a durable fact worth keeping now, or when your notebook holds stale or wrong entries you should clean up.
---

# memory — search, write, and curate what you remember

Everything here goes through the typed `memory` tool. Memory is NOT a file: writing
`memory/MEMORY.md` with `files` action `write` or shell commands lands on your computer's disk and is
silently lost — the tool is the one real path.

Every turn already auto-recalls a bounded selection from your notebooks into "## What you remember" and
auto-extracts facts after you reply. This skill is for what the automatic path misses:

- **Search** (`action: "search"`) — what you remember is bigger than what auto-recall
  injects. Search spans every notebook this conversation may read (personal, channel,
  org); when more than one is in reach, each hit is tagged with the notebook it came
  from. Matching is substring-based (all terms must match), so prefer distinctive terms
  (a name, a project) over sentences.
  An empty result means those terms found no match, not that nothing is recorded. Try fewer terms or alternate wording before concluding a fact is absent.
- **Read another notebook** (`action: "read", scope: "channel:…"`) — use the exact
  scope ID from a search result to load that authorized notebook. `search` accepts
  `scope` too, to narrow a query. Omit it to search all authorized notebooks or read
  the current notebook. Access comes from this turn's sharing policy; naming a
  scope never grants access. Other notebooks are read-only.
- **Write now** (`action: "add"`, `facts: [{text}, …]`) — when the user corrects you or tells you
  something they'll expect you to know later, persist it immediately instead of hoping
  post-turn extraction catches it. Write self-contained facts (who/what, with enough
  context to be useful cold). Duplicates are dropped; `added` in the reply is the count
  actually new.
- **Curate** (`action: "edit"` with `facts: [{id, text}, …]`, `action: "delete"` with
  `ids`) — search or read to get each fact's `#id`, then fix facts that changed and delete
  stale, duplicate, or wrong ones. A call naming any id that isn't in this conversation's
  notebook changes nothing and lists the bad ids. Curation is for quality — merging
  duplicates, deleting disproven facts — not for deleting things the user asked you to
  remember.

The notebook you write is this conversation's own (your personal one in a DM, the
channel's in a channel). Other authorized notebooks can be searched/read, not rewritten here.

The org-admin write path uses the self-API instead, called with
`$AGENT_API_URL` and `$AGENT_API_TOKEN` (both already in your environment on every turn —
if they are unset, this instance has no self-API; say so rather than pretending).

## Org-wide notebook (admins)

When the chatting user is an org admin, the self-API additionally accepts the org-wide
notebook as a target:

```bash
curl -fsS -X POST "$AGENT_API_URL/v1/memory/facts" \
  -H "x-agent-capability: $AGENT_API_TOKEN" \
  -H "content-type: application/json" \
  -d '{"scope":"org","facts":["..."]}'
```

(`?scope=org` on `GET /v1/memory/self`; `"scope":"org"` in the body of `PATCH /v1/memory/facts`
with `{"facts":[{"id","text"}]}` or `DELETE /v1/memory/facts` with `{"ids":[…]}` to curate.)
Those writes land in the notebook every conversation in the org recalls, so confirm the
wording with the admin before writing and keep personal facts out of it. A `403 org
memory writes require an org admin` means the user isn't one — say so rather than
retrying (`GET $AGENT_API_URL/v1/admin/whoami` answers it definitively).

## Failure modes

- "memory isn't available in this conversation" — this conversation's memory policy
  forbids it; don't retry, just say memory is off here.
- On a read-only wake (a heartbeat glance), memory can be searched and read but not
  written — save the fact on a normal turn instead.
- `401 unauthorized` from the self-API — your token expired mid-turn; this resolves on
  the next turn.

Versions

RepositoryScoreLicence
This page · yc-software/qm100MIT
rjmurillo/ai-agents100MIT
rjmurillo/ai-agents100MIT
topoteretes/cognee-integrations100Apache-2.0
topoteretes/cognee-integrations100Apache-2.0
topoteretes/cognee-integrations100Apache-2.0
thebtf/engram100MIT
stxrmik/antigravity-plus100MIT
boshu2/agentops100Apache-2.0

Database snapshot: 13.11.2026 · package version 73bbda29324a (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100codex-memory-curator
    Audit and safely curate Codex memory, including stale claims, cross-repo leakage, sensitive entries, and memory configuration. Use when reviewing or cleaning Codex memory, not generic repository docs.
  • 90daftari-memory
    Use the user's Daftari vault as long-term memory. Use when the user refers to earlier decisions, preferences, or project context; asks you to remember, forget, or correct something; or when a conversation reaches a conclusion worth keeping for future chats.
  • 95memmachine
    Operate MemMachine/MemMachine, the agent long-term memory server, Python/TypeScript clients and MCP integration. Use when a task names this exact repository, its server, memory APIs, deployment or MCP tools. For general memory architecture selection use…
  • 100memory-cleanup
    Clean up stale entries - closed issues, merged MRs, expired ephemeral namespaces, old session logs. Use when user says "clean memory", "memory cleanup", or "remove stale entries".
  • 100memory-audit
    Runs a memory hygiene pass on the project memory/ directory. Reviews all active memory files against the current codebase and archives or supersedes stale entries. Use before major feature work or when memory files feel out of date. Trigger this when someone says: clean up…
  • 100memory-status
    Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:memory-status or asks how full or healthy the agent memory is.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.