# Kg Orphans

> 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.

- Skill: `frutik/kg-orphans` (Agent Skill)
- Install (CLI): `npx skillmds@latest add frutik/kg-orphans`
- Raw SKILL.md: https://api.skillmd.com/api/skills/frutik/kg-orphans/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: frutik (https://skillmd.com/u/frutik)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/frutik/kg-orphans

---


# 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/Videos/`
- `Awesome Search/Concepts/`
- `Awesome Search/People/`
- `Awesome Search/Companies/`
- `Awesome Search/Tools/`
- `Awesome Search/Topics/`
- `Awesome Search/Conferences/`
- `Awesome Search/Case Studies/`
- `Awesome Search/Datasets/`

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 `kg-hubs` after fixing orphans to check if any newly linked notes become unexpected hubs