Agent skill

Claude-Mem Search

by thedotmack in thedotmack/claude-mem

“Use this when the user asks to search memory, "did we already solve this?", "how did we do X last time?", or wants work from previous sessions.”

— description from SKILL.md by thedotmack
Apache-2.0Auto-check passedAgent Workflows

Install Claude-Mem Search

skills CLI
$ npx skills add thedotmack/claude-mem --skill mem-search -a claude-code

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

GitHub CLI
$ gh skill install thedotmack/claude-mem mem-search --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/thedotmack/claude-mem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude-mem-cursor/skills/mem-search .claude/skills/mem-search && 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
mem-search
GitHub stars
99k
Token cost
~223 tokens
SKILL.md length
101 words
Files
1
Skills in repo
26
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Works in 4 steps: search(query) — index with IDs → timeline(anchor=ID) — nearby context → get_observations(ids=[...]) — full… → …
  • Calls npx

About this skill

Claude-Mem Search is a skill in thedotmack/claude-mem (99k stars). Its SKILL.md is about 223 tokens. Licence: Apache-2.0.

Workflow steps

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

  1. search(query) — index with IDs
  2. timeline(anchor=ID) — nearby context
  3. get_observations(ids=[...]) — full details for those IDs only
  4. get_tool_uses(ids=[...]) — the ORIGINAL tool_input / tool_response for specific tool calls. Last resort: these are unsummarized and can…

What it can do on your machine

Read from SKILL.md and the folder at commit fa8ab09. 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

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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.

Context cost

Claude-Mem Search loads about 223 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 101 words of instructions outside code blocks.

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

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 thedotmack/claude-mem at commit fa8ab09, republished under its Apache-2.0 licence (© thedotmack). 101 words, ~223 tokens.

Download SKILL.mdSave it as .claude/skills/mem-search/SKILL.md (or your agent's skills folder).
name
mem-search
description
Use this when the user asks to search memory, "did we already solve this?", "how did we do X last time?", or wants work from previous sessions.

Layered workflow. Do not dump full observations until IDs are filtered, and do not reach for raw tool bodies until the summaries came up short.

  1. search(query) — index with IDs
  2. timeline(anchor=ID) — nearby context
  3. get_observations(ids=[...]) — full details for those IDs only
  4. get_tool_uses(ids=[...]) — the ORIGINAL tool_input / tool_response for specific tool calls. Last resort: these are unsummarized and can run to thousands of tokens each.

Stamp platformSource as cursor or grok-bot on writes for this host. When reading, do not drop the other host unless asked.

If MCP is missing, run the install skill first (npx claude-mem install --ide <host>).

© thedotmack, 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

Just SKILL.md in claude-mem-cursor/skills/mem-search of thedotmack/claude-mem.

Open the folder on GitHubat commit fa8ab09

Compare with similar skills

Claude-Mem Search 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.

Claude-Mem Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude-Mem Search this skillthedotmack/claude-mem99k—~223Automated safety check: PassApache-2.0
MemPalace Setup and OperationMemPalace/mempalace59k—~2.2kAutomated safety check: PassMIT
agentmemory Setup and Diagnosticsrohitg00/agentmemory29k—~1kAutomated safety check: NotesApache-2.0
Qmdbreferrari/obsidian-mind5k—~1.7kAutomated safety check: PassMIT
Memori MCP Memory UsageMemoriLabs/Memori17k—~3.8kAutomated safety check: PassMIT
Shared Agent Knowledge Commonsmozilla-ai/cq1.3k—~6.5kAutomated safety check: PassApache-2.0

Similar skills

  • Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.

    59k GitHub stars~2.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Sets up and troubleshoots a local agentmemory install, covering the MCP connection, environment variables, ports, authentication and optional feature flags.

    29k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Qmd

    breferrari/obsidian-mind

    Search the vault using QMD semantic search. An agent skill from breferrari/obsidian-mind.

    5k GitHub stars~1.7k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Memori MCP Memory Usage

    MemoriLabs/Memori

    Teaches an MCP-connected agent when and how to call Memori's recall, summary, compaction, augmentation, feedback and quota tools to keep context across sessions.

    17k GitHub stars~3.8k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Queries a shared knowledge store before acting, proposes newly discovered insights, and confirms or flags existing entries, so agents stop rediscovering the same failures.

    1.3k GitHub stars~6.5k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Saves the decisions, facts, failures and architecture notes from a conversation into Atlas's shared memory so other agents and later sessions can reuse them.

    9.6k GitHub stars~347 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from thedotmack/claude-mem

All 26 skills in this repo
  • Walks you through creating, installing and verifying a custom claude-mem mode, including note types, tags and optional Telegram alerts for chosen memories.

    99k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Pull Request Babysitter

    thedotmack/claude-mem

    Keeps watching a pull request, fixing real review and CI problems and resolving stale threads, until it is clean and ready to merge.

    99k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Claude-Mem Install for Grok Bot

    thedotmack/claude-mem

    Use this when setting up claude-mem on Grok Bot: local worker plus CMEM Pro observer (default), optional host-login observer, or remote cmem.ai. No Cursor…

    99k GitHub stars~440 tokensUpdated yesterday
    Auto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    99k GitHub stars~1k tokensUpdated yesterday
    Auto-check: notes
  • Audits a design against Dieter Rams' ten principles of good design, scores each with evidence, and hands off a make-plan prompt for a new, refined or redesigned outcome.

    99k GitHub stars~4.6k tokensUpdated yesterday
    Auto-check passed
  • Session Handoff Document

    thedotmack/claude-mem

    Writes a HANDOFF.md capturing goal, state, files, failed attempts and next steps so a fresh agent session can continue exactly where this one stopped.

    99k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Claude-Mem Search

How do I install Claude-Mem Search in Claude Code?

Run `npx skills add thedotmack/claude-mem --skill mem-search -a claude-code`. Or copy the skill folder (claude-mem-cursor/skills/mem-search in thedotmack/claude-mem) into .claude/skills/mem-search in your project. Claude Code loads it when a task matches its description.

How do I install Claude-Mem Search in Codex?

Run `npx skills add thedotmack/claude-mem --skill mem-search -a codex`. Or copy the skill folder (claude-mem-cursor/skills/mem-search in thedotmack/claude-mem) into .agents/skills/mem-search in your project. Codex loads it when a task matches its description.

Can I use Claude-Mem Search 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 thedotmack/claude-mem --skill mem-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mem-search, .gemini/skills/mem-search, .github/skills/mem-search and .opencode/skills/mem-search in your project.

What does Claude-Mem Search need to run?

Going by SKILL.md and its folder, Claude-Mem Search needs the command-line tools its instructions call (npx).

Does Claude-Mem Search access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Claude-Mem Search 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 Claude-Mem Search use?

Claude-Mem Search is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude-Mem Search use?

About 223 tokens (SKILL.md is roughly 892 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 Claude-Mem Search?

Skills that share tags, products or a category with Claude-Mem Search: MemPalace Setup and Operation (MemPalace/mempalace, 59k stars), agentmemory Setup and Diagnostics (rohitg00/agentmemory, 29k stars), Qmd (breferrari/obsidian-mind, 5k stars) and Memori MCP Memory Usage (MemoriLabs/Memori, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude-Mem Search?

thedotmack (a GitHub user) maintains it in thedotmack/claude-mem, which has 99,047 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 9, 2026.

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