Obsidian Vault Audit: Orphans, Broken Links, Missing Notes

    1

    Scans your Obsidian vault for orphan notes, broken wikilinks, dead ends and stale notes, then tells you which notes are missing, with evidence for each.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Obsidian Vault Audit: Orphans, Broken Links, Missing Notes

    Example session with this skill installed

    Run an audit on my vault at ~/Documents/second-brain and let me know what is missing.

    • Read your context and instructions
    • Compiled the obsidian vault audit
    • Generated the document

    I have completed the audit of your vault. The hygiene scan is finished, and I have analyzed the structure of your PARA folders.

    State in three lines:
    The vault is structurally sound but mechanically neglected (34 broken links, 12 orphans).
    Link density is high in /Resources but critically low in /Projects (0.4 links/note).
    A significant gap exists between your daily logs and your active project hubs.

    Audit: 2024-05-20

    Fix now

    • Projects/Website-Redesign.md: Fix broken link to [[UI-Assets]] (file does not exist).
    • Resources/Python-Snippets.md: Add missing tags and updated frontmatter fields.
    • Areas/Health.md: Resolve orphan status by linking from Index.md.
    • Templates/Meeting-Note.md: Fix malformed wikilink in the footer.

    Structure

    • Granularity issue: The /Archive folder contains 142 notes with no index. Recommend sub-folders by year.
    • Detached Hub: Hubs/Finance-MOC.md exists but is not reachable from your Index.md.
    • Status mismatch: Projects/Learning-Rust.md is marked status: active but has not been edited in 94 days.

    Missing notes

    Project: API-Integration: Evidence in 6 files (last 3 daily notes). Needs a decision log on why the SDK was swapped.

    • Concept: "Backpressure": Mentioned in 12 notes across /Resources and /Projects. Needs a definition note.
    • Synthesis: GPT-Workflows: 15 raw prompts in /Resources/AI with no summary note to organize them.

    Next steps

    1. Would you like me to automatically fix the 34 broken links and update the missing frontmatter?
    2. I can generate the "Backpressure" definition note stub for you.
    3. Full report saved to Audit/2024-05-20.md.

    obsidian-vault-audit-orphans-broken-link.pdf

    PDF · document

    Generated

    Example file from a real run - the skill writes it into your workspace.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Your second brain grows faster than you can review it. Vault Audit gives your agent a method and a script to check it properly, in three steps: hygiene (measured by a bundled Python scan), structure (hubs, index coverage, misplaced projects) and gaps (notes your vault keeps promising but never writes).

    What you get

    • A scan script (Python 3, no dependencies, read-only) that reports incomplete frontmatter, orphans, broken wikilinks, dead ends, stale notes, open tasks, duplicate titles, link density and the cadence of daily notes.
    • A structural review of your hubs and folders, judged against your own convention (PARA, Zettelkasten or anything else), not an imposed one.
    • A gap analysis that never invents notes: each proposed note cites the evidence that asks for it.
    • A dated report with at most 10 fixes and 8 missing notes, so it actually gets read.
    • It never changes your vault without a yes, and never reads private notes beyond what is needed to count links.

    Example prompts

    • "Audit my vault"
    • "What's missing in my second brain?"
    • "Find broken links and orphan notes in my Projects folder"

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Productivity.

    Supports Markdown files only. Requires Python 3 for the scan script. Date tracking requires a git repo or specific 'updated'/'created' frontmatter fields.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free to use

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 17 days ago

    • Free with an Agensi account

    Software
    Git

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Listed17 days ago

    What's inside

    Frequently Asked Questions

    The skill runs locally on your machine, using Python scripts and Unix utilities to analyze your Markdown files without ever uploading your private notes to a third-party server.

    While optimized for Obsidian's link syntax, this skill works with any Markdown-based system like Logseq or SilverBullet, as long as the agent has local file system access.

    No, the audit is non-destructive; it identifies issues and generates a report with prioritized action items, only applying fixes like updating frontmatter if you explicitly approve them.

    You receive the core Python scanning scripts, the AI agent configuration files, and a guide on how to integrate the audit reports into your existing weekly or monthly review workflow.

    The skill uses a 'Context Discovery' step to detect whether you use PARA, Zettelkasten, or a custom setup, ensuring the audit recommendations align with your specific workflow rather than forcing a new one.

    New in Productivity

    Free