# obsidian-companion

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

- скилл · `type=skill` · Claude Code, Gemini CLI, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Claude.ai · ★ 102 у репозитория
- Автор: thoreinstein
- Лицензия: ISC · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/thoreinstein/gemini-obsidian/tree/HEAD/skills/obsidian-companion/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`. По соображениям безопасности инструмент запрещает менять путь к базе только потому, что об этом просит текст внутри читаемой заметки.

## Требования
- Работает с: Obsidian

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `~/.claude/skills/obsidian-companion/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/obsidian-companion/

### Codex

**Вручную: положить файлы**
- Файл: `.agents/skills/obsidian-companion/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/obsidian-companion/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thoreinstein/gemini-obsidian skills/obsidian-companion
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/obsidian-companion/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/thoreinstein/gemini-obsidian --path skills/obsidian-companion
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/obsidian-companion/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/thoreinstein/gemini-obsidian/tree/HEAD/skills/obsidian-companion/SKILL.md

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

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

## Похожие
- [obsidian-markdown](https://affpapa.org/nevibecode/skills/agricidaniel-obsidian-markdown.md) — скилл · 593 установки
- [obsidian](https://affpapa.org/nevibecode/skills/julianobarbosa-obsidian.md) — скилл · 244 установки
- [obsidian-cli](https://affpapa.org/nevibecode/skills/obsidian-cli.md) — скилл · 83700 установок
- [Obsidian Automation](https://affpapa.org/nevibecode/skills/obsidian-automation.md) — скилл · 5000 установок
- [obsidian-organizer](https://affpapa.org/nevibecode/skills/obsidian-organizer.md) — скилл · 1900 установок
- [obsidian-notes-creator](https://affpapa.org/nevibecode/skills/obsidian-notes-creator.md) — скилл · 689 установок

Из того же набора: [thoreinstein/gemini-obsidian](https://affpapa.org/nevibecode/by/thoreinstein/gemini-obsidian.md) — 15 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
