wiki-lint

Audit Obsidian wikis for broken links, frontmatter, and provenance issues.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Nero-kk/claude-agent-skills --skill wiki-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/Nero-kk/claude-agent-skills/tree/main/claude-skills/wiki-lint
Command: npx skills add https://github.com/Nero-kk/claude-agent-skills --skill wiki-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The wiki-lint skill finds, diagnoses, and helps repair structural and metadata problems that degrade an Obsidian knowledge vault over time, such as orphaned pages, broken wikilinks, missing frontmatter, stale content, contradictory claims, index mismatches, provenance drift, and fragmented tag clusters.

Core Features & Use Cases

  • Orphan Detection: Locate pages with zero incoming wikilinks and recommend appropriate backlinks.
  • Link & Frontmatter Validation: Find broken [[wikilinks]], missing required frontmatter fields, and summaries that are absent or too long.
  • Provenance & Staleness Analysis: Compare page update timestamps to source files, compute extracted/inferred/ambiguous fractions, and flag drift or unsourced synthesis.
  • Cluster & Index Checks: Measure tag cohesion, identify fragmented tag clusters, and verify index.md consistency with disk files.
  • Reporting & Remediation: Produce a structured Wiki Health Report, append lint results to log.md, and offer automated or user-approved fixes.

Quick Start

Run wiki-lint to scan the vault, produce a structured health report of orphans, broken links, frontmatter and provenance issues, and propose or apply fixes.

Frequently Asked Questions about wiki-lint

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

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

To find orphaned pages and broken wikilinks in an Obsidian vault, run a wiki lint audit that counts incoming wikilinks per page and validates internal link targets. This produces a structured health report flagging isolated notes and missing references.

How do I check if Obsidian frontmatter is missing required fields or summaries?

Checking Obsidian frontmatter for missing required fields and summaries requires scanning each note's metadata block. A wiki lint tool applies frontmatter-scoped greps to validate necessary fields and flag absent or excessively long summaries for remediation.

What is the best way to detect stale content and provenance drift in a knowledge base?

Detecting stale content and provenance drift in a knowledge base involves comparing page update timestamps against source files and computing extracted or inferred fractions. This analysis flags unsourced synthesis and notes needing synchronization with their origins.

Can I verify index.md consistency with disk files and measure tag cohesion in a large Obsidian wiki?

Yes, you can verify index.md consistency and measure tag cohesion in a large Obsidian wiki by running periodic quality checks. The audit reads index and log files to detect mismatches and identifies fragmented tag clusters for structural repair.

Does wiki lint support automated fixes for fragmented tag clusters and index mismatches?

Yes, wiki lint supports automated fixes for fragmented tag clusters and index mismatches. After producing a structured health report, it offers user-approved or automatic remediation to append lint results to log.md and resolve structural metadata issues.

When should I run an Obsidian wiki health check during an ingestion pipeline?

You should run an Obsidian wiki health check during an ingestion pipeline when adding new content or performing routine maintenance on large vaults. This prevents structural degradation by catching broken links, missing frontmatter, and provenance drift early.