Agent skill

Mem0 Health Check

Runs four checks on a Mem0 plugin, API key, identity resolution, search connectivity and a write probe, then reports pass or fail for each with a troubleshooting section on failure.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Mem0 Health Check

skills CLI

$ npx skills add mem0ai/mem0 --skill status -a claude-code

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

GitHub CLI

$ gh skill install mem0ai/mem0 status --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/mem0ai/mem0.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/pi-agent-plugin/skills/status .claude/skills/status && 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/

Paste into Claude Code

Install the "status" agent skill from https://github.com/mem0ai/mem0/tree/main/integrations/pi-agent-plugin/skills/status into .claude/skills/status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "status", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/mem0ai/mem0/tree/main/integrations/pi-agent-plugin/skills/status

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add mem0ai/mem0 --skill status -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install mem0ai/mem0 status --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mem0ai/mem0.git skills-src && mkdir -p .agents/skills && cp -r skills-src/integrations/pi-agent-plugin/skills/status .agents/skills/status && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "status" agent skill from https://github.com/mem0ai/mem0/tree/main/integrations/pi-agent-plugin/skills/status into .agents/skills/status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "status", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mem0ai/mem0 --skill status -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install mem0ai/mem0 status --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mem0ai/mem0.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/integrations/pi-agent-plugin/skills/status .cursor/skills/status && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "status" agent skill from https://github.com/mem0ai/mem0/tree/main/integrations/pi-agent-plugin/skills/status into .cursor/skills/status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "status", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/mem0ai/mem0.git --path integrations/pi-agent-plugin/skills/status

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add mem0ai/mem0 --skill status -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install mem0ai/mem0 status --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mem0ai/mem0.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/integrations/pi-agent-plugin/skills/status .gemini/skills/status && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "status" agent skill from https://github.com/mem0ai/mem0/tree/main/integrations/pi-agent-plugin/skills/status into .gemini/skills/status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "status", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install mem0ai/mem0 status

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add mem0ai/mem0 --skill status -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/mem0ai/mem0.git skills-src && mkdir -p .github/skills && cp -r skills-src/integrations/pi-agent-plugin/skills/status .github/skills/status && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "status" agent skill from https://github.com/mem0ai/mem0/tree/main/integrations/pi-agent-plugin/skills/status into .github/skills/status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "status", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mem0ai/mem0 --skill status -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install mem0ai/mem0 status --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mem0ai/mem0.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/integrations/pi-agent-plugin/skills/status .opencode/skills/status && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "status" agent skill from https://github.com/mem0ai/mem0/tree/main/integrations/pi-agent-plugin/skills/status into .opencode/skills/status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "status", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: status
GitHub stars: 67k
Token cost: ~650 tokens
SKILL.md length: 280 words
Files: 1
Skills in repo: 26
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Runs four checks on a Mem0 plugin, API key, identity resolution, search connectivity and a write probe, then reports pass or fail for each with a troubleshooting section on failure.

Memory searches are returning empty and you want to know why
SKILL.md covers Execution and Extended mode: Memory Quality…
Needs MEM0_API_KEY
Verifying the Mem0 plugin is configured correctly after setup

What it does

The skill runs every check and shows one summary rather than stopping at the first failure. It verifies the API key is configured from MEM0_API_KEY or a config file and shows only its first six characters, reports the resolved user_id, project_id and session_id, calls the mem0_memory tool with a search action to confirm connectivity, and calls it again with an add action to confirm it can write, cleaning up the probe memory afterward. Any failure gets a troubleshooting section with specific fix steps.

An extended mode, triggered with --deep, adds a memory quality scan on top of the standard checks: it fetches all memories and flags pairs within the same category with more than 60 percent shared nouns as potential duplicates, flags memories older than 180 days that have not been accessed recently as stale, and flags pairs that assert opposing facts as contradictions, listing affected memory IDs so the user can review them with the normal search and forget commands.

When your agent uses it

Memory searches are returning empty and you want to know why
Verifying the Mem0 plugin is configured correctly after setup
Running a deeper scan for duplicate or contradictory memories

Example prompts

“Run a Mem0 health check; my searches aren't returning anything.”
“/mem0-status --deep and show me any duplicate or stale memories.”
“Check whether the Mem0 plugin can actually write a new memory right now.”

Requirements

A configured MEM0_API_KEY or mem0-config.json
The mem0_memory tool available to the agent

