link-hygiene

Find and fix broken wikilinks, orphaned notes, and missing backlinks across the vault.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/artislismanis/obsidian-agent-sandbox --skill link-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: link-hygiene
Source: https://github.com/artislismanis/obsidian-agent-sandbox/tree/main/workspace/.claude/skills/link-hygiene
Command: npx skills add https://github.com/artislismanis/obsidian-agent-sandbox --skill link-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Broken wikilinks, missing backlinks, and orphaned notes clutter a vault and degrade navigability. This skill helps maintain vault health by detecting and proposing fixes before changes are applied.

Core Features & Use Cases

  • Inventory unresolved links to surface broken references and their sources.
  • Propose non-destructive fixes for missing notes, stale references, and orphaned pages.
  • Surface link suggestions for recent notes to improve cross-link density and discovery.

Quick Start

Ask it to scan the vault for broken links and orphans and present a review-ready plan.

Frequently Asked Questions about link-hygiene

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find and fix broken wikilinks in my vault?

To fix broken wikilinks, this skill inventories unresolved references across the vault and proposes non-destructive corrections before applying any changes. It scans for stale links and presents a review-ready plan for user confirmation.

What is the best way to clean up orphaned notes during vault maintenance?

Cleaning up orphaned notes is handled by detecting unlinked pages and proposing fixes or new connections. The skill surfaces these isolated notes so you can review and integrate them into your vault's network.

Can I use this to surface missing backlinks and improve cross-link density?

Yes, surfacing missing backlinks is a core feature that improves cross-link density. The skill analyzes recent notes and suggests new link connections to enhance overall vault navigability and discovery.

Does this link hygiene skill apply changes automatically without user confirmation?

No, this skill does not apply changes automatically; it operates non-destructively. It inventories broken links and orphans, proposes fixes, and surfaces suggestions strictly with user confirmation before any action.

When should I run a vault-wide link health check?

A vault-wide link health check should be run during periodic cleanups or when clutter from broken wikilinks and orphaned notes degrades navigability. It identifies stale references and missing backlinks before they disrupt your workflow.