@soulcraft/kits 1.0.0

package/kits/personal-wiki/skills/orphan-finder/SKILL.md

@@ -0,0 +1,155 @@
+---
+id: orphan-finder
+name: orphan-finder
+description: Find and connect orphan pages that lack incoming links
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Orphan Finder Skill
+
+When the user invokes `/orphans`, help them identify wiki pages that lack incoming links and suggest connections.
+
+### Invocation Patterns
+
+- `/orphans` - Find all orphan pages
+- `/orphans [page]` - Find connections for specific orphan
+- `/orphans audit` - Full wiki connectivity audit
+
+### What Makes a Page an Orphan
+
+**True Orphans**
+- Zero incoming links
+- Not reachable from any other page
+- Effectively invisible
+
+**Near-Orphans**
+- Only one incoming link
+- Poorly integrated
+- Could use more connections
+
+**Islands**
+- Groups of pages that link to each other
+- But not connected to main wiki
+- Isolated clusters
+
+### Output Format
+
+```markdown
+## Orphan Page Analysis
+
+### Wiki Overview
+- **Total pages**: X
+- **Orphan pages**: X (Y%)
+- **Near-orphans (1 link)**: X
+- **Well-connected (5+ links)**: X
+
+### Orphan Pages
+
+#### High Priority (Should Definitely Connect)
+1. **[[Page Name]]**
+   - Created: [Date]
+   - Content: [Brief description]
+   - Suggested connections:
+     - [[Page A]]: [Why they relate]
+     - [[Page B]]: [Why they relate]
+   - Could also link FROM: [[Page C]]
+
+2. **[[Page Name]]**
+   [Same format]
+
+#### Medium Priority
+[Same format for less critical orphans]
+
+#### Consider Deleting
+These orphans may not be worth keeping:
+- **[[Page X]]**: [Why - too short, outdated, etc.]
+
+### Near-Orphans (Only 1 Incoming Link)
+| Page | Current Link From | Suggested Additional Links |
+|------|------------------|---------------------------|
+| [[Page]] | [[Source]] | [[Suggestion 1]], [[Suggestion 2]] |
+
+### Isolated Clusters
+**Cluster 1**: [Theme]
+Pages: [[A]], [[B]], [[C]]
+Connection point: Link [[A]] from [[Main Topic Page]]
+
+### Integration Suggestions
+
+**Quick Wins** (Easy connections to make)
+1. Add [[Orphan A]] link to [[Hub Page]]
+2. Mention [[Orphan B]] in [[Related Page]]
+
+**Pages That Should Link to More**
+These well-trafficked pages could integrate orphans:
+- [[Popular Page 1]]: Could link to [orphans]
+- [[Popular Page 2]]: Could link to [orphans]
+
+### Maintenance Actions
+- [ ] Connect [X] high-priority orphans
+- [ ] Review [X] deletion candidates
+- [ ] Add [X] links from hub pages
+```
+
+### Finding Connection Opportunities
+
+**Semantic Matching**
+- Similar titles
+- Shared keywords
+- Related topics
+- Same category/tag
+
+**Structural Matching**
+- Should be in same hub page
+- Part of same project
+- Same type of content
+
+**Temporal Matching**
+- Created around same time
+- Related to same time period
+- Part of same learning journey
+
+### Types of Pages That Become Orphans
+
+**Common Orphan Sources**
+- Imported notes (brought in but not linked)
+- Old ideas (created but forgotten)
+- Stub pages (started but not developed)
+- One-off references (quick notes)
+- Completed projects (no longer active)
+
+### Connection Strategies
+
+**Top-Down**
+- Start from hub/index pages
+- Ensure all relevant pages linked
+- Work through categories
+
+**Bottom-Up**
+- Start from orphan
+- Identify where it belongs
+- Add links from logical places
+
+**Cross-Linking**
+- Find related orphans
+- Link them to each other
+- Create mini-clusters
+- Then link cluster to main wiki
+
+### When to Delete Instead of Connect
+
+**Delete Candidates**
+- Duplicate content
+- Outdated/irrelevant
+- Too short to be useful
+- Personal notes no longer needed
+- Broken imports
+
+**Don't Delete If**
+- Unique information
+- Could be expanded
+- Part of historical record
+- Reference value

