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
Install
AgriciDaniel/claude-obsidian/wiki-lint · repository language: Python
git clone https://github.com/AgriciDaniel/claude-obsidian
cp -r claude-obsidian/skills/wiki-lint ~/.claude/skills/wiki-lintFrequently 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)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/wiki-lint/SKILL.md