Skip to content
Skills Library
Personal productivity · Automation

link-notes

/link-notes

Keep learning notes connected and free of duplicates. Finds an existing note before a new one is created, adds links between related notes, and keeps the topic index current. Used by the other note skills; also use when the user says "organize my notes on X", "link my notes", or "clean up my notes".

Licence
MIT
Last repository change
13.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Keep learning notes connected and free of duplicates. Finds an existing note before a new one is created, adds links between related notes, and keeps the topic index current. Used by the other note skills; also use when the user says "organize my notes on X", "link my notes", or "clean up my notes".

Triggers from the description

organize my notes on Xlink my notesclean up my notes
Original author description

Keep learning notes connected and free of duplicates. Finds an existing note before a new one is created, adds links between related notes, and keeps the topic index current. Used by the other note skills; also use when the user says "organize my notes on X", "link my notes", or "clean up my notes".

How it works

  1. Before creating a note
  2. After creating or updating
  3. Organize on request
Original SKILL.md headings · 23 lines, 199 words
SKILL.md preview
---
name: link-notes
description: Keep learning notes connected and free of duplicates. Finds an existing note before a new one is created, adds links between related notes, and keeps the topic index current. Used by the other note skills; also use when the user says "organize my notes on X", "link my notes", or "clean up my notes".
---

# Link notes

Load **notes-format** first.

## Before creating a note

Search the topic folder for the idea: file names, `aliases` in frontmatter, and headings. Use a plain file search (grep). If the Obsidian app is running and the idea may live outside this topic folder, the **obsidian-cli** skill's search can cover the whole vault.

- **Same idea exists:** update that note. Merge the new content, keep it one idea, bump `updated`.
- **Close but different idea:** create the new note and link the two, saying how they differ.
- **Nothing:** create it.

## After creating or updating

- Add `## Builds on` and `## Related` links in both directions where it makes sense.
- Add the note to the topic index under the right section, and update the index's Mermaid map if a new idea joins the path.
- Turn plain mentions of existing note titles into `[[links]]`, only on first mention per note.

## Organize on request

When asked to organize a topic's notes: list duplicates, orphans (notes nothing links to), and notes that hold more than one idea. Propose merges and splits, and apply them only after the user agrees. Never delete a note without asking.

Versions

The database has no other skills named link-notes.

Database snapshot: 13.11.2026 · package version 539b7d76c2f9 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100link
    Connect your notes — turn mentions of people, projects and topics into links, fix broken links and suggest related notes, then apply only the changes you approve. Use for "link this note" or "find broken links".
  • 100connect-notes
    Finds the links between a set of notes (shared ideas, contradictions, answered questions) and proposes links or a hub note with a reason for each. Use when someone wants to connect their notes, find related notes, build a map of content or an index note, see what their notes…
  • 100relate-notes
    Discover and populate related links for notes missing them. Uses the `search-kb` skill (over the Map of Content, index.md) to find connections, then updates each note's frontmatter `related` field. Use when new notes have been added, when the user asks to link or relate notes,…
  • 90organizing-notes
    Keeps a markdown knowledge base consistent - frontmatter on every note, controlled tags, links between related notes and entities. Use whenever creating or editing notes in a knowledge base, and when asked to clean up, normalize, or reorganize notes. Reads the knowledge base's…
  • 95notty
    Search, read, create, and organize Notty notes from the terminal. Use when the user mentions Notty, personal notes, a note vault, saved thoughts, or asks to find, save, append to, edit, or organize notes on this Linux machine.
  • 100note-creation
    Procedure for adding a new note to the user's second brain without duplicating what is already there: check existing notes first, pick the note's type, fill the template with its source and date, link it to related notes, and report what was written. Use it when the user asks to…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.