init-vault

Create an Obsidian vault skeleton with canonical layout and living-docs hooks.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/sachio222/based-stack --skill init-vault
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-vault
Source: https://github.com/sachio222/based-stack/tree/main/init-vault
Command: npx skills add https://github.com/sachio222/based-stack --skill init-vault

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of a structured Obsidian vault skeleton that adheres to the team's canonical layout and integrates with living-docs auto-update to keep NOW/Next/Blocked and changelog up to date.

Core Features & Use Cases

  • Scaffolds a complete vault skeleton including core files (WORKSTATE.md, ARCHITECTURE.md, CHANGELOG.md, README.md, CLAUDE.md, seed note <VaultName>.md) and standard folders (notes/, projects/, reference/ or topical layout) that align with based-stack conventions.
  • Guides the user through required inputs (Vault name, vault type, location, paired repo, and optional Git init) via structured prompts.
  • Ensures the seed content and top-level indexes are prepared for immediate Obsidian use and for Claude Code sessions.

Quick Start

Scaffold a new Obsidian vault at the user-specified path using the canonical layout and living-docs auto-update hooks.

Frequently Asked Questions about init-vault

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

FAQPage Schema
How do I scaffold a structured Obsidian vault for a new project?

Scaffolding a structured Obsidian vault creates a ready-to-use skeleton with canonical folders and core files like WORKSTATE.md, ARCHITECTURE.md, and README.md. The skill guides you through vault naming, layout selection, and location to prepare the structure for immediate use.

What files do I need in an Obsidian vault to support living-docs auto-update?

An Obsidian vault supporting living-docs auto-update requires core files including WORKSTATE.md, CHANGELOG.md, CLAUDE.md, seed notes, and per-folder READMEs. These files are automatically created and wired to the pipeline during the vault scaffold process.

Can I initialize Git for a new Obsidian vault alongside a paired code repository?

Yes, you can initialize Git for a new Obsidian vault alongside a paired code repository. During the scaffolding process, the skill prompts you for a paired repo location and offers optional Git initialization to link your notes vault directly with your codebase.

How do I set up a topical knowledge vault in Obsidian?

Setting up a topical knowledge vault uses a canonical layout with standard folders like reference/ and notes/. The scaffolding process prompts you to select a topical vault type, automatically generating the appropriate folder structure and seed content for immediate knowledge organization.

What is the best way to organize an Obsidian vault for Claude Code sessions?

Organizing an Obsidian vault for Claude Code sessions requires a canonical layout with CLAUDE.md and ARCHITECTURE.md at the top level. This scaffolding skill creates these required files and indexes, ensuring the vault structure is prepared for direct integration with Claude Code workflows.

Does scaffolding an Obsidian vault require any existing dependencies or plugins?

Scaffolding an Obsidian vault requires no existing dependencies or plugins. The skill operates independently to generate the canonical folder structure and required markdown files at your specified path, preparing the vault for native Obsidian use and living-docs auto-update hooks.