# Julianobarbosa Claude Code Skills Obsidian Master Skill

> obsidian-master-skill

- Skill: `tomevault-io/julianobarbosa-claude-code-skills-obsidian-master-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/julianobarbosa-claude-code-skills-obsidian-master-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/julianobarbosa-claude-code-skills-obsidian-master-skill/raw
- Safety review: pending (external: skill-scanner WARNING, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/julianobarbosa-claude-code-skills-obsidian-master-skill

---


# 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:**
```yaml
---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
tags:
  - category/subcategory
---
```

**Daily Note (v2.0):**
```yaml
---
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:**
```yaml
---
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

```markdown
[[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

```dataview
LIST FROM "06 - Daily" WHERE file.cday = date(today) SORT file.ctime DESC
```

```dataview
TABLE status, tags FROM "01 - Projects" WHERE status != "completed"
```

```dataview
TABLE WITHOUT ID file.link AS "Note", file.mtime AS "Modified"
FROM "03 - Resources" SORT file.mtime DESC LIMIT 20
```

```dataview
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

```markdown
> [!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

```bash
# 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

```yaml
# 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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/julianobarbosa) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->