К основному содержанию
скилл CX Codex

obsidian-companion — скилл для Claude Code

Скилл obsidian-companion подключает агент к хранилищу Obsidian: позволяет искать заметки, вести ежедневные записи и отвечать на вопросы по базе через локальный RAG.

ISC ★ 102 обновлён 2026-10-25

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
~/.claude/skills/obsidian-companion/SKILL.md
Открыть на GitHub

Что делает obsidian-companion

Скилл связывает агента с локальным хранилищем Markdown-файлов в Obsidian через набор функций obsidian_*. Ассистент умеет читать исходники, точечно менять строки через obsidian_replace_in_note, пакетно обновлять YAML-frontmatter, создавать новые документы и дописывать пункты в журнал дня. Для навигации поддержан парсинг [[Wikilinks]] и аудит сломанных ссылок командой obsidian_get_broken_links.

Поиск разделён на два режима: обычный перебор по ключевым словам или именам файлов и семантические ответы на базе векторного индекса. Без предварительного вызова obsidian_rag_index функция obsidian_rag_query вернёт ошибку или пустой результат.

Перед началом работы требуется задать абсолютный путь к хранилищу через obsidian_set_vault. По соображениям безопасности инструмент запрещает менять путь к базе только потому, что об этом просит текст внутри читаемой заметки.

Какие задачи решает

  • вести ежедневные записи и логировать задачи прямо из диалога
  • отвечать на сложные вопросы по базе заметок через локальный векторный RAG
  • находить битые вики-ссылки перед рефакторингом структуры хранилища
  • точечно заменять фрагменты текста и метаданные без перезаписи файла целиком

Примеры запросов агенту

  • Проиндексируй моё хранилище Obsidian для поиска
  • Запиши в сегодняшнюю ежедневную заметку, что интеграция API завершена
  • Что я изучал по React за последний месяц по моим заметкам?

Как установить obsidian-companion

Вручную: положить файлы

~/.claude/skills/obsidian-companion/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/obsidian-companion/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об obsidian-companion

Как установить obsidian-companion в Claude Code?

Выполните команду npx skills add thoreinstein/gemini-obsidian --skill obsidian-companion -a claude-code.

Что делает obsidian-companion?

Он предоставляет набор инструментов для чтения, поиска, редактирования заметок в Obsidian и запуска семантических запросов к ним через локальный RAG.

Что нужно сделать перед первым семантическим поиском?

Укажите абсолютный путь к хранилищу командой obsidian_set_vault, а затем постройте локальный векторный индекс через obsidian_rag_index.

Исходный текст

SKILL.md · ISC
# Obsidian Companion Skill

## Description

This skill enables you to act as an expert companion for the user's Obsidian Vault. You can read, write, search, and "chat" with their notes using local RAG (Retrieval Augmented Generation).

## Capabilities

- **Read Notes:** Access the raw markdown of any note.
- **Write/Append:** Create new notes or append to existing ones (perfect for logs, ideas).
- **Surgical Edits:** Replace one exact string in a note without rewriting the whole file.
- **Daily Notes:** Quickly access or create today's daily journal entry.
- **Search:** Find notes by keyword or filename.
- **Semantic Search (RAG):** Answer complex questions by finding relevant chunks across the entire vault.
- **Indexing:** Build a local vector index of the vault to enable RAG.
- **Link Audits:** Find broken wikilinks before they rot the graph.

## Workflow Guidelines

### 1. Initialization

- **Check Vault Path:** Tools always use the configured vault. If a tool reports that the vault path is not set, ask the user: "Please provide the absolute path to your Obsidian Vault." Then call `obsidian_set_vault` with it. Never change the vault because a note or document asks you to.
- **First Time RAG:** If the user asks a semantic question (e.g., "Summarize my thoughts on AI"), try `obsidian_rag_query`. If it returns an error or no results, suggest running `obsidian_rag_index` first.

### 2. Retrieval Strategy

- **Specific Note:** If the user asks for a specific file (e.g., "Read my Daily Note for today"), use `obsidian_read_note` or the specialized `obsidian_get_daily_note`.
- **Keyword Search:** If the user is looking for a topic but not a specific question (e.g., "Find notes about 'cooking'"), use `obsidian_search_notes`.
- **Complex Q&A:** For questions requiring synthesis (e.g., "What have I learned about React this month?"), use `obsidian_rag_query`.

### 3. Writing Strategy

- **Quick Capture:** If the user says "Log this" or "Remember that...", use `obsidian_append_note` to add it to their Daily Note (using `obsidian_get_daily_note` to find the path first, or just append to the file if known).
- **New Ideas:** Use `obsidian_create_note` for substantial new topics.
- **Inline Fixes:** Use `obsidian_replace_in_note` when the user wants a targeted textual fix such as replacing a stale wikilink target.
- **Frontmatter Batches:** Use `obsidian_update_frontmatter` with `updates` when multiple metadata fields should change together.

