kg-orphans

Detects and reconnects orphan notes lacking wikilinks in an Obsidian knowledge graph.

1.6k|143|Updated Sep 9, 2019
One-click install
npx skills add https://github.com/frutik/awesome-search --skill kg-orphans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kg-orphans
Source: https://github.com/frutik/awesome-search/tree/main/claude-skills/kg-orphans
Command: npx skills add https://github.com/frutik/awesome-search --skill kg-orphans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Knowledge graphs accumulate orphan notes — pages with no inbound or outbound wikilinks — that remain invisible and disconnected, undermining the value of a linked vault. This Skill finds those orphans and helps reintegrate them into the graph.

Core Features & Use Cases

  • Orphan Detection: Scans all folders of the Awesome Search Obsidian vault (Articles, Concepts, People, Tools, and more) to find notes with zero wikilinks in either direction.
  • Triage and Classification: Classifies each orphan as Integrate (worth linking), Stub (needs expansion), or Noise (deletion candidate), then suggests 2-3 specific wikilinks.
  • Safe Fixing: Adds meaningful wikilinks to related notes and updates their Related sections, while never deleting notes without user confirmation.
  • Use Case: After importing a batch of new articles into your Obsidian vault, run a graph health audit to surface every unlinked note and connect them to existing concepts and topics.

Quick Start

Use the kg-orphans skill to audit my Awesome Search vault for orphan notes and suggest wikilinks to reconnect them.

Frequently Asked Questions about kg-orphans

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

FAQPage Schema
How do I find orphan notes in an Obsidian vault?

Scan every note for wikilinks in its body and check whether any other note references its title. A note with zero outbound [[wikilinks]] and zero inbound references is an orphan. This Skill automates that scan across all vault folders via the Obsidian MCP server.

How to fix unlinked notes in a knowledge graph?

Read each orphan's content, classify it as integrate, stub, or noise, then add 2-3 meaningful wikilinks to related existing notes. Also add the orphan to the Related section of the most relevant connected note.

Does this skill delete orphan notes automatically?

No. The skill never deletes notes. It only flags noise notes and stubs as deletion or expansion candidates, and the user must confirm any deletion manually.

Can I access the Obsidian vault directly with file tools?

No. All vault operations must go through the Obsidian MCP server, which is the only sanctioned way to read, search, create, and edit notes. Direct filesystem access via Read, Write, or Bash tools is explicitly prohibited.

When should I run an orphan note audit?

Run it during periodic knowledge graph quality audits, after processing a batch of new articles, or whenever the graph feels fragmented. After fixing orphans, run a hub analysis to check for newly over-linked notes.