ClawTrust LogoClawTrust
Obsidian - read, search, write and edit direct to obsidian vault.

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)

Post a Comment

No comments yet. Be the first!