Agent skill
vault-related
Find notes related to current note (by tags, folder, keywords). Triggers on "related notes", "similar notes", "find related", "what's related".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/documents/find-related-notes
SKILL.md
Related Notes
Find notes similar to a given note based on tags, folder, and metadata.
Purpose
Discover notes related to the current context:
- Same tags
- Same folder
- Similar frontmatter
- Common keywords
Useful for:
- Finding relevant context
- Discovering connections
- Research exploration
- Knowledge consolidation
Process
1. Get Current Note Metadata
current = get_note_metadata(note_path)
→ Extract: tags, folder, frontmatter
2. Search by Tag Similarity
tag_matches = search_notes({
has_any_tag: current.tags,
limit: 20
})
3. Search by Folder
folder_matches = search_notes({
folder: current.folder,
limit: 20
})
4. Rank by Similarity
Score each note:
- +3 points: Same primary tag
- +2 points: Same folder
- +1 point: Shared secondary tag
- +1 point: Same frontmatter type
5. Report Results
Related Notes
═══════════════════════════════════════════════
Finding notes related to: [[MyProject]]
📊 Most Related (by score):
1. [[Related Project]] - Score: 7
• Tags: #project, #data-platform, #azure
• Folder: work/projects/
2. [[Similar Work]] - Score: 6
• Tags: #project, #methodology
• Folder: work/projects/
3. [[Connected Topic]] - Score: 5
• Tags: #methodology
• Folder: work/projects/
🏷️ Tag Matches (15):
• #project: 8 notes
• #azure: 4 notes
• #data-platform: 3 notes
📁 Folder Matches: 12 notes in work/projects/
💡 Suggestions:
• Consider linking [[MyProject]] to top 3 related notes
• Review folder matches for additional context
═══════════════════════════════════════════════
Use Cases
Research:
- "What else have I written about X?"
- "Find all project notes like this one"
Context:
- "What notes are in same topic area?"
- "Show similar work from last quarter"
Consolidation:
- "Find duplicate or overlapping content"
- "Discover notes to merge"
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?