init

Initialize an Obsidian vault with Zettelkasten folders, templates, and Claude configuration.

36|2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tuan3w/obsidian-vault-agent --skill init-tuan3w
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/tuan3w/obsidian-vault-agent/tree/main/skills/init
Command: npx skills add https://github.com/tuan3w/obsidian-vault-agent --skill init-tuan3w

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires npx, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of manually setting up an Obsidian workspace so an AI can consistently create, link, and process notes in a Zettelkasten-style system.

Core Features & Use Cases

  • Vault scaffolding: Creates the required directory structure (notes, templates, Spaces, Clippings, temp) and includes a fully configured starter vault layout.
  • Agent-ready configuration: Writes CLAUDE.md, .mcp.json, and Claude hooks, so tool usage is guided and vault context is re-injected correctly.
  • Safe, ready-to-edit templates: Copies note templates and generates example notes to show the intended frontmatter schema and linking conventions.

Quick Start

Open a new empty folder, run the init script to scaffold the vault, then open the folder in Obsidian and start with /process on the example source note.

Frequently Asked Questions about init

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

FAQPage Schema
How do I set up an Obsidian vault for AI agent knowledge management?

To set up an Obsidian vault for AI agent knowledge management, run an initialization script that generates the required directory structure, templates, CLAUDE.md, and MCP configuration. This scaffolds a fresh Zettelkasten workspace so you can immediately process notes using agent commands.

What is an agent-ready Zettelkasten vault in Obsidian?

An agent-ready Zettelkasten vault is an Obsidian workspace pre-configured with specific folder structures, templates, gitignore, and MCP configurations. It provides the necessary context and conventions for an AI agent to consistently create, link, and process notes.

How do I configure Claude hooks and MCP settings for an Obsidian vault?

You can configure Claude hooks and MCP settings for an Obsidian vault by running an initialization script that automatically writes the .mcp.json file with your specific vault path. This safely sets up the agent tool usage context without manual JSON editing.

Do I need npx to scaffold an Obsidian Zettelkasten workspace?

Yes, you need npx installed to execute the initialization script that scaffolds the Obsidian Zettelkasten workspace. The script relies on this dependency to generate the folders, templates, and agent configuration files.

Will scaffolding an Obsidian vault overwrite my existing notes and templates?

Scaffolding an Obsidian vault prevents accidental overwrites of your existing notes and templates by default. You must explicitly provide a force flag if you want the script to replace existing files and directories during the setup process.

Can I use custom frontmatter and wikilink conventions in my Obsidian vault setup?

Yes, the vault setup generates safe, ready-to-edit templates and example notes that demonstrate the intended frontmatter schema and wikilink conventions. You can modify these copied scaffold assets to match your specific knowledge management requirements.