Invoke when writing, updating, or organizing notes in an Obsidian vault. Handles topic discovery, index creation with Mermaid diagrams, deep-dive notes, compression of existing content, and source attribution. Triggers: "write to obsidian", "save this to my vault", "create notes about", "add to obsidian", "document this topic", "make obsidian notes".
search_notes_tool with the topic name before doing anything else.Topic/Subtopic/ hierarchy — never flat single-level folders.00 - {Topic} — Index.mdAlways create this first. Template:
# {Topic}
> One-sentence summary of what this topic covers.
## Overview
2–4 sentences. No padding. State what it is and why it matters.
## Diagram
```mermaid
(flowchart, sequence, or mindmap — pick the one that best represents the topic)
| Note | What it covers |
|---|---|
| [[Folder/00 - Topic — Index]] | This index |
| [[Folder/01 - Subtopic A]] | Brief description |
| [[Folder/02 - Subtopic B]] | Brief description |
### Step 4 — Deep-Dive Notes
Create as many as the topic warrants (no fixed cap). Naming: `01 - Subtopic.md`, `02 - Subtopic.md`, etc.
**Hard limit: 500 words per note.** No filler. Every sentence earns its place.
Template:
```markdown
# Subtopic Title
> One-line summary.
(Explanation — bullets or short prose, whichever is clearer for this content.)
## Sources
- [Title](URL)
Rules:
[[Folder/00 - Topic — Index]]> blockquotes for key insights.When existing notes are found:
note_read.After all notes are written, apply the obsidian-canvas skill to build or update the visual map.
| Rule | Detail |
|---|---|
| Wikilinks | Always full vault-relative: [[Folder/Subfolder/Note]] |
| Code | Fenced blocks with language tag |
| Comparisons | Markdown tables |
| Key insights | > blockquote |
| Word limit | 500 words max per note |
| Index naming | 00 - {Topic} — Index.md — never bare Index.md |
| Sources | Every note citing external info must have ## Sources |
| Claude knowledge | Note as: > Source: Claude training knowledge as of {date} |