wiki-lint
wiki-lint scans your Obsidian vault to surface structural problems: orphaned pages, broken wikilinks, missing cross-references, incomplete frontmatter, and empty sections. It generates a timestamped health report, updates Dataview dashboards, and can create visual canvas maps of your vault's domain structure.
wiki-lint performs comprehensive health checks on Obsidian vaults, identifying orphans, dead links, missing pages, and structural gaps.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-05-28
wiki-lint performs comprehensive health checks on Obsidian vaults, identifying orphans, dead links, missing pages, and structural gaps. wiki-lint scans your Obsidian vault to surface structural problems: orphaned pages, broken wikilinks, missing cross-references, incomplete frontmatter, and empty sections. It generates a timestamped health report, updates Dataview dashboards, and can create visual canvas maps of your vault's domain structure.
Use it when
- wiki-lint scans your entire vault to detect orphaned pages—notes with no incoming or outgoing wikilinks that are isolated from your vault's.
- Yes.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
AgriciDaniel/claude-obsidian/wiki-lint · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does wiki-lint do for an Obsidian vault health check?
wiki-lint performs a comprehensive health check on your Obsidian vault to identify structural issues including orphaned pages, broken wikilinks, missing cross-references, incomplete frontmatter, and empty sections. It generates a timestamped health report that surfaces all problems found during the scan.
How does wiki-lint find orphan pages in my vault?
wiki-lint scans your entire vault to detect orphaned pages—notes with no incoming or outgoing wikilinks that are isolated from your vault's structure. It identifies these disconnected pages in its comprehensive health report so you can decide whether to link them, archive them, or delete them.
Can wiki-lint check for broken wikilinks and dead links?
Yes. wiki-lint detects broken wikilinks and dead links throughout your vault, identifying references that point to missing pages or malformed cross-references. It reports all broken links so you can fix them and restore connectivity across your wiki.
Does wiki-lint validate frontmatter metadata consistency?
wiki-lint validates frontmatter metadata consistency and completeness across your wiki, checking for missing or incomplete metadata fields. It identifies gaps in your vault's metadata structure and helps ensure all pages meet your frontmatter standards.
What visual outputs can wiki-lint generate for my vault?
wiki-lint generates visual dashboards and canvas maps of your vault's structure. It updates Dataview dashboards and can create canvas maps that visualize your wiki's domain structure and relationships between pages.
Does wiki-lint detect duplicate or similar pages?
wiki-lint uses embeddings to detect duplicate or semantically similar pages in your vault. This helps you identify redundant content and consolidate pages that cover overlapping topics, improving your wiki's organization and reducing duplication.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
wiki-lint: Wiki Health Check
Run lint after every 10-15 ingests, or weekly. Ask before auto-fixing anything. Output a lint report to wiki/meta/lint-report-YYYY-MM-DD.md.
Transport (v1.7+)
Lint primarily reads, then writes a single report file. Both follow the standard transport policy. Read .vault-meta/transport.json (auto-created by bash scripts/detect-transport.sh):
- cli —
obsidian-cli read "$VAULT" "$NOTE"for individual reads;obsidian-cli backlinks "$VAULT" "$NOTE"natively handles backlink graph (avoids re-rolling it via Grep); seeskills/wiki-cli/SKILL.md - mcp-obsidian / mcpvault —
mcp__obsidian-vault__read_multiple_notes,list_all_tags - filesystem — Claude's
Read/Glob/Grep(final floor; current v1.6 behavior)
Full
(truncated - see the full file via the links below)
File tree — 1 file
skills/wiki-lint/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Perform comprehensive health check on Obsidian vault to identify structural issues”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
wiki-ingest reads external sources—files, URLs, or images—and populates your Obsidian vault by extracting entities and concepts, then creating or updating interconnected wiki pages. It handles delta tracking to skip unchanged sources, supports multiple vault organization modes, and uses file locking to safely coordinate concurrent writes across your knowledge base.
wiki-retrieve upgrades vault search from page-level to chunk-level granularity, combining contextual prefixes, BM25 sparse retrieval, and dense reranking to reduce retrieval failures. Setup is opt-in with built-in privacy gates: run fully on-machine with synthetic prefixes, or opt into Anthropic API or claude CLI tiers for better context generation.
wiki transforms Obsidian into a compounding knowledge system by scaffolding vault structure from your description, organizing sources and entities, and maintaining a hot cache of recent context. Unlike RAG systems, the wiki persists as a structured artifact where cross-references and contradictions surface automatically. Route ingest, query, and maintenance tasks to specialized sub-skills while the skill handles vault setup, indexing, and knowledge layer management.
wiki-cli establishes the Obsidian CLI (v1.12+) as the primary transport layer for vault operations in claude-obsidian v1.7+, handling reads, writes, searches, and mutations without requiring MCP servers or REST API plugins. When the CLI is unavailable, the skill automatically falls back to direct filesystem access. Detection and fallback logic ensure reliable vault access across desktop and headless environments.
Wiki Lint performs systematic health checks on your wiki, scanning for contradictory claims across pages, outdated information, orphaned content, and missing connections between related topics. It flags structural problems like broken wikilinks and suggests investigations to close knowledge gaps, then logs findings for your review.
wiki-query lets you ask questions against your Obsidian vault and retrieves answers by reading cached content, indexes, and relevant pages. It supports three query depths—quick for simple facts, standard for most questions, and deep for comprehensive synthesis—and can file good answers back into your wiki to compound knowledge over time.
More skills wiki-dedup (MIT) · wiki-mode (MIT) · obsidian-bases (MIT) · save (MIT) · wiki-lint (MIT) · wiki-ingest (MIT)