Agent-Skills.md

Agent Skills: obsidian-master-skill

>-

UncategorizedID: julianobarbosa/claude-code-skills/obsidian-master-skill

Repository

julianobarbosa/claude-code-skills
julianobarbosaLicense: MIT
444

Install this agent skill to your local

pnpm dlx add-skill https://github.com/julianobarbosa/claude-code-skills/tree/HEAD/skills/obsidian-master-skill

Skill Files

Browse the full folder contents for obsidian-master-skill.

Download Skill

Loading file tree…

skills/obsidian-master-skill/SKILL.md

Skill Metadata

Name
obsidian-master-skill
Description
>-

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.