- Home
- Skills
- Productivity
- Obsidian Vault Audit: Orphans, Broken Links, Missing Notes
Obsidian Vault Audit: Orphans, Broken Links, Missing Notes
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
Works with the AI Agents you already use
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 missingtagsandupdatedfrontmatter fields.Areas/Health.md: Resolve orphan status by linking fromIndex.md.Templates/Meeting-Note.md: Fix malformed wikilink in the footer.
Structure
- Granularity issue: The
/Archivefolder contains 142 notes with no index. Recommend sub-folders by year. - Detached Hub:
Hubs/Finance-MOC.mdexists but is not reachable from yourIndex.md. - Status mismatch:
Projects/Learning-Rust.mdis markedstatus: activebut 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
/Resourcesand/Projects. Needs a definition note. - Synthesis: GPT-Workflows: 15 raw prompts in
/Resources/AIwith no summary note to organize them.
Next steps
- Would you like me to automatically fix the 34 broken links and update the missing frontmatter?
- I can generate the "Backpressure" definition note stub for you.
- Full report saved to
Audit/2024-05-20.md.
obsidian-vault-audit-orphans-broken-link.pdf
PDF · document
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"
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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
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 forever
No account required to browse
Trust & safety
Security scan
Security scan passed 17 days ago
- Free with an Agensi account
Requires