| name | obsidian |
| description | Read, write, and search Obsidian vault markdown files |
| metadata | {"clawdbot":{"emoji":"📝"}} |
Obsidian Skill
Interact with Obsidian vaults by reading, writing, and searching markdown files.
For OnyxVault, all writes must obey the Vault Architect Directive in:
~/Obsidian/YourVault/08 - System/Agent Directives/Vault Architect Directive.md.
This means:
- Respecting the project bundle structure (Overview, Kanban, Knowledge, Docs Hub, Docs, Phases).
- Preserving YAML frontmatter and navigation blocks.
- Using the Docs Hub + Docs/ patterns for project docs.
Whenever possible, let higher-level skills (higher-level orchestration layers) decide what to write; this skill is the IO layer that executes those decisions.
How Obsidian Works
Obsidian stores all notes as markdown files in a vault folder. This skill provides direct file access to those notes.
Usage
Read a note
Read the note "Project Ideas" from my vault
Create or update a note
Create a note called "Daily Notes - 2026-01-28" with content:
## Today's Tasks
- [ ] Call Sarah about the project
- [ ] Review pull requests
Search notes
Search my vault for notes containing "project proposal"
List all notes
List all notes in my vault
Vault Location
Canonical OnyxVault path:
If you want a different vault, explicitly specify its path.
When used in the ONYX Orchestrator context, this skill is the main interface for:
- Reading project bundles (Overview/Kanban/Knowledge/Docs Hub/Docs/Phases)
- Checking/syncing vault structure against the codebase
- Writing and updating notes according to the Vault Architect Directive
Higher‑level skills (higher-level orchestration layers) should call this skill for all vault IO rather than manipulating files directly.
Links
Obsidian supports [[wikilink]] syntax. When creating notes, use this format for internal links:
See [[Project Ideas]] for more details
Frontmatter
Many Obsidian notes include YAML frontmatter:
---
tags: [work, project]
status: active
---
This skill preserves frontmatter when reading and writing notes.name: obsidian
description: Read, write, and search Obsidian vault markdown files (canonical OnyxVault at ~/Obsidian/YourVault; other vaults only when explicitly specified)