How do I install the Obsidian skill?

Run npx skillmds@latest add kennyg/obsidian in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian?

kennyg (@kennyg) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian by kennyg — Agent Skill

Name: Obsidian
Author: kennyg

Obsidian

Read, write, search, and manage Obsidian vault notes. Use when: (1) Reading/writing markdown notes, (2) Searching vault content, (3) Managing daily/periodic notes, (4) Tracking tasks or oncall incidents. Uses the native Obsidian CLI.

kennyg e7d8025 6 files · 11.5 KB Updated Sep 17, 2026

File contents

Obsidian Vault Integration

Configuration

export OBSIDIAN_VAULT="icloud-vault"            # Optional — defaults to active vault
export OBSIDIAN_TODO_FILE="Inbox/Tasks.md"      # Optional

CLI Tools

Native Obsidian CLI

obsidian read path=<path>                       # Read note
obsidian create path=<path> content=<text> overwrite  # Write note
obsidian search query=<text>                    # Search vault
obsidian daily:read                             # Read daily note
obsidian daily:append content=<text>            # Append to daily note
obsidian command id=<id>                        # Execute command
obsidian snippet:enable name=<name>             # Enable CSS snippet
obsidian files                                  # List vault files

Thought (Daily Notes)

thought "Great idea for the app"
thought "Meeting went well" meeting work

Todo Tracking

todo add "Review PR" work --due tomorrow --priority high
todo done 1                    # Complete by number
todo done "PR"                 # Complete by search
todo delete 2                  # Remove task
todo list                      # Show pending
todo list work                 # Filter by tag

See: references/todo.md

Oncall Tracking

oncall start                   # Start shift
oncall log "Alert fired" incident database
oncall resolve "Fixed it" database
oncall summary                 # View current shift
oncall end                     # End and archive

See: references/oncall.md

Agent Mission Control (Kanban)

bun scripts/kanban.ts board-status --board "Agents/Mission-Control.md"
bun scripts/kanban.ts list --board "Agents/Mission-Control.md" --lane Ready
bun scripts/kanban.ts claim --board "Agents/Mission-Control.md" --id <blockId> --agent <name>
bun scripts/kanban.ts update --board "Agents/Mission-Control.md" --id <blockId> --status blocked
bun scripts/kanban.ts complete --board "Agents/Mission-Control.md" --id <blockId>
bun scripts/kanban.ts fail --board "Agents/Mission-Control.md" --id <blockId> --reason "..."
bun scripts/kanban.ts add-task --board "Agents/Mission-Control.md" --title "..." --lane Ready

See: references/kanban.md

Decision Guide

Need	Method
Read/write notes	`obsidian` CLI
Search vault	`obsidian` CLI
Execute commands/snippets	`obsidian` CLI
Quick thoughts/notes	`thought` CLI
Task management	`todo` CLI
Oncall/incidents	`oncall` CLI
Agent task dispatch/claim	`kanban` CLI

Reference Docs

Obsidian CLI Reference - Native CLI commands
Thought Reference - Quick notes to daily journal
Todo Reference - Task management with Obsidian Tasks format
Oncall Reference - Incident tracking and shift management
Kanban Reference - Agent mission control and task dispatch

---name: obsidiandescription: Read, write, search, and manage Obsidian vault notes. Use when: (1) Reading/writing markdown notes, (2) Searching vault content, (3) Managing daily/periodic notes, (4) Tracking tasks or oncall incidents. Uses the native Obsidian CLI.---# Obsidian Vault Integration## Configuration```bashexport OBSIDIAN_VAULT="icloud-vault" # Optional — defaults to active vaultexport OBSIDIAN_TODO_FILE="Inbox/Tasks.md" # Optional```## CLI Tools### Native Obsidian CLI```bashobsidian read path=<path> # Read noteobsidian create path=<path> content=<text> overwrite # Write noteobsidian search query=<text> # Search vaultobsidian daily:read # Read daily noteobsidian daily:append content=<text> # Append to daily noteobsidian command id=<id> # Execute commandobsidian snippet:enable name=<name> # Enable CSS snippetobsidian files # List vault files```### Thought (Daily Notes)```bashthought "Great idea for the app"thought "Meeting went well" meeting work```### Todo Tracking```bashtodo add "Review PR" work --due tomorrow --priority hightodo done 1 # Complete by numbertodo done "PR" # Complete by searchtodo delete 2 # Remove tasktodo list # Show pendingtodo list work # Filter by tag```See: [references/todo.md](references/todo.md)### Oncall Tracking```bashoncall start # Start shiftoncall log "Alert fired" incident databaseoncall resolve "Fixed it" databaseoncall summary # View current shiftoncall end # End and archive```See: [references/oncall.md](references/oncall.md)### Agent Mission Control (Kanban)```bashbun scripts/kanban.ts board-status --board "Agents/Mission-Control.md"bun scripts/kanban.ts list --board "Agents/Mission-Control.md" --lane Readybun scripts/kanban.ts claim --board "Agents/Mission-Control.md" --id <blockId> --agent <name>bun scripts/kanban.ts update --board "Agents/Mission-Control.md" --id <blockId> --status blockedbun scripts/kanban.ts complete --board "Agents/Mission-Control.md" --id <blockId>bun scripts/kanban.ts fail --board "Agents/Mission-Control.md" --id <blockId> --reason "..."bun scripts/kanban.ts add-task --board "Agents/Mission-Control.md" --title "..." --lane Ready```See: [references/kanban.md](references/kanban.md)## Decision Guide| Need | Method || ------------------------- | -------------- || Read/write notes | `obsidian` CLI || Search vault | `obsidian` CLI || Execute commands/snippets | `obsidian` CLI || Quick thoughts/notes | `thought` CLI || Task management | `todo` CLI || Oncall/incidents | `oncall` CLI || Agent task dispatch/claim | `kanban` CLI |## Reference Docs- [Obsidian CLI Reference](references/obsidian-cli.md) - Native CLI commands- [Thought Reference](references/thought.md) - Quick notes to daily journal- [Todo Reference](references/todo.md) - Task management with Obsidian Tasks format- [Oncall Reference](references/oncall.md) - Incident tracking and shift management- [Kanban Reference](references/kanban.md) - Agent mission control and task dispatch

Frequently asked questions