wiki-lint

Audit Obsidian vaults for orphaned pages, broken wikilinks, and missing frontmatter.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Michael1Peng/watson --skill wiki-lint-michael1peng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/Michael1Peng/watson/tree/main/.agents/skills/wiki-lint
Command: npx skills add https://github.com/Michael1Peng/watson --skill wiki-lint-michael1peng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps detect and fix structural issues in an Obsidian wiki, improving reliability and discoverability.

Core Features & Use Cases

  • Orphaned pages detection to identify pages with zero incoming links.
  • Broken wikilinks detection and guidance for remediation.
  • Missing frontmatter checks to enforce metadata completeness.
  • Stale content detection by comparing update times against source changes.
  • Index consistency verification between index.md and actual vault contents.
  • Provenance and cohesion checks to ensure content trustworthiness and cross-link integrity.

Quick Start

Run a health audit on the current Obsidian vault to identify orphaned pages, broken wikilinks, missing frontmatter, and stale content.

Frequently Asked Questions about wiki-lint

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

FAQPage Schema
How do I find broken wikilinks and orphaned pages in an Obsidian vault?

To find broken wikilinks and orphaned pages in an Obsidian vault, run a health audit that detects pages with zero incoming links and identifies invalid cross-link references. The audit produces a structured health report with actionable remediation steps.

How do I check for missing frontmatter in my Obsidian notes?

You can check for missing frontmatter in Obsidian notes by running a vault health audit that enforces frontmatter completeness. This process verifies metadata consistency across notes and flags entries lacking required provenance fields.

What is the best way to detect stale content in a wiki?

The best way to detect stale wiki content is to compare note update times against source document changes. This audit identifies outdated pages by tracking provenance inconsistencies and highlights notes requiring synchronization with their sources.

How do I verify index.md consistency with actual vault contents?

To verify index.md consistency with actual vault contents, run an index consistency check during a vault audit. This validation cross-references your central index file against the physical notes to detect missing entries and orphaned documents.

Can I audit a large Obsidian vault for structural issues?

Yes, you can audit large Obsidian vaults for structural issues. The audit scales to handle everyday note collections and extensive vaults, identifying orphaned pages, broken wikilinks, missing frontmatter, and stale content across the entire repository.

Why does my wiki have broken cross-links after moving notes?

Broken cross-links occur when wiki references are not updated after moving or renaming notes. A cross-link integrity audit identifies these broken wikilinks and provides actionable guidance for remediation to restore vault navigability.