DavidROliverBA/ArchitectKB / .claude/skills/orphans
orphans
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
SKILL.md
View on GitHub---
context: fork
---
# /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
```markdown
# 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
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: 198k | 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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |