obsidian-master-skill

Name: obsidian-master-skill
Author: julianobarbosa

github.com/julianobarbosaProductivity1462 installsUpdated 2d ago

About obsidian-master-skill

obsidian-master-skill is a unified skill for Obsidian vault tasks, including note creation, search, health checks, and knowledge capture. It routes requests to task workflows and uses the REST API when Obsidian is running, with direct file access as a fallback.

Key features

01Create notes and daily notes
02Search by content, tags, or DQL
03Check orphan notes and broken links
04Capture and organize knowledge from conversations
05Create and validate .base views
06Use REST API or direct file access

Use cases

01Create a project note or daily entry
02Search vault notes on a topic
03Process the inbox and check link issues
04Save discussion as a decision record

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/julianobarbosa/claude-code-skills --skill obsidian-master-skill

After installing, type/obsidian-master-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

reference/

bases.md

integration-patterns.md

knowledge-capture.md

markdown.md

rest-api.md

vault-organization.md

Tools/

BaseBuilder.py

NoteCreator.py

SearchVault.py

VaultManager.py

Workflows/

CaptureKnowledge.md

CreateBase.md

CreateNote.md

DailyNote.md

ManageVault.md

ProcessInbox.md

SearchVault.md

SyncDocs.md

Details

From the project README

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.

Comments

Markdown supported

Details

Author: julianobarbosa
Repository: julianobarbosa/claude-code-skills
Category: Productivity
Installs: 62
GitHub stars: 14

Report

More skills

All skills

lark-base

open.feishu.cn

823.2k

Operate on Feishu Base: create tables, fields, records, and views; handle statistics, formulas/lookups, forms, dashboards, app mode (BaseApp/AppMode pages and components), Workspace directories, workflows, role permissions, and the template center (Base template categories, lists, and search). Use when encountering Base/multidimensional tables/bitable, BaseApp/AppMode, or /base/ or /app/ links. Do not use lark-apps for BaseApp; route file import/export to lark-drive and authentication/authorization to lark-shared.

lark-drive

open.feishu.cn

823.2k

Feishu cloud storage (Drive): manage Drive files and folders, including uploads/downloads, folder creation, copying/moving/deleting, viewing metadata, checking permission settings, comments/permissions/subscriptions, titles, versions, Feishu document security labels (secure labels), and local file imports. Use when users need to organize Drive folders, handle cloud storage resource URLs/tokens, identify link types/actual tokens/titles, or import Word/Markdown/Excel/CSV/PPTX/.base as docx/sheet/bitable/slides. Route doubao.com cloud storage URLs/tokens by resource path and token too; do not fall back to WebFetch. Not responsible for: editing document content (use lark-doc), spreadsheet/Base table data operations (use lark-sheets/lark-base), knowledge space node/member management (use lark-wiki), or native Markdown file read/write/patch/diff (use lark-markdown).

lark-shared

open.feishu.cn

822.9k

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON.

lark-im

open.feishu.cn

822.3k

Feishu instant messaging: send and receive messages and manage group chats. Send and reply to messages, search chat history, manage group members, upload and download images and files, manage emoji reactions, send urgent notifications in-app/by SMS/by phone, send and handle Interactive Cards, and listen for card button callbacks (card.action.trigger). Use when users need to send messages, view or search chat history, download chat files, view group members, search groups, create group or topic chats, manage marker data, manage Feed pins (add/remove/search pinned conversations), manage tag data, or handle card callbacks.