Broken Link Healer
Finds unresolved links, uses semantic context to guess the intended existing file, and corrects the link.
Install
$ agentstack add skill-tpitsunov-obsidian-skills-broken-link-healer ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Broken Link Healer Workflow
When the user uses the slash command /heal_links or asks to heal, format, or fix broken links in a specific file or folder, follow these steps:
- Execute Healer Script: Run the deterministic Python script against the target file. The script parses all links, cross-references them against every file in the vault (regardless of folder depth), and uses fuzzy string matching to find the 3 closest actual files for any broken links.
``bash python /absolute/path/to/Obsidian-AI-Skills/broken_link_healer/scripts/heal_links.py "/absolute/path/to/vault" "/absolute/path/to/target_file.md" ``
- Review Output: Read the script's output, which will list exact broken links and the top 3 highly probable existing file replacements.
- Propose Corrections To User: Present the script's findings. If a link should be replaced dynamically to preserve the sentence structure (e.g., changing
[[apples]]to[[Apple|apples]]), suggest that format. - Confirm and Apply Changes: Show the proposed replacements to the user. Upon confirmation, update the target Markdown files, replacing the broken markdown syntax with the correct links.
- Notify: Advise the user if any links appear truly orphaned (no suitable matching file exists and the note might need to be created from scratch).
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: tpitsunov
- Source: tpitsunov/obsidian-skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.