Wiki Lint

Runs a health check on your Obsidian vault and spits out a dated markdown report covering orphan pages, dead links, missing cross-references, frontmatter gaps, and empty sections. It's designed to run after every 10-15 ingests or weekly. The skill follows a transport layer system that tries obsidian-cli first, falls back to MCP, and lands on filesystem reads if needed. It also generates Dataview dashboards and canvas maps, enforces naming conventions like Title Case filenames and lowercase-with-dashes folders, and includes opt-in DragonScale address validation if you're running that system. Ask it to lint when your wiki feels messy or before a big refactor.

skills.sh installs: 484
GitHub stars: 16.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add agricidaniel/claude-obsidian --skill wiki-lint --agent claude-code

Installs into .claude/skills of the current project.

Files

Lint the wiki

Use the portable lint engine as the source of truth. Lint observes vault state; it does not create reports, dashboards, canvases, stubs, or fixes.

Resolve the installed product root from this skill's own location, not from the vault or current working directory:

PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
test -f "$CORE"

Every ../wiki/references/ link in this file resolves the same way, relative to this skill's own directory under $PRODUCT_ROOT, never relative to the selected vault's wiki/ directory.

Run

Resolve the user vault, then run one of:

python3 "$CORE" lint --vault "$VAULT"
python3 "$CORE" lint --vault "$VAULT" --format markdown
python3 "$CORE" lint --vault "$VAULT" --exclude "wiki/scratchpad/*"

The repeatable --exclude GLOB flag scopes a path (for example a scratchpad folder) out of page, link-resolution, orphan, frontmatter, empty-section, and stale-index scanning.

Use --strict only when a nonzero exit for findings is useful in automation. The command remains read-only either way.

SKILL.md on GitHub