skills.rest
r2d2helm
r2d2helmCOMMUNITY
Explore all skills by this author →
GitHub

vault-guardian-skill

Run Obsidian vault health checks, auto-fixes, and audit reports via PowerShell and Bash scripts.

Updated Aug 27, 2026
Search Tags:#obsidian#auto-fix#frontmatter#health-check#link-validation#vault-maintenance
One-click install
npx skills add https://github.com/r2d2helm/claude-code-system --skill vault-guardian-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vault-guardian-skill
Source: https://github.com/r2d2helm/claude-code-system/tree/main/skills/vault-guardian-skill
Command: npx skills add https://github.com/r2d2helm/claude-code-system --skill vault-guardian-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Maintains the Obsidian vault health by performing regular checks, auto-fixing issues, and producing audit-ready reports.

Core Features & Use Cases

  • Health checks for notes, links, and frontmatter to quantify vault quality.
  • Auto-fix: repair broken links, fill missing frontmatter, normalize tags and statuses, and detect orphans.
  • Reports: generate structured health metrics and recommendations for vault governance.

Quick Start

Ask the vault guardian to run a health check now to generate a live health report and suggested fixes.

Frequently Asked Questions about vault-guardian-skill

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

FAQPage Schema
How do I run an Obsidian vault health check to find broken links and missing frontmatter?▼

To run a vault health check, execute the provided PowerShell or Bash scripts in health mode. This scans the Obsidian vault to validate links, check frontmatter, and output a JSON health log with audit metrics and suggested fixes.

Can I automatically fix orphan notes and normalize tags in my Obsidian vault?▼

Yes, you can automatically fix orphan notes and normalize tags by running the scripts in auto-fix mode. This mode repairs broken links, fills missing frontmatter, and normalizes statuses to maintain vault governance.

Does this vault maintenance tool work on both Windows and Linux?▼

Yes, vault maintenance is supported on both Windows and Linux. The Skill includes PowerShell (Invoke-VaultGuardian.ps1) for Windows and Bash (invoke-vault-guardian.sh) scripts for Linux to orchestrate health checks and fixes.

What is the best way to generate audit-ready reports for Obsidian vault quality?▼

The best way to generate audit-ready reports is to run the scripts in report mode. This produces structured health metrics, identifies orphan notes and broken links, and writes JSON health logs for vault governance.

Do I need any dependencies to run the Obsidian vault guardian scripts?▼

No dependencies are required to run the vault guardian scripts. The Skill relies solely on included PowerShell and Bash scripts to perform health checks, auto-fix issues, and generate reports without external packages.

What is the difference between the quick and fix modes for Obsidian vault maintenance?▼

The quick mode runs a fast health check, while the fix mode actively applies automatic fixes to the Obsidian vault. Fix mode repairs broken links, fills missing frontmatter, and normalizes tags, whereas quick mode only reports issues.

Related Skills

Explore More Software Engineering Skills→
jykimjykim
31

obsidian-links

Format, validate and fix Obsidian wiki links to conform with vault conventions.

Community
Basic
lloydchanglloydchang
2

monitor-ci-cd-pipelines

Monitor CI/CD pipeline health across AWS, Azure, GCP, and on-prem.

Community
Advanced
julianobarbosajulianobarbosa
7

Commit

Automate Git commits with pre-commit security scans and Conventional Commits enforcement.

Community
Advanced
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate