← Back to Skills Marketplace
Obsidian Semantic Search
by
Maxime Roy (new.blacc)
· GitHub ↗
· v1.0.1
· MIT-0
228
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install obsidian-semantic-search
Description
Semantic search across your Obsidian vaults using local embeddings (Ollama + pgvector). 10 MCP tools: hybrid/semantic/keyword search, file CRUD, batch reads,...
Usage Guidance
This skill appears to implement what it claims (local semantic search) but has several mismatches and risky steps you should review before running: 1) SKILL.md asks you to run remote install scripts (curl | sh) — inspect those scripts on GitHub/astral.sh before executing or prefer cloning and running locally. 2) The registry only declared OBSIDIAN_VAULT, but the installer requires additional env vars (POSTGRES_PASSWORD, optional EMBEDDING_MODEL, OBSIDIAN_VAULTS). Provide only a database password you control; do not reuse other secret tokens. 3) The installer will run Docker containers and persist services that read your vault files — consider running initially in a disposable VM or containerized environment. 4) The instructions suggest writing into Claude Desktop's config files in your home directory; back up that config before modifying and only apply the suggested changes if you trust the repo. 5) If you want lower risk, manually git clone the repository, inspect install.sh and any Dockerfiles, and run the setup steps yourself rather than using piped installers. If you are not comfortable auditing the install scripts or exposing a local DB/service, treat this skill as higher-risk.
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-semantic-search
Version: 1.0.1
The skill bundle is classified as suspicious primarily because SKILL.md contains explicit instructions to ignore security warnings (VirusTotal) and use a `--force` flag, which is a common social engineering tactic to bypass detection. It also utilizes a high-risk installation method via `curl | bash` from an external GitHub repository (celstnblacc/obsidian-semantic-mcp). While the tools for semantic search and vault management are consistent with the stated purpose, the attempt to preemptively discredit security alerts and the use of unverified remote scripts present a significant security risk.
Capability Assessment
Purpose & Capability
The stated goal—local semantic search of an Obsidian vault using Ollama + pgvector—fits the required use of Docker, Python, and a vault path. However the registry metadata and SKILL.md disagree: SKILL.md expects additional services (Postgres, Ollama, a dashboard) and tools (osm CLI, uv installer) that are not fully reflected in the declared requirements. Requiring 'uv' as a binary is unusual but explained by the SKILL.md installer. Overall capability is coherent but the declared requirements are incomplete.
Instruction Scope
The SKILL.md tells users to run remote install commands (curl|bash), clone a GitHub repo, bootstrap services in Docker, and it instructs adding entries to another application's config file (Claude Desktop JSON in user home). It also references environment variables (POSTGRES_PASSWORD, EMBEDDING_MODEL, OBSIDIAN_VAULTS, DASHBOARD_PORT) that are not listed in the registry metadata. The instructions will read and index user files (expected) but also write configuration into other app paths (modifying Claude Desktop config), which is outside a simple search tool's internal state and increases risk.
Install Mechanism
There is no formal install spec in the registry; the SKILL.md instructs executing remote installers: an install.sh from raw.githubusercontent.com and downloading an installer from astral.sh (uv). Running curl ... | sh is a high-risk pattern because it executes code fetched at runtime. The GitHub raw URL is a well-known host (lower risk than an unknown host) but the astral.sh host is a separate domain. The process will pull and run Docker containers and create persistent services.
Credentials
Declared required env in registry is only OBSIDIAN_VAULT, but SKILL.md requires/mentions several additional env vars (POSTGRES_PASSWORD is marked 'Yes (Docker)', OBSIDIAN_VAULTS, EMBEDDING_MODEL, RERANK_MODEL, DASHBOARD_PORT). The skill also references file-system paths and suggests editing Claude Desktop's config file — these are broader privileges than the simple registry declaration implies. Asking for a database password and the ability to run Docker is proportionate to running a local DB, but the mismatch between declared and used envs is a red flag.
Persistence & Privilege
The skill does not set always:true and defaults to allowing model invocation, which is normal. However the installation creates persistent services (Docker containers, PostgreSQL, watcher) and instructs edits to another application's configuration (Claude Desktop). Persisting services and modifying other app configs combined with the remote-install pattern increases the blast radius if something goes wrong.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-semantic-search - After installation, invoke the skill by name or use
/obsidian-semantic-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Add VirusTotal false positive note to troubleshooting
v1.0.0
Initial release of Obsidian Semantic Search.
- Provides semantic, hybrid, and keyword search across Obsidian vaults using local embeddings (Ollama + pgvector)
- Offers 10 MCP tools for search, file management, batch operations, live re-indexing, and monitoring
- Fully local and privacy-focused—no API keys, no cloud, zero cost
- Includes a real-time monitoring dashboard and search testing UI
- Supports both Docker and native (macOS/Linux) installation options, with multi-vault support
Metadata
Frequently Asked Questions
What is Obsidian Semantic Search?
Semantic search across your Obsidian vaults using local embeddings (Ollama + pgvector). 10 MCP tools: hybrid/semantic/keyword search, file CRUD, batch reads,... It is an AI Agent Skill for Claude Code / OpenClaw, with 228 downloads so far.
How do I install Obsidian Semantic Search?
Run "/install obsidian-semantic-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Semantic Search free?
Yes, Obsidian Semantic Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Semantic Search support?
Obsidian Semantic Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Semantic Search?
It is built and maintained by Maxime Roy (new.blacc) (@celstnblacc); the current version is v1.0.1.
More Skills