wiki-lint

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

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-lint-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/wiki-lint
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-lint-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Personal knowledge bases in Obsidian degrade over time: pages become orphaned, wikilinks break, frontmatter drifts out of spec, and contradictions accumulate silently. This Skill runs a 13-check health audit across the vault and reports every structural issue in one pass. ## Core Features & Use Cases - 13 lint checks: Detects orphaned pages, broken wikilinks, missing frontmatter, stale content, contradictions, index drift, provenance issues, fragmented tag clusters, visibility/PII tagging gaps, misc promotion candidates, synthesis gaps, confidence/lifecycle schema violations, and invalid typed relationships. - Fast path via obsidian-cli: Uses the wiki-cli.py wrapper for 10-50x speedups on structural checks like orphans, unresolved links, and tag cluster analysis. - Consolidate mode: The --consolidate flag switches from report-only to act-and-report, fixing broken links, rescuing orphans, updating lifecycle states, demoting tiers, normalizing tags, and writing a consolidation report after explicit user confirmation. - Use Case: Run a periodic "dream cycle" on your vault: audit all pages, get a structured health report, then approve a dry-run list of automatic fixes so the wiki self-heals. ## Quick Start Ask the assistant to run a wiki health check on your Obsidian vault and report any 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 detects pages with zero incoming wikilinks using the obsidian-cli orphans command or a grep-based fallback. Orphans are reported with suggestions for which existing pages should link to them.

How to check for broken wikilinks in Obsidian markdown files?▼

The audit greps all [[wikilink]] targets and verifies each resolves to an existing .md file. In consolidate mode, broken links are fuzzy-matched to the closest page title and rewritten, or converted to plain text if no match exists.

Does wiki-lint modify my Obsidian vault automatically?▼

No. Default mode is report-only. The --consolidate flag enables fixes, but always runs a dry-run first and requires explicit user confirmation before writing any changes to the vault.

What frontmatter fields does the wiki lint check validate?▼

It validates title, category, tags, sources, created, updated, summary, lifecycle, base_confidence, superseded_by, and relationships blocks. Lifecycle values must be draft, reviewed, verified, disputed, or archived, and base_confidence must be between 0.0 and 1.0.

Why is my wiki audit slow and how can I speed it up?▼

Manual grep-based checks take 5-10 seconds each. Use the wiki-cli.py wrapper around obsidian-cli for 10-50x speedups on orphans, unresolved links, dead-ends, and tag cluster analysis.