# Obsidian Similar Notes

> Finds notes semantically similar to a given file using Smart Connections embeddings, at note or block level. Use when asked to find similar or related notes.

- Skill: `rami-maalouf/obsidian-similar-notes` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add rami-maalouf/obsidian-similar-notes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rami-maalouf/obsidian-similar-notes/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-similar-notes

---


# Obsidian Similar Notes

Queries Smart Connections embeddings (.smart-env/multi/) to find the most semantically related notes to any file in your vault.

## Features
- **Note-level mode**: compares whole-note embeddings
- **Block-level mode**: compares per-heading embeddings - identifies *which section* of the target note matches *which section* of similar notes
- **Both mode** (default): runs both and shows results side by side

## Usage

```bash
cd ai-agents-config/skills/
.venv/bin/python obsidian-similar-notes/scripts/find_similar.py "path/to/note.md"
```

### Arguments
- positional: file path (absolute, relative to cwd, or vault-relative)
- `--mode note|block|both` - similarity mode (default: both)
- `--threshold 0.45` - minimum similarity score (default: 0.45)
- `--top 10` - number of results to show (default: 10)
- `--vault /path/to/vault` - vault root (auto-detected if omitted)

### Example

```bash
.venv/bin/python obsidian-similar-notes/scripts/find_similar.py \
  "My Outputs/Transcriptions/Sense of control.md" --mode both --top 5
```