How do I install the Obsidian Master Skill skill?

Run npx skillmds add tools-only/obsidian-master-skill 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 Master Skill safe to use?

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

Which AI agents work with Obsidian Master Skill?

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 Master Skill free to use?

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

Who published Obsidian Master Skill?

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

Obsidian Master Skill by tools-only

Name: Obsidian Master Skill
Rating: 4.2 (5 reviews)
Author: tools-only

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.

tools-only 36f8cee 3 files · 7.6 KB Updated Sep 8, 2026 7 repo stars

File contents

obsidian-master-skill

Unified skill for all Obsidian vault operations. Routes to workflows and context files.

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`

Context Files

File	Content
`MarkdownReference.md`	Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, math, mermaid
`RestApiReference.md`	Local REST API endpoints, URI scheme, plugin API classes, Python client
`VaultOrganization.md`	PARA folders, frontmatter schemas, naming conventions, Dataview queries
`BasesReference.md`	.base YAML schema, filters, formulas, functions, view types
`IntegrationPatterns.md`	Claude Code integration patterns (Direct, Manifest, MCP, COG, Claudesidian)
`KnowledgeCapturePatterns.md`	ADR, concept, how-to, meeting note templates for knowledge extraction

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?"      -> MarkdownReference.md (context only)
"How do I use the REST API?"                      -> RestApiReference.md (context only)
"How do bases formulas work?"                     -> BasesReference.md (context only)

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`

Neovim Reference

For obsidian.nvim configuration, see IntegrationPatterns.md section on Neovim integration.

---name: obsidian-master-skilldescription: 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.---# obsidian-master-skillUnified skill for all Obsidian vault operations. Routes to workflows and context files.## 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` |## Context Files| File | Content ||------|---------|| `MarkdownReference.md` | Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, math, mermaid || `RestApiReference.md` | Local REST API endpoints, URI scheme, plugin API classes, Python client || `VaultOrganization.md` | PARA folders, frontmatter schemas, naming conventions, Dataview queries || `BasesReference.md` | .base YAML schema, filters, formulas, functions, view types || `IntegrationPatterns.md` | Claude Code integration patterns (Direct, Manifest, MCP, COG, Claudesidian) || `KnowledgeCapturePatterns.md` | ADR, concept, how-to, meeting note templates for knowledge extraction |## 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?" -> MarkdownReference.md (context only)"How do I use the REST API?" -> RestApiReference.md (context only)"How do bases formulas work?" -> BasesReference.md (context only)```## 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` |## Neovim ReferenceFor obsidian.nvim configuration, see `IntegrationPatterns.md` section on Neovim integration.

Frequently asked questions