wiki-lint

Audit an Obsidian vault for broken wikilinks, invalid tags, and orphan pages.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima --skill wiki-lint-gabrielcardosodeaguiar45-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima/tree/main/wiki-lint
Command: npx skills add https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima --skill wiki-lint-gabrielcardosodeaguiar45-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It automatically audits an Obsidian legal-knowledge vault to detect inconsistencies (broken wikilinks, invalid tags, orphan pages, missing precedent/concept consolidation, and date divergences) before they accumulate and degrade piece quality.

Core Features & Use Cases

  • Broken wikilinks detection: finds [[...]] links that resolve to nonexistent pages using canonical names, basenames, and frontmatter aliases.
  • Canonical tag validation: flags tags found in frontmatter and inline text that are not present in _tags.md.
  • Orphan page and concept detection: reports pages with no incoming wikilink (excluding structural templates/stubs) and precedents cited multiple times without a consolidated ficha in Precedentes/.
  • Precedent date divergence reporting: detects the same precedent appearing with different dates across multiple files.
  • Actionable output: generates a clickable Markdown report inside the vault at _lint/lint-YYYY-MM-DD.md.

Quick Start

Ask your assistant to run wiki-lint for your Obsidian vault path so it creates the daily _lint/lint-YYYY-MM-DD.md report with all detected issues.

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 orphan pages in an Obsidian vault?

To find broken wikilinks and orphan pages in an Obsidian vault, run an audit that resolves link targets by basename, canonical names, and frontmatter aliases, then reports unresolved links and isolated pages in a generated Markdown file.

What is Obsidian tag validation and how does it work?

Obsidian tag validation checks frontmatter and inline text tags against a master list in _tags.md. It flags unlisted tags to ensure metadata consistency across your legal knowledge base.

How do I detect precedent date divergences across multiple Markdown files?

Detect precedent date divergences by auditing Markdown files for the same precedent appearing with different dates. The lint scan identifies these inconsistencies and lists them in a dated report under the _lint directory.

Can I use a vault lint script for ongoing legal knowledge base maintenance?

Yes, a vault lint script suits ongoing legal knowledge base maintenance. It detects missing precedent consolidation, invalid tags, and broken cross-links before they accumulate and degrade piece quality over time.

How do I generate a clickable Markdown report for Obsidian vault issues?

Generate a clickable Markdown report for Obsidian vault issues by running a lint audit on your vault path. The script creates a dated report at _lint/lint-YYYY-MM-DD.md containing all detected inconsistencies.

What is the best way to find orphan precedent concepts in Obsidian?

The best way to find orphan precedent concepts is auditing for precedents cited multiple times without a consolidated ficha in the Precedentes/ directory. The lint scan flags these missing consolidation entries.