# Obsidian Semantic Linker

> Appends a Related Notes section with wiki-links to semantically similar notes in your Obsidian vault. Use when asked to link notes, find related ideas, or process semantic connections.

- Skill: `rami-maalouf/obsidian-semantic-linker` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add rami-maalouf/obsidian-semantic-linker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rami-maalouf/obsidian-semantic-linker/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rami-maalouf (https://skillmd.com/u/rami-maalouf)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rami-maalouf/obsidian-semantic-linker

---


# Obsidian Semantic Linker

This skill analyzes your notes and creates automated cross-links based on semantic similarity.

## Features
- **Smart Linking:** Uses local embeddings to find notes with similar meaning, even if they use different keywords.
- **Auto-Wait:** If new files are being processed, it can poll the database until they are indexed by Obsidian.
- **Non-Destructive:** Only appends links if a "Related Notes" section doesn't already exist.

## Usage
Trigger it by asking:
"Link my new notes in the unprocessed folder" or "Process semantic links for my vault".

### Parameters
- **target_dir:** The directory to scan for files to link (defaults to `unprocessed/`).