Obsidian - read, search, write and edit direct to obsidian vault.
by RuslanLanket · v1.0.0
Productivity
ClawHub
7.6
/ 10
1 evaluations
4.6k Downloads
Overview
Provide an Obsidian-aware knowledge base interface for agents: fuzzy/phonetic search across a local vault and safe-ish create/read/edit operations on Markdown notes (with frontmatter, tags, and wikilinks).
Key Advantages
1.Tight Obsidian alignment: understands standard vault layout, frontmatter (created/modified/tags/aliases), wikilinks, folders, and tags.
2.Powerful search: ripgrep-based fuzzy and phonetic (RU↔EN) search over titles, tags, and content with scored results and matched context, suitable for retrieval-augmented answering.
3.Rich note editing model: append, prepend, full replace, and section-level replace operations allow structured edits instead of brittle raw-text manipulation.
4.Auto-organization support: auto-folder detection and suggest-folder capabilities help agents place new notes sensibly without hard-coded paths.
5.End-to-end workflows: supports querying, citing notes in answers ([[Note Name]]), saving new content, and updating existing notes based on user instructions, all via a CLI-friendly JSON interface.
Use Cases
- Use the Obsidian vault as a long-term knowledge base for Q&A: search notes, read top matches, and answer user questions while citing source notes with wikilinks.
- Capture new information from chats or documents as Obsidian notes, with auto-folder selection and appropriate tags added based on content.
- Refine and maintain existing notes: summarize, shorten, or rewrite notes by reading then replacing content or specific sections on user request.
- Augment notes with new sections (e.g., Conclusions, Summary, Next Steps) using section-level replace/insert patterns.
- Explore vault structure: list notes and folders, inspect tags, and examine incoming/outgoing links for a given note to surface related material.
Evaluation Scores
7.6
/ 10
Reliability
7.4
Functionality
8.6
Usability
7.2
Safety
6.6
Performance
9.0
Compatibility
7.5
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
7.6/103/19/2026▼
OS: darwin-x64LLM: deepseek/deepseek-v3.2
**Judgement:** This skill is a strong choice for users who already maintain an Obsidian vault on the same machine and want an agent to treat it as a first-class knowledge base. It offers robust search and structured editing tailored to Obsidian conventions, making it more reliable than generic file-editing skills for this niche.
**Key strengths:**
- Obsidian-native model (vault structure, frontmatter, tags, wikilinks) rather than generic markdown handling.
- Fast and capable search (ripgrep + fuzzy/phonetic) across titles, tags, and content, suitable for retrieval-augmented answering.
- Structured edit operations (append/prepend/replace/replace-section) that map well to typical note-edit workflows.
- Support for auto-folder detection and folder suggestions, reducing hard-coded path logic.
**Main risks / limitations:**
- **Destructive edits:** `replace` and `replace-section` can overwrite content; if the agent hallucinates or misinterprets instructions, valuable notes may be damaged. Agents should be prompted to: (a) read notes before major edits, (b) confirm with the user for large or irreversible changes, and (c) prefer append/prepend for low-risk modifications.
- **Privacy/authority scope:** The skill exposes the entire vault to the agent. On sensitive vaults, this is a data-leak risk if the agent is not carefully permissioned or if logs are stored externally.
- **Environment assumptions:** Correct function depends on the vault path and `OBSIDIAN_VAULT` being configured properly. Misconfiguration will cause failures or work on an unexpected vault.
- **Obsidian-local only:** It operates on a local filesystem vault; it does not manage remote sync, conflicts, or Obsidian plugins.
**Recommended scenarios:**
- Power users using Obsidian as a personal or team knowledge base, who want an agent to search, cite, and update notes safely.
- Workflows where the agent turns chat sessions, research results, or documents into well-organized Obsidian notes with tags and wikilinks.
- Incremental note-refinement tasks (summarizing notes, adding conclusions sections, updating project status) where reading-then-editing individual notes is acceptable.
**Less ideal scenarios:**
- Highly sensitive vaults where any broad programmatic access is unacceptable without strong sandboxing and audit trails.
- Situations requiring complex, multi-file refactors or bulk transformations across the vault (the skill can be used, but risk of unintended large-scale changes increases and should be tightly constrained).
Comments (0)
No comments yet. Be the first!