Agent skill
vault-clusters
Find knowledge clusters (groups of highly connected notes). Triggers on "clusters", "knowledge clusters", "note clusters", "find clusters".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/find-clusters
SKILL.md
Knowledge Clusters
Find groups of notes that are densely connected (knowledge clusters).
Purpose
Clusters are groups of notes that:
- Link heavily to each other
- Form cohesive topics or projects
- Represent distinct areas of knowledge
Identifying clusters helps:
- Understand vault organization
- Find topic boundaries
- Discover implicit categories
- Plan folder restructuring
What is a Cluster?
A cluster is 3+ notes where:
- Each note links to at least 2 others in the group
- The group is more connected internally than externally
- Forms a cohesive topic/project
Process
1. Find Hub Notes
hubs = find_hub_notes(min_links=10)
→ Start with highly connected notes
2. Expand from Each Hub
for hub in hubs:
cluster = [hub]
// Get all notes linking to/from hub
connections = get_backlinks(hub) + get_forward_links(hub)
// Find notes that also link to each other
for note in connections:
shared_links = count_shared_connections(note, cluster)
if shared_links >= 2:
cluster.append(note)
3. Score Cluster Cohesion
cohesion = internal_links / (internal_links + external_links)
→ Higher cohesion = tighter cluster
4. Report Results
Knowledge Clusters
═══════════════════════════════════════════════
Found 12 knowledge clusters
🎯 Top Clusters by Size:
**Cluster 1: Data Platform** (23 notes, 89% cohesion)
Hub: [[Main Project]]
Notes: [[Database]], [[API]], [[Pipeline]], [[Data Quality]], ...
**Cluster 2: Development Tools** (18 notes, 76% cohesion)
Hub: [[Dev Environment]]
Notes: [[Git]], [[VS Code]], [[GitHub]], [[Python]], [[Node.js]], ...
**Cluster 3: Work Process** (15 notes, 82% cohesion)
Hub: [[Workflow]]
Notes: [[Deployments]], [[Releases]], [[Testing]], [[Change Management]], ...
📊 Cluster Statistics:
• Total clusters: 12
• Average size: 14.3 notes
• Average cohesion: 78%
• Unclustered notes: 200 (20% of vault)
💡 Insights:
• 3 major topic areas dominate vault
• Data platform cluster is largest and most cohesive
• Consider creating MOC (Map of Content) for each cluster
• Unclustered notes may need topic assignment
═══════════════════════════════════════════════
Cluster Actions
For each cluster:
- Create MOC: Make a Map of Content page linking to all cluster notes
- Tag consistently: Apply cluster tag to all members
- Move to folder: Consider organizing by cluster
- Strengthen links: Add missing connections within cluster
MOC Example:
# Data Platform MOC
Core Platform:
- [[Main Project]]
- [[Database]]
- [[Architecture]]
Data Sources:
- [[Source A]]
- [[Source B]]
- [[Data Quality]]
[... organized cluster view]
Version: 1.0.0
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?