← Back to Skills Marketplace
Obsidian Sync KB
by
PANGKAIFENG
· GitHub ↗
· v0.1.0
· MIT-0
112
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install obsidian-sync-kb
Description
Build a searchable local knowledge base from an Obsidian vault's "笔记同步助手" inbox, then answer with citations, topic cards, update logs, and daily digests for...
Usage Guidance
This skill appears to do what it says, but review and test before pointing it at sensitive notes. It will create files in your Obsidian vault (Research/… directories) and maintain local state/artifacts under the skill folder — back up your vault first. If you are concerned about data leakage, run build-index with --disable-network (or set enable_network to false in config) to avoid external fetches. Inspect scripts/kb_tool.py (network calls, where content is written, and any outbound requests) before use; the code is included so you can audit it. Note: the code contains minor bugs (e.g., a likely typo in normalize_whitespace) suggesting it may be lightly tested — run on a copy of your vault first and check logs/output for unexpected behavior.
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-sync-kb
Version: 0.1.0
The obsidian-sync-kb skill is a sophisticated RAG (Retrieval-Augmented Generation) tool designed to index and query an Obsidian vault's sync inbox. The core logic in scripts/kb_tool.py implements a local knowledge base using SQLite (FTS5) and a custom TF-IDF vector index, with features for text cleaning, chunking, and 'research' (enriching notes by fetching external URLs or searching DuckDuckGo). The code follows security best practices such as using yaml.safe_load and parameterized SQL queries. While it possesses network and file system access, these capabilities are transparently documented and strictly aligned with the stated purpose of building a searchable knowledge base from user notes. No indicators of data exfiltration, persistence, or prompt injection were found.
Capability Assessment
Purpose & Capability
Name/description match the implementation: scripts read an Obsidian vault inbox, normalize notes, chunk them, build an index, and produce research/topic cards and digests. Required permissions and resources declared (vault path or env var) are proportionate to the stated purpose.
Instruction Scope
SKILL.md only instructs running the included Python scripts and documents an explicit --disable-network option. The code will write files into the vault (Research/… directories) and into local artifacts/state directories — this is consistent with 'build topic cards and update logs' but users should be aware that the skill modifies the vault by creating research artifacts.
Install Mechanism
No install spec; this is instruction- and script-based (python). That is lowest install risk. The scripts are included in the bundle rather than downloaded from arbitrary URLs.
Credentials
No credentials or unrelated environment variables requested. The only optional env var referenced is OBSIDIAN_SYNC_KB_VAULT to set the vault root, which is appropriate.
Persistence & Privilege
always:false and no requests to alter other skills or system-wide agent config. The skill persists state and artifacts under its own directories and writes research files into user-specified vault paths — expected for its function.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-sync-kb - After installation, invoke the skill by name or use
/obsidian-sync-kb - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial public release
Metadata
Frequently Asked Questions
What is Obsidian Sync KB?
Build a searchable local knowledge base from an Obsidian vault's "笔记同步助手" inbox, then answer with citations, topic cards, update logs, and daily digests for... It is an AI Agent Skill for Claude Code / OpenClaw, with 112 downloads so far.
How do I install Obsidian Sync KB?
Run "/install obsidian-sync-kb" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Sync KB free?
Yes, Obsidian Sync KB is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Sync KB support?
Obsidian Sync KB is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Sync KB?
It is built and maintained by PANGKAIFENG (@pangkaifeng); the current version is v0.1.0.
More Skills