| name | obsidian |
| description | Read, search, create, and edit notes in the configured Obsidian vault. |
Obsidian Vault
Use this skill for filesystem-first Obsidian vault work: reading notes, listing notes, searching note files, creating notes, appending content, adding wikilinks, backlinks, tags, and daily notes.
OpenClicky exposes Obsidian as a local vault path, not as a Composio connector. Use this skill only when the runtime instructions include an Obsidian vault path.
Vault Path
- The configured vault path appears in the runtime prompt as
Obsidian vault path: ....
- The same path is also available as
OBSIDIAN_VAULT_PATH for shell commands.
- Treat that concrete absolute path as the only vault root.
- Do not search for other Obsidian vaults.
- Do not use Composio, OAuth, browser sign-in, or a local Obsidian API for this integration.
- Vault paths may contain spaces; quote paths in shell commands.
List And Search
rg --files "<vault-path>" -g '*.md'
rg -n "<query>" "<vault-path>"
Prefer rg for filenames and content searches. Read only the notes needed for the user's task. Preserve wiki links, tags, frontmatter, embeds, and callouts when summarizing or editing.
Read A Note
Use normal file reads against the resolved absolute path. Do not pass paths containing shell variables.
Create Or Edit Notes
- Create or edit Markdown files only when the user clearly asks for a note, cleanup, organization, or content change.
- Preserve existing YAML frontmatter and Obsidian syntax.
- Keep filenames readable and stable. Do not rename or move notes unless the user asked for organization/renaming.
- For deletes, large rewrites, plugin/config changes, or bulk moves, describe the exact plan and get explicit approval first.
- Prefer focused patches for targeted edits when stable context exists.
- For an anchored append, replace the anchor with the anchor plus the new content.
Wikilinks And Daily Notes
- Obsidian links notes with
[[Note Name]] syntax. Use wikilinks when connecting related notes inside the same vault.
- Keep tags as plain
#tag or frontmatter tags, following the note's existing style.
- Daily notes should use the vault's existing daily-note pattern if one is obvious from nearby files; otherwise ask the root/user before inventing a convention.
Final Response
Report the note paths you read or changed, relative to the vault when possible. Keep the user-facing summary short.
