obsidian-companion — скилл для Claude Code
Скилл obsidian-companion подключает агент к хранилищу Obsidian: позволяет искать заметки, вести ежедневные записи и отвечать на вопросы по базе через локальный RAG.
ISC ★ 102 обновлён 2026-10-25
~/.claude/skills/obsidian-companion/SKILL.mdЧто делает 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/
Вручную: положить файлы
.agents/skills/obsidian-companion/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/obsidian-companion/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install thoreinstein/gemini-obsidian skills/obsidian-companion2Вручную: положить файлы
.github/skills/obsidian-companion/SKILL.mdКомандой платформы
gemini skills install https://github.com/thoreinstein/gemini-obsidian --path skills/obsidian-companionВручную: положить файлы
.devin/skills/obsidian-companion/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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