HermesHub

Obsidian

A knowledge management skill sourced from ClawHub (49k+ downloads, 194 stars, by steipete). Provides programmatic access to Obsidian vaults (plain Markdown files) via the obsidian-cli tool.

81Trust Medium
by steipeteproductivityintermediatev1.0.0updated Mar 9, 2026
15.6kTotal Runs
87.0%Success Rate
1.5kInstalls
81Trust Score

Tags

#obsidian#notes#markdown#knowledge-base#pkm#vault#clawhub

Required Tools

bashfile_readfile_write

Inputs

NameTypeDescriptionReq
vault_pathfilePath to the Obsidian vault root directory.yes
actiontextAction: "create", "search", "read", "append", "list", "link", "daily", "tags".yes
paramsjsonAction parameters as JSON. Varies by action.--

Outputs

NameTypeDescriptionReq
resultjsonJSON result — varies by action.yes

Compatible Skills

AI Paper Summarizerresearch
72
Summarizeresearch
88
HackerNews Scraperresearch
87
Markdown Report Generatorproductivity
91
Polymarketfinance
80

SKILL.md

---
name: obsidian
description: Work with Obsidian vaults (plain Markdown notes). Create, search, link, and organize notes. Automate knowledge management via obsidian-cli.
---

# Obsidian

Obsidian vault = a normal folder on disk.

## Vault Structure

Typical vault structure:
- Notes: *.md (plain text Markdown)
- Config: .obsidian/ (workspace + plugin settings)
- Canvases: *.canvas (JSON)
- Attachments: images/PDFs/etc.

## Find the Active Vault

Obsidian desktop tracks vaults here:
- ~/Library/Application Support/obsidian/obsidian.json

Fast "what vault is active / where are the notes?"
- If you've set a default: obsidian-cli print-default --path-only
- Otherwise, read obsidian.json and use the vault entry with "open": true

## obsidian-cli Quick Start

### Setup

```bash
# Install obsidian-cli
brew install yakitrak/yakitrak/obsidian-cli

# Set default vault
obsidian-cli set-default "My Vault"
```

### Search

```bash
# Search note names
obsidian-cli search "query"

# Search content
obsidian-cli search-content "query"
```

### Create

```bash
# Create new note
obsidian-cli create "Folder/New note" --content "Note content" --open
```

### Move/Rename

```bash
# Move/rename with link updates
obsidian-cli move "old/path/note" "new/path/note"
```

### Delete

```bash
obsidian-cli delete "path/note"
```

## Direct File Operations

Since vaults are just folders:

```bash
# Read note
cat "vault/Folder/Note.md"

# Edit note
vim "vault/Folder/Note.md"

# Create note
echo "# Title" > "vault/Folder/New Note.md"
```

## WikiLinks

Obsidian uses [[WikiLinks]]:
- [[Note Name]] - Link to note
- [[Note Name|Display Text]] - Link with custom text
- [[Note Name#Heading]] - Link to heading
- [[Note Name#^block-id]] - Link to block

## YAML Frontmatter

```yaml
---
title: Note Title
date: 2026-03-15
tags: [tag1, tag2]
---
```

## Daily Notes

```bash
# Create daily note
obsidian-cli daily

# Or directly
echo "# $(date +%Y-%m-%d)" > "vault/Daily/$(date +%Y-%m-%d).md"
```

## Tips

- Prefer direct edits when appropriate
- Obsidian picks up file changes automatically
- Use obsidian-cli for safe refactoring (move/rename)
- Multiple vaults common (work/personal)
- Don't hardcode vault paths; read config
← All skills