← Back to Skills Marketplace
Obsidian Notes
by
zhangzhifeng
· GitHub ↗
· v1.0.1
· MIT-0
312
Downloads
0
Stars
4
Active Installs
2
Versions
Install in OpenClaw
/install obsidian-notes
Description
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Usage Guidance
This skill appears to do what it says (manage Obsidian vaults via obsidian-cli) but take a few precautionary steps before installing: 1) Verify you actually run this on macOS (the SKILL.md references a macOS-specific config path). 2) Inspect the Homebrew formula in the yakitrak tap (third‑party) to ensure it installs what you expect and doesn't run unexpected post-install actions. 3) Understand that the skill (and obsidian-cli) will read your Obsidian config and note files (which may contain sensitive information); only run it if you trust the environment and the formula. 4) Consider running the brew install and a few obsidian-cli commands manually in a controlled session first to confirm behavior. If you want higher assurance, request the exact brew formula source or an official upstream package before installing.
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-notes
Version: 1.0.1
The skill provides legitimate instructions and documentation for managing Obsidian vaults using the 'obsidian-cli' tool. It outlines standard procedures for locating vault paths via the official Obsidian configuration file (~/Library/Application Support/obsidian/obsidian.json) and performing common note-taking tasks like searching, creating, and moving files. No malicious code, data exfiltration, or suspicious prompt-injection patterns were found.
Capability Assessment
Purpose & Capability
The name/description match the runtime instructions: the skill expects and uses obsidian-cli and works with Obsidian vaults. Minor mismatch: the SKILL.md instructs the agent to read a user config file (~/Library/Application Support/obsidian/obsidian.json) but the skill metadata did not declare any required config paths or OS restriction (the path is macOS-specific).
Instruction Scope
Instructions are focused on Obsidian operations (search, create, move, delete) and explicitly recommend reading the Obsidian config to discover vaults. This requires reading a user-specific file in the home directory; that is expected for the purpose but should have been declared in metadata. There are no instructions that exfiltrate data or call external endpoints beyond normal obsidian-cli/URI behavior.
Install Mechanism
Install uses a Homebrew formula (yakitrak/yakitrak/obsidian-cli). Brew installs are lower risk than arbitrary downloads, but this is a third‑party tap (yakitrak) rather than an official vendor tap; you should inspect the formula/source before trusting it.
Credentials
The skill declares no required environment variables or credentials, which is appropriate. It does access a user config file (vault paths) as part of normal operation; this is proportional to its purpose but was not listed under required config paths in the metadata (a minor coherence issue).
Persistence & Privilege
The skill is not always-enabled and does not request persistent or elevated platform privileges. It does not modify other skills or system-wide configs according to the provided files.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-notes - After installation, invoke the skill by name or use
/obsidian-notes - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Fixed typographical inconsistencies in documentation (apostrophe and quote usage)
- No functional changes; only documentation has been updated for clarity and consistency
v1.0.0
Initial release of obsidian-notes skill: work with Obsidian vaults via obsidian-cli.
- Supports interacting with Obsidian vaults (plain Markdown folders).
- Provides guidance on locating and selecting active Obsidian vaults.
- Documents key obsidian-cli commands: searching, note creation, moving/renaming, and deletion.
- Emphasizes safe automation via obsidian-cli for vault management.
Metadata
Frequently Asked Questions
What is Obsidian Notes?
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli. It is an AI Agent Skill for Claude Code / OpenClaw, with 312 downloads so far.
How do I install Obsidian Notes?
Run "/install obsidian-notes" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Notes free?
Yes, Obsidian Notes is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Notes support?
Obsidian Notes is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Notes?
It is built and maintained by zhangzhifeng (@164149043); the current version is v1.0.1.
More Skills