# Broken Link Healer

> Finds unresolved links, uses semantic context to guess the intended existing file, and corrects the link.

- **Type:** Skill
- **Install:** `agentstack add skill-tpitsunov-obsidian-skills-broken-link-healer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tpitsunov](https://agentstack.voostack.com/s/tpitsunov)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tpitsunov](https://github.com/tpitsunov)
- **Source:** https://github.com/tpitsunov/obsidian-skills/tree/main/broken_link_healer

## Install

```sh
agentstack add skill-tpitsunov-obsidian-skills-broken-link-healer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## 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:

1. **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"
   ```
2. **Review Output**: Read the script's output, which will list exact broken links and the top 3 highly probable existing file replacements.
3. **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.
5. **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.
6. **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](https://github.com/tpitsunov)
- **Source:** [tpitsunov/obsidian-skills](https://github.com/tpitsunov/obsidian-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tpitsunov-obsidian-skills-broken-link-healer
- Seller: https://agentstack.voostack.com/s/tpitsunov
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.