From obsidian-blueprint
Analyzes a git-managed Obsidian vault and configures 7-dimension quality methodology including hooks, quality gate, CLAUDE.md, and GitHub Actions workflows. Use when user says "set up vault quality", "configure obsidian", "vault setup", "obsidian quality", or wants to apply quality standards to an Obsidian vault.
How this skill is triggered — by the user, by Claude, or both
Slash command
/obsidian-blueprint:vault-setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
- **Always present analysis and plan to the user before making changes**
chmod +x)Read these files before starting:
skills/shared/references/methodology-framework.md — shared principles, hook architecture, exit codes, settings.json formatskills/shared/references/setup-workflow.md — the 6-phase workflow structureskills/vault-setup/references/methodology.md — vault-specific 7 dimensions, thresholds, tool research guidanceskills/vault-setup/references/analysis-checklist.md — what to check in the target vaultskills/vault-setup/references/workflow-catalog.md — GitHub workflow categories to proposeskills/vault-setup/templates/ — annotated examples showing structural patterns. Use templates for patterns but substitute the tools chosen during research.Follow the 6-phase workflow from setup-workflow.md.
Follow analysis-checklist.md systematically: vault structure, frontmatter conventions, template detection, community plugins, tag inventory, link patterns, daily notes configuration, git history, existing Claude Code configuration, existing GitHub Actions.
Research tools for each of the 7 dimensions. Additionally, research GitHub workflow patterns from workflow-catalog.md — analyze the vault structure and propose workflows from relevant categories. Vault-specific files to plan:
.claude/hooks/ — quality-gate.sh, per-edit-fix.sh, session-start.sh.claude/settings.json — hook registrations (see methodology-framework.md for format).gitignore — volatile .obsidian/ files.github/workflows/ — quality and automation workflowsCLAUDE.md — vault instructionsRecommend kepano/obsidian-skills as a companion plugin for additional Obsidian-specific capabilities (note creation patterns, plugin management, vault navigation).
Present complete plan and wait for approval. Ask about optional items (workflow categories, spelling tool choice, additional frontmatter required fields).
Read each template in templates/ for the structural pattern, substitute the researched tools. Make all scripts executable.
Read references/reviewer-prompt.md for the full prompt template. Spawn reviewer subagent using Task tool with subagent_type: "general-purpose".
Run .claude/hooks/quality-gate.sh. Distinguish pre-existing issues from config problems.
Structured summary: configured dimensions, files created/modified, quality gate results, next steps.
Not an Obsidian vault: Check for .obsidian/ directory. If missing, this is not an Obsidian vault. Ask the user.
yq not available for YAML validation: Frontmatter validation in per-edit and quality-gate hooks requires yq (https://github.com/mikefarah/yq). Install with brew install yq (macOS) or download from GitHub releases. Do NOT use Python for YAML parsing — always use yq.
Volatile files already tracked by git: If .obsidian/workspace.json or other volatile files are already tracked, the session-start hook warns about them. Offer to run git rm --cached to untrack them.
Community plugins directory not readable: If .obsidian/plugins/ does not exist, the vault has no community plugins installed. This is normal for a new vault.
npx claudepluginhub ondrasek/cc-plugins --plugin obsidian-blueprintInitializes any folder as a Bedrock-powered Obsidian vault by creating entity directories, copying templates, configuring language/domain taxonomy, scaffolding example entities, and checking dependencies. Use for 'bedrock setup' or new vault bootstrapping.
Scaffolds an agent-ready Obsidian Zettelkasten vault with directories, templates, CLAUDE.md, MCP config, and git init.
Manages Obsidian vaults using obsidian-cli: creates daily notes, moves/renames notes preserving [[wiki-links]], searches content, organizes notes with templates.