awesome-search-kg-orphans

name	awesome-search-kg-orphans
description	Find orphan notes in the Awesome Search Obsidian vault — notes with no wikilinks in or out — and suggest or apply connections to existing notes. Use when running a graph health audit or when the KG feels sparse.

Awesome Search KG — Orphan Finder

Use this skill to find and fix orphan notes: notes with zero inbound and zero outbound wikilinks. Orphans are captured ideas that were never connected to the knowledge graph.

When to use

• Periodic KG quality audits
• After a batch of new articles have been processed
• When the graph feels fragmented or underlinked

Vault Access

Always use the Obsidian MCP server for all vault operations — never access the vault directly via the filesystem (no Read/Write/Bash file tools). The MCP server is the only sanctioned way to read, search, create, and edit notes.

Workflow

1. Find orphans

Scan all notes in Awesome Search/ for files that contain no [[wikilinks]] in their body AND have no other notes linking to them.

Check each folder:

• Awesome Search/Articles/
• Awesome Search/Concepts/
• Awesome Search/People/
• Awesome Search/Companies/
• Awesome Search/Topics/

A note is an orphan if:

• Its body contains zero [[...]] wikilinks, AND
• No other note in the vault contains a [[NoteTitle]] reference to it

2. Report

Output a table grouped by folder:

ORPHAN REPORT — Awesome Search KG
==================================
Articles (N orphans):
  - Note Title
  - ...

Concepts (N orphans):
  - ...

People (N orphans):
  - ...

Total: N orphans

3. Triage each orphan

For each orphan, read its content and determine:

• Integrate: note has real content worth connecting → suggest 2-3 specific wikilinks to add
• Stub: note is nearly empty → flag for expansion or deletion
• Noise: Medium/web clipping residue with no useful content → flag for deletion

4. Fix (if requested)

For orphans classified as Integrate:

• Add wikilinks to existing related notes in the body
• Add the orphan as a link in the most relevant related note's "Related" section

Do NOT delete any notes — only suggest deletion candidates and let the user confirm.

5. Report results

ORPHAN FIX SUMMARY
==================
Integrated: N notes (links added)
Flagged for expansion: N stubs
Flagged for deletion: N noise notes
Skipped: N (could not determine connections)

Notes

• Only add wikilinks that are genuinely meaningful — do not create links just to eliminate orphan status
• An orphan concept note that is truly standalone is better left as-is than linked incorrectly
• Run awesome-search-kg-hubs after fixing orphans to check if any newly linked notes become unexpected hubs