skills.rest
sonthanh
sonthanhCOMMUNITY
Explore all skills by this author →
GitHub

vault-lint

Automate nightly Obsidian vault health checks for broken wiki-links and orphan pages.

16|9|Updated Apr 4, 2026
Search Tags:#automation#vault#lint#wiki-links#bidirectional#orphan-pages
One-click install
npx skills add https://github.com/sonthanh/brain-os-plugin --skill vault-lint
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vault-lint
Source: https://github.com/sonthanh/brain-os-plugin/tree/main/skills/vault-lint
Command: npx skills add https://github.com/sonthanh/brain-os-plugin --skill vault-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Nightly vault maintenance — fix broken wiki-links, detect orphan pages, enforce bidirectional linking, sync directory indexes, detect CLAUDE.md drift/SSOT violations, flag stale GH-issue tasks, flag dead entities.

Core Features & Use Cases

  • Automated wiki-link integrity checks and bidirectional link enforcement across the vault.
  • Detect orphan pages and propose remediation, plus directory index synchronization.
  • Structured, cron-friendly reporting with a daily outcome log and task-tracking integration.

Quick Start

Ask Vault Lint to run its nightly audit to identify and fix vault health issues.

Frequently Asked Questions about vault-lint

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

FAQPage Schema
How do I automate nightly Obsidian vault maintenance for broken wiki-links?▼

Automated nightly vault maintenance runs a multi-phase pipeline to fix broken wiki-links, enforce bidirectional linking, and sync directory indexes. It detects orphan pages and writes a structured daily report with an outcome log.

What is bidirectional link enforcement and how does it work for large vault collections?▼

Bidirectional link enforcement ensures every wiki-link has a corresponding backlink across large vault collections. The pipeline detects links in phase A, surfaces stale issues via GitHub in phase B, and logs remediation outcomes nightly.

How do I detect orphan pages in an Obsidian vault during a health audit?▼

To detect orphan pages during a vault health audit, the nightly pipeline scans all notes, identifies pages lacking incoming wiki-links, proposes remediation, and synchronizes directory indexes to maintain structural integrity.

Can I run nightly vault health checks using cron for ongoing Obsidian maintenance?▼

Nightly vault health checks are cron-friendly and designed for ongoing Obsidian maintenance workflows. The automated pipeline runs nightly to flag dead entities, detect CLAUDE.md drift, and enforce bidirectional linking.

What is the best way to track stale GitHub issue tasks during vault audits?▼

Tracking stale GitHub issue tasks during vault audits is handled by phase B of the pipeline, which surfaces stale issues via GitHub integration and records them in a structured daily outcome log for task-tracking.

Why does my vault health audit flag CLAUDE.md drift and SSOT violations?▼

Vault health audits flag CLAUDE.md drift and SSOT violations to maintain a single source of truth. The nightly pipeline detects these inconsistencies alongside broken wiki-links and orphan pages, writing structured reports for remediation.

Related Skills

Explore More Content & Communication Skills→
ondrasekondrasek
2

vault-setup

Configure a git-managed Obsidian vault with seven-dimension quality checks.

Community
Advanced
semicolon-devteamsemicolon-devteam

iteration-tracker

Track test iterations and outcomes for GitHub issues via issue comments.

Official
Advanced
jwintzjwintz
24

lithos-doc

Generate and validate Lithos vault documentation pages with frontmatter and wikilinks.

Community
Intermediate
zzzlxhhhzzzlxhhh
10

paper-lint

Audit Obsidian wikis for structural issues and apply safe repairs.

Community
Advanced