How do I install the Kg Orphans skill?

Run npx skillmds@latest add frutik/kg-orphans in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Kg Orphans safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Kg Orphans?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Kg Orphans free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Kg Orphans?

frutik (@frutik) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Kg Orphans by frutik — Agent Skill

Name: Kg Orphans
Author: frutik

File contents

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

---name: kg-orphansdescription: 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 FinderUse 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 orphansScan 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. ReportOutput 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 orphanFor 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" sectionDo 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 stubsFlagged for deletion: N noise notesSkipped: 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

Frequently asked questions

Kg Orphans