← Back to Skills Marketplace
101
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install obsidian-assistant
Description
Obsidian 知识管理专家助手(黑曜石助手)。当用户提到 Obsidian、知识库、笔记、vault、双向链接、标签整理、Dataview 查询、模板、知识图谱、MOC、每日笔记、Inbox 整理、笔记分类、Obsidian 插件配置、知识管理方法论(PARA/Zettelkasten/卡片盒),或者询问如何...
Usage Guidance
This skill mostly does what it claims (learns your Obsidian setup and produces templates), but you should be aware of a few things before installing:
- Privacy/persistence: the assistant stores a persistent profile (references/habit-patterns.md) containing your Vault path, directory layout, plugin list, high-frequency operations, and other metadata. Ask where that file is stored by the platform, who can read it, and how to delete it. If you don't want that data persisted, decline or refuse to provide sensitive details.
- CLI/command inconsistency: the README mentions using the Obsidian CLI, but the skill doesn't declare any required binaries. Clarify whether the agent will attempt to run CLI commands (which would require execution privileges) or whether you must paste command outputs yourself.
- Tool permissions: the SKILL.md references a 'replace_in_file' tool to update profiles. Confirm whether that tool exists in your environment and what filesystem access it has. If you are not comfortable with automatic writes, request that changes be previewed and approved before being saved.
- Data you paste: avoid pasting secret content (API tokens, SSH keys, full file contents you don't want stored). Directory listings and file names can reveal sensitive structure; consider redacting paths if needed.
- When in doubt: ask the skill author (or the platform) to confirm: (1) does the assistant ever send profile data to external servers (none is declared here), (2) where is the profile persisted, and (3) how can you fully remove all stored profile data if you uninstall the skill.
Given the persistent-memory design and the undeclared reliance on tools/CLI, proceed only if you accept the privacy trade-offs and have clarified the above points.
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-assistant
Version: 1.0.0
The skill functions as an automated Obsidian vault assistant that proactively maps the user's file system and records usage habits. It utilizes risky capabilities including direct file system access (reading/writing notes) and shell command execution (e.g., 'find', 'ls') to analyze vault structures and metadata. While these actions are aligned with the stated purpose of workflow optimization, the automated collection and persistence of user data into 'references/habit-patterns.md' and the broad access to personal knowledge bases constitute high-risk behaviors that warrant a suspicious classification under the provided guidelines.
Capability Assessment
Purpose & Capability
The skill claims to map and analyze an Obsidian vault and to produce templates/macros, which fits the requested behavior. However the README mentions proactively using the Obsidian CLI (e.g., `obsidian vaults`, `obsidian tags`), yet the skill declares no required binaries or runtime dependencies. That is an inconsistency: either the skill expects the platform/agent to run Obsidian CLI commands (not declared) or it expects the user to supply command outputs manually. This mismatch should be clarified.
Instruction Scope
SKILL.md instructs the assistant to read and continually update local profile files (references/habit-patterns.md and references/obsidian-concepts.md) and to ask the user for vault path, directory listings, plugin lists, or `find` outputs. Those actions are in-scope for an Obsidian assistant. Two points to note: (1) it explicitly requires use of a 'replace_in_file' tool for updating the profile—this external tool is referenced but not declared or explained; (2) the skill expects the user to provide directory listings or other outputs which may contain sensitive filenames or metadata. The instructions do not request unrelated system secrets, but they do enable the assistant to collect and persist detailed vault metadata.
Install Mechanism
This is an instruction-only skill with no install spec and no code files to execute; that minimizes install-time risk. The regex scanner had no code to analyze.
Credentials
The skill requests no environment variables or credentials (good). It does, however, collect potentially sensitive user data (Vault path, plugin list, directory structure, sample file listings, notes about workflows) and persists these in references/habit-patterns.md. Collecting this metadata is proportional to the declared purpose, but the privacy impact is non-trivial and should be considered before consenting to persistent storage.
Persistence & Privilege
The skill is designed to maintain a persistent profile of the user's vault inside the skill's own files and explicitly instructs the agent to 'update' references/habit-patterns.md after interactions using a replace_in_file tool. Persisting user-specific vault metadata inside the skill package raises privacy concerns (where and how is this stored; who can access or remove it). The skill does not request system-wide permissions or other skills' credentials, but automatic, ongoing write/append behavior to the skill's files is a privilege the user should accept knowingly.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-assistant - After installation, invoke the skill by name or use
/obsidian-assistant - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: personalized Obsidian assistant focused on habit learning, workflow optimization, and template extraction.
- Provides structured guidance for capturing and updating user Obsidian habits, knowledge base structure, tags, and workflow patterns.
- Introduces workflows for user habit collection, personalized Q&A, extracting reusable templates/macros/SOPs, and knowledge base health diagnostics.
- Bundles ready-to-use templates for daily notes, project notes, and book notes.
- Maintains user habit archive in `references/habit-patterns.md`, enabling progressive personalization.
- Answers and suggestions adapt to user’s real setup, plugins, and habitual operations.
Metadata
Frequently Asked Questions
What is Obsidian Assistant?
Obsidian 知识管理专家助手(黑曜石助手)。当用户提到 Obsidian、知识库、笔记、vault、双向链接、标签整理、Dataview 查询、模板、知识图谱、MOC、每日笔记、Inbox 整理、笔记分类、Obsidian 插件配置、知识管理方法论(PARA/Zettelkasten/卡片盒),或者询问如何... It is an AI Agent Skill for Claude Code / OpenClaw, with 101 downloads so far.
How do I install Obsidian Assistant?
Run "/install obsidian-assistant" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Assistant free?
Yes, Obsidian Assistant is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Assistant support?
Obsidian Assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Assistant?
It is built and maintained by ltryee (@ltryee); the current version is v1.0.0.
More Skills