How do I install the Simplemem Skill skill?

Run npx skillmds@latest add tomevault-io/simplemem-skill in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Simplemem Skill safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Simplemem Skill?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Simplemem Skill free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Simplemem Skill?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Simplemem Skill by tomevault-io — Agent Skill

Name: Simplemem Skill
Author: tomevault-io

Simplemem Skill

Store and retrieve conversation memories across sessions. Use when asked to 'remember this', 'save conversation', 'add to memory', 'what did we discuss about...', 'query memories', or 'import chat history'. Also use proactively to preserve important dialogue context and decisions. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

SimpleMem Skill

Persistent conversational memory across sessions.

Proactive Usage

Save memories when discovering valuable dialogue:

Important decisions or commitments made in conversation
Complex information that may be referenced later
Context from long discussions worth preserving
Solutions to problems that took effort to uncover

Check memories before:

Answering questions about past conversations
Resuming work from previous sessions
Building on earlier discussion topics

Quick Start

# Add a dialogue
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Meet Bob tomorrow at 2pm"

# Query memories
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "When should Alice meet Bob?"

Operations

Save

Add single dialogue:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "User" --content "Your message here"

With timestamp (ISO 8601):

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Message" --timestamp "2026-01-17T14:00:00Z"

Query

Semantic query with answer:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "What did Alice say about meetings?"

With reflection for deeper analysis:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "Your question" --enable-reflection

Raw retrieval:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py retrieve --query "Alice meetings" --top-k 5

Maintain

View statistics:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py stats

Clear all memories:

# Use with caution - irreversible
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py clear --yes

Batch Import

For importing conversation histories from JSONL files, see references/import-guide.md.

Custom Table Names

Use different tables to organize conversation contexts:

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py --table-name my_custom_table add --speaker "User" --content "Message"

Data Format

All dialogues are stored with:

speaker: Who said it (string)
content: What was said (string)
timestamp: When it was said (ISO 8601 datetime, auto-generated if omitted)

Advanced Usage

For detailed information:

OpenRouter setup and model selection: references/openrouter-guide.md
JSONL import format and batch operations: references/import-guide.md
CLI command reference: references/cli-reference.md
System architecture and configuration: references/architecture.md

Setup

Install dependencies:

cd ~/.claude/skills/simplemem-skill
pip install -r requirements.txt

Configure OpenRouter API:

cp src/config.py.example src/config.py
# Edit src/config.py and set your OPENROUTER_API_KEY

See references/openrouter-guide.md for API key setup and model customization.

Data storage: Memories persist in data/lancedb/ (auto-created).

Source: MinghoKwok/MemEye — distributed by TomeVault.

---name: simplemem-skilldescription: Store and retrieve conversation memories across sessions. Use when asked to 'remember this', 'save conversation', 'add to memory', 'what did we discuss about...', 'query memories', or 'import chat history'. Also use proactively to preserve important dialogue context and decisions. Use when this capability is needed.---# SimpleMem SkillPersistent conversational memory across sessions.## Proactive UsageSave memories when discovering valuable dialogue:- Important decisions or commitments made in conversation- Complex information that may be referenced later- Context from long discussions worth preserving- Solutions to problems that took effort to uncoverCheck memories before:- Answering questions about past conversations- Resuming work from previous sessions- Building on earlier discussion topics## Quick Start```bash# Add a dialoguepython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Meet Bob tomorrow at 2pm"# Query memoriespython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "When should Alice meet Bob?"```## Operations### SaveAdd single dialogue:```bashpython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "User" --content "Your message here"```With timestamp (ISO 8601):```bashpython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Message" --timestamp "2026-01-17T14:00:00Z"```### QuerySemantic query with answer:```bashpython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "What did Alice say about meetings?"```With reflection for deeper analysis:```bashpython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "Your question" --enable-reflection```Raw retrieval:```bashpython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py retrieve --query "Alice meetings" --top-k 5```### MaintainView statistics:```bashpython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py stats```Clear all memories:```bash# Use with caution - irreversiblepython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py clear --yes```## Batch ImportFor importing conversation histories from JSONL files, see [references/import-guide.md](references/import-guide.md).## Custom Table NamesUse different tables to organize conversation contexts:```bashpython ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py --table-name my_custom_table add --speaker "User" --content "Message"```## Data FormatAll dialogues are stored with:- `speaker`: Who said it (string)- `content`: What was said (string)- `timestamp`: When it was said (ISO 8601 datetime, auto-generated if omitted)## Advanced UsageFor detailed information:- **OpenRouter setup and model selection**: [references/openrouter-guide.md](references/openrouter-guide.md)- **JSONL import format and batch operations**: [references/import-guide.md](references/import-guide.md)- **CLI command reference**: [references/cli-reference.md](references/cli-reference.md)- **System architecture and configuration**: [references/architecture.md](references/architecture.md)## Setup**Install dependencies**:```bashcd ~/.claude/skills/simplemem-skillpip install -r requirements.txt```**Configure OpenRouter API**:```bashcp src/config.py.example src/config.py# Edit src/config.py and set your OPENROUTER_API_KEY```See [references/openrouter-guide.md](references/openrouter-guide.md) for API key setup and model customization.**Data storage**: Memories persist in `data/lancedb/` (auto-created).---> Source: [MinghoKwok/MemEye](https://github.com/MinghoKwok/MemEye) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions