obsidian-master-skill
Comprehensive Obsidian vault management. USE WHEN obsidian, vault, note, daily note, PARA, inbox, knowledge capture, dataview, DQL, search vault, .base, bases, wikilink, frontmatter, second brain, markdown syntax, obsidian.nvim, OR obsidian API. Python-powered tools for search, creation, and vault health.
How do I install this agent skill?
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill obsidian-master-skillIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The Obsidian Master Skill provides a comprehensive suite for vault management using local REST APIs and direct file access. Security concerns are minor and primarily involve a surface for indirect prompt injection when processing external documentation and a lack of SSL verification in the search tool when communicating with the local Obsidian API.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
4/19 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
obsidian-master-skill
Unified skill for all Obsidian vault operations — note creation, search, vault health, knowledge capture, bases, and daily notes. Uses progressive disclosure: essential rules below, deep reference in reference/.
Directory Structure
obsidian-master-skill/
├── SKILL.md # This file (overview + quick reference)
├── reference/ # Detailed documentation
│ ├── markdown.md # Obsidian Flavored Markdown syntax
│ ├── vault-organization.md # PARA folders, frontmatter, Dataview
│ ├── rest-api.md # Local REST API, URI scheme, plugin API
│ ├── bases.md # .base YAML schema, filters, formulas
│ ├── integration-patterns.md # Claude Code integration patterns
│ └── knowledge-capture.md # ADR, concept, how-to, meeting templates
├── Workflows/ # Step-by-step workflow definitions
│ ├── CreateNote.md # Create notes with templates + PARA placement
│ ├── SearchVault.md # DQL, content search, tag filtering
│ ├── ManageVault.md # Health checks, orphans, broken links
│ ├── CaptureKnowledge.md # Extract insights from conversations
│ ├── CreateBase.md # Build .base database views
│ ├── DailyNote.md # Daily note creation/enhancement
│ ├── ProcessInbox.md # Triage inbox into PARA folders
│ └── SyncDocs.md # Sync external project docs to vault
└── Tools/ # Python CLI tools (click + httpx)
├── SearchVault.py # status, auth, search (dataview|content|jsonlogic)
├── VaultManager.py # health, orphans, broken-links, lifecycle, move, inbox
├── NoteCreator.py # create, daily, capture
└── BaseBuilder.py # create, validate, preview
Workflow Routing
| Intent | Workflow | Tool |
|---|---|---|
| Create a note (any type) | Workflows/CreateNote.md | Tools/NoteCreator.py |
| Search vault (DQL, content, tags) | Workflows/SearchVault.md | Tools/SearchVault.py |
| Vault health, orphans, broken links | Workflows/ManageVault.md | Tools/VaultManager.py |
| Extract knowledge from conversation | Workflows/CaptureKnowledge.md | Tools/NoteCreator.py |
| Create/edit .base database views | Workflows/CreateBase.md | Tools/BaseBuilder.py |
| Daily note create/enhance | Workflows/DailyNote.md | Tools/NoteCreator.py |
| Process inbox notes into PARA | Workflows/ProcessInbox.md | Tools/VaultManager.py |
| Sync project docs to vault | Workflows/SyncDocs.md | Tools/VaultManager.py |
Quick Reference
PARA Folder Map
| Folder | Purpose | Note Types |
|---|---|---|
00 - Inbox/ | Quick capture, unsorted | Fleeting thoughts |
00 - Maps of Content/ | Index notes | MOCs, dashboards |
01 - Projects/ | Active projects | Project docs |
02 - Areas/ | Ongoing responsibilities | Area overviews |
03 - Resources/ | Reference materials | Evergreen notes |
04 - Archive/ | Completed/inactive | Archived projects |
04 - Permanent/ | Zettelkasten notes | Atomic ideas |
06 - Daily/ | Daily journal (YYYY/MM/YYYYMMDD.md) | Journal entries |
08 - books/ | Book notes | Reading notes |
10 - 1-1/ | Meeting notes | 1-on-1s |
Deep dive:
reference/vault-organization.md
Frontmatter Schemas
Standard Note:
---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
tags:
- category/subcategory
---
Daily Note (v2.0):
---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
title: YYYYMMDD
type: daily-note
status: true
tags:
- daily
- y/YYYY
- y/YYYY-MM
aliases:
- YYYY-MM-DD
date_formatted: YYYY-MM-DD
cssclasses:
- daily
---
Project Note:
---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
type: project
status: active | paused | complete
priority: high | medium | low
tags:
- project/name
---
Deep dive:
reference/vault-organization.md
Link Conventions
[[Note Name]] # Wikilink
[[Note Name|Display Text]] # Aliased link
[[Note Name#Heading]] # Heading link
[[Note Name#^block-id]] # Block reference
![[Note Name]] # Embed note
![[image.png]] # Embed image
![[image.png|300]] # Embed with width
Deep dive:
reference/markdown.md
Common Dataview Queries
LIST FROM "06 - Daily" WHERE file.cday = date(today) SORT file.ctime DESC
TABLE status, tags FROM "01 - Projects" WHERE status != "completed"
TABLE WITHOUT ID file.link AS "Note", file.mtime AS "Modified"
FROM "03 - Resources" SORT file.mtime DESC LIMIT 20
LIST FROM "" WHERE length(file.inlinks) = 0 AND length(file.outlinks) = 0
Deep dive:
reference/vault-organization.md
Knowledge Capture Signals
| Signal in Conversation | Capture Type | Destination |
|---|---|---|
| "We decided to..." | ADR | 03 - Resources/decisions/ |
| "What is X?" / "X works by..." | Concept | 04 - Permanent/ |
| "How do I..." / "Steps to..." | How-To | 03 - Resources/howtos/ |
| "In the meeting..." | Meeting Note | 10 - 1-1/ |
| "Track all notes about..." | MOC | 00 - Maps of Content/ |
| Quick insight or todo | Daily Append | 06 - Daily/YYYY/MM/YYYYMMDD.md |
Deep dive:
reference/knowledge-capture.md
Callout Types
> [!note] Title
> Content
> [!tip]+ Expandable (default open)
> [!info]- Collapsed (default closed)
Types: note, abstract/summary/tldr, info, todo, tip/hint/important, success/check/done, question/help/faq, warning/caution/attention, failure/fail/missing, danger/error, bug, example, quote/cite
Deep dive:
reference/markdown.md
REST API Quick Start
# Requires Local REST API plugin enabled in Obsidian
export OBSIDIAN_API_KEY="your-key"
export OBSIDIAN_BASE_URL="https://127.0.0.1:27124"
curl -H "Authorization: Bearer $OBSIDIAN_API_KEY" $OBSIDIAN_BASE_URL/vault/
| Endpoint | Method | Purpose |
|---|---|---|
/vault/{path} | GET/PUT/DELETE/PATCH | File CRUD |
/search/simple/ | POST | Text search |
/search/ | POST | Dataview query |
/search/jsonlogic/ | POST | Complex filtering |
/active/ | GET/PUT | Active file |
/commands/{id} | POST | Execute command |
Deep dive:
reference/rest-api.md
Base Files Quick Start
# example.base — table of active projects
filters:
and:
- file.inFolder("01 - Projects")
- 'status == "active"'
views:
- type: table
name: "Active Projects"
order: [file.name, status, priority, due_date]
Embed: ![[example.base]] or ![[example.base#View Name]]
Deep dive:
reference/bases.md
Tools (Python)
All tools use click CLI, httpx for REST API, pyyaml for frontmatter, pathlib for direct file access. Dual mode: REST API when Obsidian running, direct file fallback otherwise.
| Tool | Commands |
|---|---|
Tools/SearchVault.py | status, auth, search --type dataview|content|jsonlogic |
Tools/VaultManager.py | health, orphans, broken-links, lifecycle, move, inbox |
Tools/NoteCreator.py | create, daily, capture |
Tools/BaseBuilder.py | create, validate, preview |
Examples
"Create a new project note for API redesign" -> Workflows/CreateNote.md
"Search my vault for notes about Kubernetes" -> Workflows/SearchVault.md
"Find orphan notes and suggest connections" -> Workflows/ManageVault.md
"Save what we just discussed as an ADR" -> Workflows/CaptureKnowledge.md
"Create a base view of all active projects" -> Workflows/CreateBase.md
"Create today's daily note" -> Workflows/DailyNote.md
"Process my inbox" -> Workflows/ProcessInbox.md
"What's the Obsidian markdown syntax for X?" -> reference/markdown.md
"How do I use the REST API?" -> reference/rest-api.md
"How do bases formulas work?" -> reference/bases.md
Neovim Reference
For obsidian.nvim configuration, see reference/integration-patterns.md section on Neovim integration.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/julianobarbosa/claude-code-skills/obsidian-master-skill">View obsidian-master-skill on skillZs</a>