linking-notes

Analyze a target note's content and tags to propose wiki-link connections.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/alexanderop/vault-astro --skill linking-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linking-notes
Source: https://github.com/alexanderop/vault-astro/tree/main/.claude/skills/linking-notes
Command: npx skills add https://github.com/alexanderop/vault-astro --skill linking-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually discovering connections and adding wiki-links between notes is time-consuming and often incomplete, leading to orphaned content and a fragmented knowledge graph.

Core Features & Use Cases

  • Automatic Discovery: Scans a target note’s title, tags, and key concepts to find related notes via title mentions, tag overlap, or shared terms.
  • Connection Evaluation: Applies criteria to recommend strong links and avoid vague or indirect connections.
  • Map Note Suggestions: Detects clusters of three or more related notes and proposes creating a Map Note (MOC) for better organization.
  • Use Case Example: When you ask to “find connections” for a note about habit formation, the skill suggests linking to notes on motivation, routine tracking, and related research.

Quick Start

Request the linking-notes skill to suggest wiki-links for a specific note title.

Frequently Asked Questions about linking-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically find related notes to create wiki-links?

To automatically find related notes for wiki-links, analyze a target note's content, tags, and concepts to search the repository for related files via title mentions, tag overlap, or shared terms.

What is a map note and when do I need to create one?

A map note (MOC) is a structural note organizing clusters of related content. You need to create one when your repository contains clusters of three or more related notes that require better organizational context.

Can I use file search commands like grep to discover tag overlap in my notes?

Yes, discovering tag overlap requires file-search commands like grep or glob. The skill executes these commands to retrieve matching files from your notes directory and evaluate shared terms for relevant connections.

What's the best way to prevent orphaned content in a knowledge graph?

The best way to prevent orphaned content in a knowledge graph is to automatically scan notes for shared concepts and tag overlaps, proposing strong wiki-links to connect fragmented notes that would otherwise remain isolated.

Why does my note linking suggest irrelevant or vague connections?

Note linking may suggest vague connections when evaluation criteria are too broad. Strong links require matching specific title mentions, direct tag overlap, or shared key concepts, avoiding indirect relationships that fragment the knowledge graph.

Do I need read access to my notes directory to build map notes?

Yes, you need read access to the notes directory to build map notes. The skill must scan files, extract tags and concepts, and execute file-search commands to detect clusters of related notes.