← Back to Skills Marketplace
84
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install memory-semantic-search
Description
Semantic search over workspace markdown files using embedding API + SQLite vector store. Use when: (1) searching workspace notes/memory by meaning rather tha...
Usage Guidance
This skill appears to implement a legitimate local Markdown semantic-search tool, but take these precautions before installing/using it:
- Expect to provide an embeddings API key (EMBEDDING_API_KEY); the registry metadata omitted this — verify environment requirements before trusting the package.
- By default it will send the full text of your Markdown chunks to the configured embedding endpoint (default: https://api.openai.com/v1). Only use a provider you trust, or configure a self-hosted/enterprise-compatible embedding endpoint if your notes are sensitive.
- Avoid indexing secrets or credentials. Use a workspace path that excludes sensitive files, or add exclusions before running index.py.
- Consider setting --db to a controlled path (not a global skill directory) and protect that SQLite file appropriately.
- Review/verify EMBEDDING_API_BASE if you need embeddings to stay in your environment (e.g., Ollama, internal proxy). If you need privacy guarantees, confirm the embedding provider’s retention policy.
- The main technical inconsistency is the missing declared env vars in the registry; if this skill will run in an automated agent environment, confirm the platform will surface the required API key prompt before the skill runs.
If you want me to, I can: (1) point out the exact lines that transmit data to the network, (2) suggest a small patch to redact or exclude sensitive files before indexing, or (3) show how to change the default DB path and embedding base in the code.
Capability Analysis
Type: OpenClaw Skill
Name: memory-semantic-search
Version: 1.0.0
The skill bundle provides a legitimate semantic search utility for markdown files using Python's standard library. It indexes workspace content into a local SQLite database and uses a user-configured OpenAI-compatible API for generating embeddings (scripts/index.py and scripts/search.py). The behavior is transparent, well-documented, and strictly follows the stated purpose without any signs of malicious intent, obfuscation, or prompt injection.
Capability Tags
Capability Assessment
Purpose & Capability
The name/description (semantic search over workspace Markdown) matches the included code and instructions: index.py scans .md files, chunks them, calls an OpenAI-compatible embeddings endpoint, and stores vectors in SQLite for search. However, the registry metadata lists no required environment variables while the SKILL.md and scripts clearly expect EMBEDDING_API_KEY (and optionally EMBEDDING_API_BASE / EMBEDDING_MODEL). That omission in the metadata is an inconsistency.
Instruction Scope
SKILL.md and the scripts limit actions to scanning .md files in a provided workspace, chunking, calling an embeddings API, storing embeddings in a local SQLite DB, and performing local cosine-similarity search. There are no instructions to read unrelated system files or other credentials. NOTE: the runtime does transmit Markdown content to the configured embedding API endpoint, which is expected for this purpose but important to be aware of.
Install Mechanism
This is an instruction-only skill with shipped Python scripts and no install spec; nothing is downloaded at install time. That minimizes install-time risk. The code uses only Python stdlib and will be run locally.
Credentials
The scripts require EMBEDDING_API_KEY (and optionally EMBEDDING_API_BASE and EMBEDDING_MODEL). The registry metadata claims no required env vars — that is inconsistent. Also, by design the skill sends full Markdown chunks to the embedding API (default EMBEDDING_API_BASE is https://api.openai.com/v1). Sending sensitive notes to an external provider can expose data (some embedding providers log/retain inputs). The requested credential (API key) is proportional to the feature, but the lack of declared required env vars in the registry and the default external endpoint raise privacy/visibility concerns.
Persistence & Privilege
The skill does not request elevated privileges and always=false. It writes a SQLite DB file by default to the skill parent directory (memory_search.sqlite) unless a custom --db is provided; this is normal but the user should be aware of where indexed content is stored. It does not modify other skills or system-wide configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install memory-semantic-search - After installation, invoke the skill by name or use
/memory-semantic-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of memory-semantic-search: semantic search for workspace markdown files
- Supports indexing and searching `.md` files by meaning using OpenAI-compatible embedding APIs and SQLite vector storage
- Environment variables/CLI for API key, base URL, and model selection
- Indexing tool: incremental, tracks changes and cleans up deleted files
- Search tool: configurable top-k results, score threshold, and JSON output
- Designed for semantic recall of notes, related content, and decisions in markdown—excludes non-markdown, web, or code search
Metadata
Frequently Asked Questions
What is Memory Semantic Search?
Semantic search over workspace markdown files using embedding API + SQLite vector store. Use when: (1) searching workspace notes/memory by meaning rather tha... It is an AI Agent Skill for Claude Code / OpenClaw, with 84 downloads so far.
How do I install Memory Semantic Search?
Run "/install memory-semantic-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Memory Semantic Search free?
Yes, Memory Semantic Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Memory Semantic Search support?
Memory Semantic Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Memory Semantic Search?
It is built and maintained by toller892 (@toller892); the current version is v1.0.0.
More Skills