obsidian-repair-unresolved-links

Creates missing Obsidian notes for unresolved wiki-links with generated YAML frontmatter.

3|1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/ZHLX2005/sl --skill obsidian-repair-unresolved-links-zhlx2005
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-repair-unresolved-links
Source: https://github.com/ZHLX2005/sl/tree/main/skills/obsidian-repair-unresolved-links
Command: npx skills add https://github.com/ZHLX2005/sl --skill obsidian-repair-unresolved-links-zhlx2005

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Obsidian vaults accumulate unresolved [[wiki-links]] pointing to notes that were never created, breaking backlinks, Dataview queries, and tag aggregation. This Skill finds those dangling links and creates the missing notes with proper frontmatter and in-depth content. ## Core Features & Use Cases - Unresolved Link Detection: Scans the vault via the obsidian CLI, filters out image/attachment links and template placeholders, and locates each link's source file and line number. - Mandatory Frontmatter Generation: Runs gen_frontmatter.py to produce YAML frontmatter (creatime, tags, bklink) before any file is written, keeping vault metadata consistent. - Concurrent Multi-Link Repair: When multiple unresolved links exist, the main thread generates frontmatter and dispatches subagents to write notes in parallel, always in the source file's directory. - Content & Questionnaire Modes: Generates deep, non-duplicative notes per content-spec.md, or customized responses to filled-in questionnaires per questionnaire-spec.md. - Use Case: You wrote "see [[Crash Recovery]]" in a note but never created that page. Run this Skill to locate the reference, generate frontmatter, and write a full note next to the source file. ## Quick Start Ask the assistant to repair all unresolved wiki-links in your Obsidian vault and create the missing notes with proper frontmatter.

Frequently Asked Questions about obsidian-repair-unresolved-links

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

FAQPage Schema
How do I fix unresolved wiki-links in Obsidian?

Run the obsidian unresolved command to list dangling links, then create each missing note in the same directory as its source file. This Skill automates detection, frontmatter generation, content writing, and verification.

How to generate YAML frontmatter for new Obsidian notes automatically?

Use the included gen_frontmatter.py script with --source and --link arguments. It reads the vault's templater template, fills creatime, tags, and bklink fields, and outputs ready-to-paste YAML for the new note.

Can I repair multiple unresolved Obsidian links at once?

Yes. The Skill supports a concurrent mode where the main thread generates frontmatter for all links first, then dispatches subagents to write each note in parallel, each receiving pre-generated YAML.

Why do my new Obsidian notes miss backlinks and tags?

Notes written without frontmatter lack creatime, tags, and bklink fields, so Dataview queries and backlink panels ignore them. Always generate frontmatter with the script before writing note content.

Where should new Obsidian notes be created when fixing links?

New notes must be placed in the same directory as the source file containing the link, not the vault root. This keeps the vault organized and preserves topical grouping.