# wiki-setup

Создаёт структуру и конфиг хранилища Obsidian для вики, а также чинит сломанную настройку. Пригодится при первом запуске или переезде.

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

## Что делает

Скилл проводит первичную настройку хранилища Obsidian, которое используется как вики. Он спрашивает, где будет лежать хранилище (`OBSIDIAN_VAULT_PATH`), откуда брать исходные документы (`OBSIDIAN_SOURCES_DIR`), подключать ли историю Claude и QMD для семантического поиска. Ответы складываются в `.env`, созданный из `.env.example`.

Дальше скилл делает дерево каталогов: `concepts`, `entities`, `skills`, `references`, `synthesis`, `journal`, `projects`, `_archives`, `_raw`, `_staging` и `.obsidian`. Каталог `.obsidian` нужен, чтобы Obsidian распознал хранилище, а `_raw` служит площадкой для черновиков, которые потом разбирает `wiki-ingest`. Специальные файлы вроде `index.md` создаёт команда `obsidian-wiki setup --vault <path>`, её же можно указать часовой пояс через `--timezone`.

Осторожно с QMD: если задан `QMD_WIKI_COLLECTION`, проверьте, что коллекция исключает `_raw/`. Хранилище содержит `_raw/`, поэтому обычный `qmd collection add <vault>` молча сольёт коллекцию вики с коллекцией статей, а `wiki-query` ссылается на них как на разные слои. Флага `--ignore` у `qmd` нет, блок `ignore` придётся дописать в `~/.config/qmd/index.yml` руками и затем выполнить `qmd update`. Ещё один момент: при `WIKI_STAGED_WRITES=true` новые страницы попадают в `_staging/` и не видны в графе Obsidian, пока их не продвинет `/wiki-stage-commit`.

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

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Ar9av/obsidian-wiki wiki-setup
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- развернуть структуру хранилища Obsidian с нуля
- создать `.env` из `.env.example` и заполнить пути
- починить хранилище после сломанной настройки
- исключить `_raw/` из коллекции QMD, чтобы слои не смешивались
- включить промежуточную запись страниц в `_staging/` для командной вики

## Примеры запросов агенту
- настрой новое хранилище Obsidian для вики
- проверь, что коллекция QMD не индексирует `_raw/`
- включи `WIKI_STAGED_WRITES` и объясни, как продвигать страницы

## Похожие
- [wiki-query](https://affpapa.org/nevibecode/skills/agricidaniel-wiki-query.md) — скилл · 462 установки
- [wiki-lint](https://affpapa.org/nevibecode/skills/agricidaniel-wiki-lint.md) — скилл · 460 установок
- [wiki-ingest](https://affpapa.org/nevibecode/skills/sanyuan0704-wiki-ingest.md) — скилл · 2700 установок
- [llm-wiki](https://affpapa.org/nevibecode/plugins/llm-wiki.md) — плагин · ★ 28733
- [li](https://affpapa.org/nevibecode/skills/li.md) — скилл · 652 установки
- [second-brain](https://affpapa.org/nevibecode/skills/coreyhaines31-second-brain.md) — скилл · 355 установок

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

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

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