DavidROliverBA/.claude/skills/orphans

/orphans

Find orphan notes (notes with no backlinks) using sub-agents for efficient scanning.

Usage

/orphans
/orphans type:Meeting
/orphans --fix

Instructions

Phase 1: Planning

1. Determine scope:
   • All notes (default)
   • Specific type if provided
2. Plan the scan:
   • Get all notes in vault
   • Build link graph
   • Identify orphans

Phase 2: Parallel Analysis (use sub-agents)

Launch these sub-agents in parallel using model: "haiku" for efficiency:

Agent 1: Build Note Index (Haiku)

• List all .md files in vault root and +Meetings/ folder
• Extract: filename, type from frontmatter
• Return: complete note inventory

Agent 2: Extract Outgoing Links (Haiku)

• For each note, extract all [[wiki-links]]
• Build map: note → [linked notes]
• Return: outgoing link map

Agent 3: Calculate Incoming Links (Haiku)

• Invert the link map
• Build map: note → [notes linking to it]
• Return: incoming link counts

Agent 4: Identify Special Cases (Haiku)

• Find MOC files (should have many outgoing, few incoming)
• Find template files (expected orphans)
• Find daily notes (may not need links)
• Return: exclusion list

Phase 3: Compile Results

# Orphan Notes Report

**Scanned**: {{total notes}}
**Orphans Found**: {{count}}
**Generated**: {{DATE}}

## Summary

- Total notes: {{count}}
- With incoming links: {{count}} ({{%}})
- Orphans (no incoming): {{count}} ({{%}})
- Excluded (templates, MOCs): {{count}}

## Orphan Notes by Type

### Projects ({{count}})
These projects aren't referenced anywhere:
| Note | Created | Last Modified |
|------|---------|---------------|
{{orphan projects}}

### Meetings ({{count}})
Meetings not linked from any note:
{{orphan meetings}}

### People ({{count}})
People not mentioned in any note:
{{orphan people}}

### Pages ({{count}})
Documentation pages with no references:
{{orphan pages}}

### Tasks ({{count}})
Tasks not linked to projects:
{{orphan tasks}}

## Recommendations

### High Priority (should definitely be linked)
{{notes that seem important but have no links}}

### Consider Archiving
{{old notes with no links that may be obsolete}}

### Link Suggestions

| Orphan Note | Suggested Link From |
|-------------|---------------------|
{{AI-suggested connections based on content}}

## Quick Fixes

To link orphan meetings to their projects:
{{list of suggested edits}}

--fix Mode

If --fix flag provided:

1. For each orphan meeting with a project in frontmatter, add link from project file
2. For each orphan person mentioned in meetings, add link from relevant meetings
3. Report changes made