obsidian-init

Bootstraps Obsidian vaults with CLAUDE.md governance, PARA folder structure, and frontmatter schema.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill obsidian-init-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-init
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-knowledge/skills/obsidian-init
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill obsidian-init-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a new Obsidian vault for use with Claude Code requires consistent folder structure, governance rules, and frontmatter conventions — doing this manually is error-prone and produces vaults that downstream knowledge skills cannot reliably process. ## Core Features & Use Cases - Guided Vault Bootstrap: Runs a short interview (purpose, topics, note types, frontmatter style, tag taxonomy) or accepts --minimal defaults, then scaffolds a PARA+Zettelkasten folder layout. - Governance File Generation: Writes a customized CLAUDE.md covering Obsidian syntax rules, note naming conventions, wikilink handling, and vault-specific don'ts, plus a .mz/vault-schema.yml defining per-note-type frontmatter requirements. - Non-Destructive Retrofit: Detects existing CLAUDE.md, schema, and folders, merging missing sections instead of overwriting, with an explicit approval gate before any files are written. - Use Case: Point the skill at a new or existing vault directory, approve the scaffold plan, and receive a vault ready for downstream skills like vault-ingest, process-notes, and vault-schema. ## Quick Start Ask the assistant to initialize a new Obsidian vault at a given path, for example by saying: bootstrap my Obsidian vault at ~/Notes with the default structure.

Frequently Asked Questions about obsidian-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an Obsidian vault for use with Claude Code?

Run the obsidian-init skill with the vault path as its argument. It interviews you about vault purpose, topics, note types, and tag style, shows a scaffold plan for approval, then creates the folder structure, CLAUDE.md, and schema files.

What folder structure does obsidian-init create?

It creates a PARA+Zettelkasten hybrid layout: numbered folders for MOCs, Projects, Areas, Resources, Permanent notes, Fleeting notes, Daily notes, Archives, and Meta. Topic subfolders are added under Permanent based on your interview answers.

Can I run obsidian-init on an existing Obsidian vault?

Yes, the skill scans for existing CLAUDE.md, .mz/ schema, and folders before writing anything. It never overwrites existing files — it appends only missing sections to an existing CLAUDE.md and skips files that already exist.

How do I skip the setup interview in obsidian-init?

Pass the --minimal flag after the vault path. This skips the interview entirely and applies default settings: personal second brain purpose, all six note types, extended frontmatter, and hierarchical tags.

When should I not use obsidian-init?

Skip it when the vault already has a well-formed CLAUDE.md and .mz/vault-schema.yml — edit those files directly instead. It also does not process or ingest notes; use vault-ingest or process-notes for that.