What it can do on your machine

Read from SKILL.md and the folder at commit b7ad69a. 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 these keys or tokens, usually read from environment variables:
- MEM0_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mem0 Health Check loads about 650 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 280 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: ~650

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 mem0ai/mem0 at commit b7ad69a, republished under its Apache-2.0 licence (© mem0ai). 280 words, ~650 tokens.

Download SKILL.mdSave it as .claude/skills/status/SKILL.md (or your agent's skills folder).

name: status
description: Diagnoses Mem0 connectivity, API key validity, and memory read/write functionality. Use when memory operations fail, searches return empty, or to verify the plugin is working correctly.

Health Check / Status

Run a diagnostic check on the Mem0 plugin. Useful for troubleshooting.

Execution

Run ALL checks, then display a single summary. Do not stop on the first failure.

Check 1: API key

Verify the API key is configured. The plugin loads it from MEM0_API_KEY env var or ~/.pi/agent/mem0-config.json.

If not set: FAIL — "No API key configured"
If set: PASS — show first 6 chars followed by ...

Check 2: Identity resolution

Report the resolved identity:

user_id: from config, env, or system user
project_id: auto-detected from current directory
session_id: current session identifier

PASS if user_id and project_id are non-empty. WARN if any falls back to defaults.

Check 3: Connectivity

Use mem0_memory tool with action="search", query="health check".

If returns successfully (even empty): PASS
If errors: FAIL — show the error message

Check 4: Memory write capability

Use mem0_memory tool with action="add", content="Health check probe — safe to delete.".

If succeeds: PASS — then clean up by deleting the probe memory.
If errors: FAIL — show the error.

Display

## mem0 health

PASS  API Key          m0-dVe...
PASS  Identity         user=kartik, project=my-app, session=abc123
PASS  Connectivity     142ms
PASS  Write/Read       write + delete OK

All checks passed.

If any check fails, add a ## Troubleshooting section with specific fix steps.

Extended mode: Memory Quality Analysis

When invoked with --deep (e.g., /mem0-status --deep), run the standard checks above plus a memory quality scan.

Quality Check 1: Duplicates

Fetch all memories with mem0_memory action="get_all". Compare pairs within the same category for high textual overlap (shared nouns > 60%). Report:

Potential duplicates: <N> pairs
  [mem0:<id1>] ~ [mem0:<id2>] — both about "<shared topic>"

Quality Check 2: Stale memories

Flag memories older than 180 days that haven't been accessed recently.

Quality Check 3: Contradictions

Within each category, flag pairs that assert opposing facts.

Quality summary

## Memory Quality

Duplicates: <N> · Stale: <N> · Contradictions: <N>

If all counts are 0: Memory quality: clean. If any non-zero, list the affected memory IDs so the user can review them with the normal search and forget commands.

Files

Just SKILL.md in integrations/pi-agent-plugin/skills/status of mem0ai/mem0.

Open the folder on GitHubat commit b7ad69a

Compare with similar skills

Mem0 Health Check 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.

Mem0 Health Check compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Mem0 Health Check this skillmem0ai/mem0	67k	—	~650	Automated safety check: Pass	Apache-2.0	yesterday
Cognee Custom Pipelinestopoteretes/cognee	32k	—	~2.8k	Automated safety check: Pass	Apache-2.0	yesterday
LanceDB Memory Configuration GuideCortexReach/memory-lancedb-pro-skill	229	—	~14k	Automated safety check: Pass	None	6 mo ago
Ownmem Dashboardgrpcer/ownmem	423	—	~563	Automated safety check: Pass	Apache-2.0	2 days ago
Deep Agents Corelangchain-ai/langchain-skills	1.3k	1 repos	~3.1k	Automated safety check: Pass	MIT	3 days ago
Compact Memory Implementationsimbajigege/book2skills	184	—	~2.5k	Automated safety check: Pass	MIT	1 mo ago

Similar skills

Cognee Custom Pipelines
topoteretes/cognee
Shows how to write custom cognee tasks, chain them into pipelines, store custom DataPoints and run enrichment over the existing graph.
32k GitHub stars~2.8k tokensUpdated yesterday
AI & LLM EngineeringAuto-check passed
LanceDB Memory Configuration Guide
CortexReach/memory-lancedb-pro-skill
Walks through installing and tuning memory-lancedb-pro, picking an embedding, reranker, and LLM combination from four preset configuration plans.
229 GitHub stars~14k tokensUpdated 6 mo ago
AI & LLM EngineeringAuto-check passed
Ownmem Dashboard
grpcer/ownmem
Open OwnMem Console, the local dashboard for this repository's memory.
423 GitHub stars~563 tokensUpdated 2 days ago
AI & LLM EngineeringAuto-check passed
Deep Agents Core
langchain-ai/langchain-skills
Official
Explains how to build agents with the Deep Agents framework: create_deep_agent, the built-in middleware, the harness, SKILL.md format and configuration options.
1.3k GitHub starsUsed in 1 repo~3.1k tokens
AI & LLM EngineeringAuto-check passed
Compact Memory Implementation
simbajigege/book2skills
A developer guide to adding compact memory to an agent: when to trigger compaction, how to fork a compactor sub-agent, what the summary holds, and how to restore it.
184 GitHub stars~2.5k tokensUpdated 1 mo ago
AI & LLM EngineeringAuto-check passed
Cognee Memory Recall
topoteretes/cognee
Explains how to query cognee agent memory with recall(): how the search type is chosen, how to narrow a query to datasets, and what the returned results contain.
32k GitHub stars~2.6k tokensUpdated yesterday
AI & LLM EngineeringAuto-check passed

Questions about Mem0 Health Check

What does Mem0 Health Check do?

Runs four checks on a Mem0 plugin, API key, identity resolution, search connectivity and a write probe, then reports pass or fail for each with a troubleshooting section on failure. The skill runs every check and shows one summary rather than stopping at the first failure. It verifies the API key is configured from MEM0_API_KEY or a config file and shows only its first six characters, reports the resolved user_id, project_id and session_id, calls the mem0_memory tool with a search action to confirm connectivity, and calls it again with an add action to confirm it can write, cleaning up the probe memory afterward.

When should I use Mem0 Health Check?

Mem0 Health Check fits situations like: memory searches are returning empty and you want to know why; verifying the Mem0 plugin is configured correctly after setup; running a deeper scan for duplicate or contradictory memories.

How do I install Mem0 Health Check in Claude Code?

Run `npx skills add mem0ai/mem0 --skill status -a claude-code`. Or copy the skill folder (integrations/pi-agent-plugin/skills/status in mem0ai/mem0) into .claude/skills/status in your project. Claude Code loads it when a task matches its description.

How do I install Mem0 Health Check in Codex?

Run `npx skills add mem0ai/mem0 --skill status -a codex`. Or copy the skill folder (integrations/pi-agent-plugin/skills/status in mem0ai/mem0) into .agents/skills/status in your project. Codex loads it when a task matches its description.

Can I use Mem0 Health Check 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 mem0ai/mem0 --skill status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/status, .gemini/skills/status, .github/skills/status and .opencode/skills/status in your project.

What does Mem0 Health Check need to run?

Going by SKILL.md and its folder, Mem0 Health Check needs credentials named MEM0_API_KEY. Our summary lists: A configured MEM0_API_KEY or mem0-config.json; The mem0_memory tool available to the agent.

Does Mem0 Health Check 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 Mem0 Health Check 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 Mem0 Health Check use?

Mem0 Health Check 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 Mem0 Health Check use?

About 650 tokens (SKILL.md is roughly 2.6k 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 Mem0 Health Check?

Skills that share tags, products or a category with Mem0 Health Check: Cognee Custom Pipelines (topoteretes/cognee, 32k stars), LanceDB Memory Configuration Guide (CortexReach/memory-lancedb-pro-skill, 229 stars), Ownmem Dashboard (grpcer/ownmem, 423 stars) and Deep Agents Core (langchain-ai/langchain-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mem0 Health Check?

mem0ai (a GitHub organization) maintains it in mem0ai/mem0, which has 66,788 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 7, 2026.

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

Install Mem0 Health Check

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Health Check / Status

Execution

Check 1: API key

Check 2: Identity resolution

Check 3: Connectivity

Check 4: Memory write capability

Display

Extended mode: Memory Quality Analysis

Quality Check 1: Duplicates

Quality Check 2: Stale memories

Quality Check 3: Contradictions

Quality summary

Files

Compare with similar skills

Similar skills

More from mem0ai/mem0

Related

Questions about Mem0 Health Check