vault-explain

Explain Obsidian vault quality methodology, hooks, checks, and workflows.

2|1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/ondrasek/cc-plugins --skill vault-explain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-explain
Source: https://github.com/ondrasek/cc-plugins/tree/main/plugins/obsidian-blueprint/skills/vault-explain
Command: npx skills add https://github.com/ondrasek/cc-plugins --skill vault-explain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users understand the Obsidian vault quality methodology by explaining why dimensions exist, how vault hooks work, what each check covers, and how workflows are configured. It guides users who ask questions like "why frontmatter", "what does the quality gate check", or "how do vault hooks work" without modifying any vaults.

Core Features & Use Cases

  • Provides clear explanations of the vault methodology, including dimension purposes, hook architecture, and exit codes.
  • Answers common questions with examples and references to official documents for deeper reading.
  • Use Case: when designing or auditing an Obsidian vault, you can quickly understand how the quality checks are organized and how to interpret results.

Quick Start

Ask a vault methodology question such as "why frontmatter" or "how does the quality gate work" to get an authoritative explanation.

Frequently Asked Questions about vault-explain

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

FAQPage Schema
How does the Obsidian vault quality methodology work?

The Obsidian vault quality methodology works by organizing checks across defined dimensions and enforcing rules through a Stop hook architecture. It uses specific exit codes to gate workflows, ensuring vaults meet structural standards before operations complete.

Why is frontmatter required in an Obsidian vault quality check?

Frontmatter is required in an Obsidian vault quality check because it provides essential metadata for dimension analysis. The methodology uses frontmatter to validate document structure and ensure notes conform to the configured workflow standards.

How do I configure workflows for an Obsidian vault?

You configure workflows for an Obsidian vault by referencing the workflow catalog and methodology framework documents. These define the available hooks and checks, allowing you to map quality dimensions to specific vault operations.

What does the Stop hook architecture do in Obsidian vault checks?

The Stop hook architecture in Obsidian vault checks intercepts operations to validate vault quality against configured dimensions. It returns specific exit codes to block or allow actions based on whether the vault passes the quality gate.

Can I use vault hooks to audit an existing Obsidian vault?

Yes, you can use vault hooks to audit an existing Obsidian vault. The methodology framework and analysis checklist guide you through interpreting hook exit codes and dimension checks to identify structural issues.

What are the limitations of using Obsidian vault quality methodology?

The methodology is limited to explaining vault quality dimensions and hook architecture without modifying any vaults. It provides explanatory references for auditing and designing workflows but does not execute changes or fix structural errors directly.