wiki-lint

Audit an Obsidian wiki for orphans, broken links, stale content, and schema violations.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-lint-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/wiki-lint
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-lint-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Knowledge bases degrade over time: pages become orphaned, wikilinks break, frontmatter drifts from schema, and stale or contradictory claims go unnoticed. This Skill runs a structured health audit across an Obsidian vault so structural problems are found and fixed before they erode the wiki's value. ## Core Features & Use Cases - Fourteen lint checks: Detects orphaned pages, broken wikilinks, missing frontmatter and summaries, stale content, contradictions, index drift, provenance drift, fragmented tag clusters, visibility tag issues, lifecycle/confidence schema violations, invalid typed relationships, event-time errors, and synthesis gaps. - Structured health report: Outputs a Markdown Wiki Health Report grouping every finding by check type, plus a log entry appended to log.md. - Consolidate mode: The --consolidate flag switches from report-only to act-and-report, fixing broken links, cross-referencing orphans, and normalizing tags after a dry-run preview, explicit user confirmation, and an optional Git pre-write snapshot. - Use Case: Run a periodic "dream cycle" on your vault: the audit flags a verified page that is 180 days stale, three broken wikilinks, and a fragmented tag cluster, then interactively applies the approved fixes. ## Quick Start Ask the assistant to run a wiki health check on your Obsidian vault and report orphaned pages, broken links, 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 orphaned pages in an Obsidian vault?

Run the wiki-lint audit, which globs all Markdown files and greps the vault for incoming wikilinks to each page. Pages with zero incoming links, excluding index.md and log.md, are reported as orphans, and consolidate mode can add cross-references from pages that mention them.

How to detect and fix broken wikilinks in Obsidian?

The broken-link check greps for [[...]] patterns, strips aliases and heading anchors, skips attachment embeds, and verifies each target resolves to a Markdown file. In consolidate mode, unambiguous targets are fuzzy-matched and rewritten, while unresolvable ones are converted to plain text with a comment.

Does the wiki audit modify my notes automatically?

No. Default mode is report-only. The --consolidate mode always runs a dry-run first, lists planned actions, and writes only after explicit user confirmation, optionally taking a Git snapshot of the vault beforehand for rollback.

What frontmatter fields does the wiki lint check validate?

It validates required fields like title, category, tags, sources, created, and updated, plus optional summary, lifecycle enum values, base_confidence in [0.0, 1.0], typed relationships, and event-time fields valid_from, valid_until, and superseded_by against the effective owner schema.

Why does the lint skip _archives and _raw directories?

Directories like _archives/, _raw/, _readouts/, and .obsidian/ hold frozen snapshots, staging drafts, and derived readouts rather than knowledge-graph pages. Orphan, frontmatter, and link checks do not apply to them, so every check excludes them from scope.

Can the lint automatically recompute page confidence scores?

No. Confidence is treated as a semantic judgment requiring human review. The trust-check validator only verifies an approved ledger against content fingerprints, flags stale or unreviewed pages, and never rewrites base_confidence automatically.