OpenParable
Skip to content
← Back to skills

Awesome Search Kg Orphans

Documents
awesome-search-kg-orphans

Awesome Search Kg Orphans is an Agent Skill for documents published in the frutik/awesome-search repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/frutik/awesome-search/blob/HEAD/claude-skills/awesome-search-kg-orphans/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/awesome-search-kg-orphans, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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