DavidROliverBA/ArchitectKB / .claude/skills/orphans
orphans
Verified/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
- Determine scope:
- All notes (default)
- Specific type if provided
- 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:
- For each orphan meeting with a project in frontmatter, add link from project file
- For each orphan person mentioned in meetings, add link from relevant meetings
- Report changes made
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |