# wiki-narrate

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

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

## Что делает

Скилл превращает тему базы знаний в форматированный Markdown-отчёт, строго опираясь на заметки хранилища Obsidian. Перед составлением текста агент формирует реестр утверждений со ссылками на страницы хранилища и проверяет статус каждого факта. Для поиска страниц используются `hot.md`, `index.md`, а также утилита QMD с откатом на `rg`. Внутренние заметки с метками `visibility/internal` или `visibility/pii` полностью исключаются из выдачи в фильтрованном режиме.

Команда `/wiki-narrate` поддерживает три фиксированных стиля: `briefing` по умолчанию, `plain-language` и `lecturer`. Переданный стиль задаёт порядок разделов, но не расширяет фактологические границы. Скилл принципиально блокирует обращение к интернету и общей памяти модели: любые пробелы в материалах хранилища он фиксирует в секции `## Coverage`, а не маскирует домыслами.

По умолчанию отчёт выводится прямо в диалог. Флаг `--save` создаёт каталог `_readouts/` и сохраняет файл `_readouts/<slug>.md` с метаданными темы и источников. После успешного сохранения инструмент обновляет горячий кэш `hot.md` и вносит запись о событии `WIKI_NARRATE` в журнал `log.md`.

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

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- составить бриф по теме только по заметкам хранилища Obsidian
- подготовить структурированную лекцию с цитатами из базы знаний
- выявить противоречия и пробелы в накопленных заметках
- сохранить готовый отчёт в папку `_readouts/`

## Примеры запросов агенту
- /wiki-narrate "архитектура микросервисов" --voice briefing
- /wiki-narrate "квантовые алгоритмы" --voice lecturer --save
- /wiki-narrate "онбординг сотрудников" --voice plain-language

## Похожие
- [obsidian-cli](https://affpapa.org/nevibecode/skills/obsidian-cli.md) — скилл · 81000 установок
- [obsidian](https://affpapa.org/nevibecode/skills/obsidian.md) — скилл · 6400 установок
- [obsidian-organizer](https://affpapa.org/nevibecode/skills/obsidian-organizer.md) — скилл · 1800 установок
- [wiki](https://affpapa.org/nevibecode/skills/agricidaniel-wiki.md) — скилл · 539 установок
- [wiki-lint](https://affpapa.org/nevibecode/skills/agricidaniel-wiki-lint.md) — скилл · 460 установок
- [wiki-ingest](https://affpapa.org/nevibecode/skills/sanyuan0704-wiki-ingest.md) — скилл · 2700 установок

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

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

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