# obsidian

Маршрутизирует работу с хранилищем Obsidian между MCP-сервером, CLI приложения и git. Помогает безопасно переименовывать заметки, обновлять теги и делать бэкапы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 установок · ★ 1703
- Автор: bitbonsai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/bitbonsai/mcpvault/tree/HEAD/skills/obsidian/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/bitbonsai-obsidian

## Что делает

Скилл распределяет операции по трём каналам. Для поиска, чтения и правок текста он по умолчанию обращается к MCP. При запросах на резервное копирование или синхронизацию запускается git-конвейер с `git pull --rebase`. Вызовы через Obsidian CLI скилл оставляет для открытия заметок по URI и запуска специфичных сценариев внутри приложения.

При переносе и переименовании файлов агент всегда использует метод `move_note` из MCP. Вызывать команду перемещения через CLI Obsidian запрещено: из-за бага #176 задержка пересчёта ссылок способна испортить текст в других файлах. После смены имени скилл находит старые вики-ссылки и правит их во всех зависимых документах, сохраняя алиасы и якоря заголовков. Поиск ограничен лимитом в 20 результатов. Если лимит достигнут, агент запросит подтверждение перед продолжением сканирования.

Правка заметок через `patch_note` не сработает с пустыми строками. Управление тегами тоже имеет нюанс: команда `manage_tags` считывает и строчные `#теги`, и параметры шапки, но добавляет новые значения только в YAML-блок frontmatter.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bitbonsai/mcpvault --skill obsidian -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bitbonsai/mcpvault --skill obsidian -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bitbonsai/mcpvault --skill obsidian -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bitbonsai/mcpvault obsidian
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bitbonsai/mcpvault --skill obsidian -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add bitbonsai/mcpvault --skill obsidian -a opencode
```

### Claude.ai

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

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

## Когда брать
- Переименовать заметку и обновить входящие вики-ссылки
- Синхронизировать хранилище через git с rebase
- Найти заметки по фразе с ограничением выдачи
- Добавить теги в YAML-шапку без изменения встроенных хэштегов

## Примеры запросов агенту
- Переименуй заметку Projects/Alpha в Archive/Alpha и обнови все ссылки на неё
- Сделай бэкап хранилища в git с коммитом текущих изменений
- Найди все упоминания термина архитектура во frontmatter заметок

## Похожие
- [obsidian-cli](https://affpapa.org/nevibecode/skills/obsidian-cli.md) — скилл · 81000 установок
- [obsidian-organizer](https://affpapa.org/nevibecode/skills/obsidian-organizer.md) — скилл · 1800 установок
- [obsidian-markdown](https://affpapa.org/nevibecode/skills/agricidaniel-obsidian-markdown.md) — скилл · 545 установок
- [obsidian-bases](https://affpapa.org/nevibecode/skills/agricidaniel-obsidian-bases.md) — скилл · 498 установок
- [obsidian-literature-workflow](https://affpapa.org/nevibecode/skills/obsidian-literature-workflow.md) — скилл · 408 установок
- [Obsidian Automation](https://affpapa.org/nevibecode/skills/obsidian-automation.md) — скилл · 4800 установок

## Другие версии с тем же именем
- [obsidian · openclaw](https://affpapa.org/nevibecode/skills/obsidian.md) — 6400 установок
- [obsidian · nousresearch](https://affpapa.org/nevibecode/skills/teknium-teknium1-hermes-agent-obsidian.md) — 455 установок

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

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