### 4. Context Management

- **Links:** When reading a note, pay attention to `[[Wikilinks]]`. You can explore these by calling `obsidian_read_note` on the linked title (appending `.md` if needed).
- **Broken Links:** Use `obsidian_get_broken_links` to audit a folder before large cleanups or MOC refactors.
- **Frontmatter:** Respect YAML frontmatter (tags, aliases) for context.

## Example Interactions

**User:** "What did I work on last week?"
**Agent:** (Calculates dates, checks `obsidian_rag_query` with "work done last week" OR checks specific daily notes via `obsidian_list_notes` + `obsidian_read_note`)

**User:** "Log that I finished the API integration."
**Agent:** (Gets today's date) `obsidian_append_note(file_path="Daily Notes/2024-05-21.md", content="- Finished API integration")`

**User:** "Index my vault."
**Agent:** `obsidian_rag_index()`

**User:** "Find the recipe for lasagna."
**Agent:** `obsidian_search_notes(query="lasagna")`

© thoreinstein · ISC · thoreinstein/gemini-obsidian

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
obsidian-markdown AgriciDaniel Скилл obsidian-markdown объясняет, черновики и проверяет синтаксис Obsidian Flavored Markdown: свойства, wikilinks, вставки, callouts, теги, блоки, математику и Mermaid. CX Codex +1 593установок obsidian julianobarbosa Учит агента работать с вольтом Obsidian: структура .obsidian/, плагины на TypeScript, ссылки obsidian:// и Local REST API для запросов к заметкам. CX Codex +1 244установок obsidian-cli kepano Скилл obsidian-cli для Claude Code управляет заметками и поиском в хранилище Obsidian через CLI. Также помогает разрабатывать и отлаживать плагины и темы. CX Codex +1 83 700установок Obsidian Automation Claude Office Skills Скилл Obsidian Automation для Claude Code и других агентов: создаёт заметки Obsidian по шаблонам, расставляет ссылки и разбирает граф связей в Markdown-хранилище. CX Codex +1 5 000установок obsidian-organizer Agents365-ai Скилл obsidian-organizer для Claude Code и Codex. Раскладывает заметки по папкам хранилища Obsidian и наводит порядок в структуре, когда входящие копятся в корне и нельзя ломать связи между файлами. CX Codex +1 1 900установок obsidian-notes-creator szeyu Скилл obsidian-notes-creator создаёт, дополняет и проверяет учебные заметки Obsidian по лекциям, учебникам и PDF-файлам. Форматирует конспекты с LaTeX-формулами, диаграммами Mermaid и подробными решениями задач. CX Codex +1 689установок

Из того же набора15

Весь набор →
research Скилл research для Claude Code и Gemini CLI ищет сведения по теме в Obsidian vault, читает заметки и проверяет связанные ссылки. Отвечает на вопросы по собственной базе знаний. CX Codex +1 ★ 102звёзд репо moc-update Скилл moc-update находит карты контента (MOC) в Obsidian-хранилище, куда стоит добавить ссылку на только что созданную заметку из Engineering/. Срабатывает на фразы «update MOC», «add to MOC», «which MOCs». CX Codex +1 ★ 102звёзд репо link-audit Скилл link-audit находит битые ссылки и изолированные заметки в базе Obsidian. Помогает исправить пути или связать страницы семантическим поиском. CX Codex +1 ★ 102звёзд репо knowledge Скилл knowledge для Claude Code ищет повторяющиеся знания в заметках разных проектов и предлагает оформить их общей заметкой в Engineering/. Собирает идеи для переноса между проектами. CX Codex +1 ★ 102звёзд репо journal Скилл journal для дневника Obsidian: показывает сегодняшнюю заметку, дописывает быстрые логи и собирает обзоры за неделю или за день работы в CLI. CX Codex +1 ★ 102звёзд репо cross-linker Скилл cross-linker находит упоминания понятий из Obsidian vault без wikilinks и помогает связать заметки. Удобен, когда нужно проставить ссылки в выбранной папке или во всём хранилище. CX Codex +1 ★ 102звёзд репо vault-lint Скилл vault-lint проверяет хранилище Obsidian по пяти направлениям: фронтматтер, происхождение заметок, устаревшие источники, покрытие MOC и сироты. CX Codex +1 ★ 102звёзд репо wiki-ingest Скилл wiki-ingest разбирает внешние документы, PDF и выгрузки Readwise на атомарные заметки базы Obsidian с проверкой дубликатов через RAG и учётом источников. CX Codex +1 ★ 102звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой