obsidian-cli — Claude Code Skill

A Claude Code skill for interacting with your Obsidian vault using the obsidian CLI.

What it does

Enables Claude to read, create, edit, search, append, and manage notes in your Obsidian vault — all via the obsidian CLI command through the Bash tool.

Priority activation keywords — any of these words in a request will trigger this skill first: 문서 vault obsidian 볼트 노트

Trigger phrases:

Category	Phrases
Document CRUD	"문서를 수정", "문서를 봤는데", "문서의 내용을", "문서를 만들어", "문서를 삭제"
File reference	".md 문서를 보니", ".md 파일을"
Vault	"vault를 찾겠다", "vault에서", "볼트에서"
General	"Obsidian에 저장해줘", "볼트에서 찾아줘", "노트 만들어줘", "데일리 노트에 추가해줘"

Requirements

• obsidian-cli installed and configured
• Obsidian vault set up locally

Installation

# Using oh-my-claudecode
/oh-my-claudecode:skill add bloooi/obsidian-cli-skill

Or manually copy the skill folder into your ~/.claude/skills/ directory:

git clone https://github.com/bloooi/obsidian-cli-skill.git
cp -r obsidian-cli-skill ~/.claude/skills/obsidian-cli

Usage Examples

Task	Example phrase
Read a note	"볼트에서 'Meeting Notes' 읽어줘"
Create a note	"'프로젝트 계획' 노트 만들어줘"
Append to daily note	"오늘 데일리 노트에 완료 항목 추가해줘"
Search vault	"볼트에서 'API' 관련 노트 찾아줘"
Move a note	"'Draft' 노트를 'Archive' 폴더로 이동해줘"

Skill Structure

obsidian-cli/
├── SKILL.md                    # Main skill instructions for Claude
└── references/
    └── commands.md             # Full obsidian CLI command reference

Key Behaviors

• Always uses obsidian CLI via Bash — never MCP obsidian tools
• Handles the create → rename pattern (CLI quirk: create always makes "Untitled.md")
• Uses $'...' bash quoting for content with newlines or special characters
• Splits long documents into create + sequential append chunks

License

MIT