package/kits/personal-wiki/skills/wiki-structure/SKILL.md

@@ -0,0 +1,179 @@
+---
+id: wiki-structure
+name: wiki-structure
+description: Background expertise in personal wiki organization and internal linking strategies
+version: "1.0.0"
+type: background
+requiresVision: false
+requiresData: false
+---
+
+## Wiki Structure Expertise
+
+You have expertise in personal wiki organization, internal linking, and knowledge management. Apply these principles when helping users build and organize their wikis.
+
+### Wiki Organization Principles
+
+**Atomic Pages**
+- One concept per page
+- Self-contained but linked
+- Clear, specific titles
+- Scannable structure
+
+**Entry Points**
+- Home/index page
+- Category pages
+- Maps of Content (MOCs)
+- Recently updated
+
+### Page Types
+
+**Concept Pages**
+- Single topic focus
+- Definition + elaboration
+- Links to related concepts
+- Examples when helpful
+
+**Hub/Index Pages**
+- Overview of a topic area
+- Links to all related pages
+- Brief descriptions
+- Organizational structure
+
+**Maps of Content (MOCs)**
+- Curated lists around theme
+- More selective than index
+- Narrative flow possible
+- Updated regularly
+
+**Log/Journal Pages**
+- Date-based entries
+- Chronological record
+- Link to referenced pages
+- Good for learning journals
+
+### Title Conventions
+
+**Good Titles**
+- Specific and searchable
+- Noun phrases usually best
+- Consistent capitalization
+- No special characters
+
+**Examples**
+- "Spaced Repetition" (concept)
+- "Books - 2024" (index)
+- "Project Alpha" (project)
+- "Meeting Notes 2024-01-15" (log)
+
+### Internal Linking
+
+**When to Link**
+- First mention of concept
+- Key relationships
+- Supporting information
+- Deeper exploration
+
+**Link Density**
+- Not every possible link
+- Meaningful connections
+- Reader would benefit from following
+- Avoid overlinking
+
+**Link Text**
+- Descriptive anchor text
+- Natural reading flow
+- Avoid "click here"
+- Context should explain link
+
+### Page Structure Template
+
+```markdown
+# Page Title
+
+Brief definition or introduction (1-2 sentences).
+
+## Overview
+Expand on the concept. Why it matters. Context.
+
+## Key Points
+- Point 1
+- Point 2
+- Point 3
+
+## Details
+More in-depth information...
+
+### Subsection
+Specific aspect...
+
+## Related
+- [[Related Page 1]]
+- [[Related Page 2]]
+
+## References
+- Source 1
+- Source 2
+```
+
+### Organizational Patterns
+
+**Hierarchical**
+```
+Home
+├── Area 1
+│   ├── Topic A
+│   └── Topic B
+└── Area 2
+    ├── Topic C
+    └── Topic D
+```
+
+**Networked**
+- Pages link freely
+- No strict hierarchy
+- Clusters emerge organically
+- MOCs provide structure
+
+**Hybrid (Recommended)**
+- Light hierarchy for navigation
+- Rich cross-linking
+- MOCs for discovery
+- Tags for filtering
+
+### Tagging Strategy
+
+**Tag Categories**
+- Type: #concept, #project, #person
+- Status: #active, #archive, #idea
+- Topic: #productivity, #coding, #health
+
+**Tag Guidelines**
+- Few tags per page (3-5)
+- Consistent naming
+- Broad enough to be useful
+- Specific enough to filter
+
+### Maintenance Practices
+
+**Regular Reviews**
+- Check for orphan pages
+- Update outdated content
+- Merge duplicate pages
+- Fix broken links
+
+**Quality Checks**
+- Are titles clear?
+- Are pages still relevant?
+- Are links still valid?
+- Is structure working?
+
+### Common Mistakes
+
+- Pages too broad (should split)
+- Pages too narrow (merge or delete)
+- Inconsistent naming
+- Orphaned content
+- Over-categorization
+- Under-linking
+- Stale content