# visualize

Собирает интерактивный HTML-граф из OKF-бандла: концепты как узлы, ссылки как рёбра, панель с отрендеренным markdown. Пригодится, когда нужно окинуть взглядом структуру базы знаний.

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

## Что делает

Скилл читает каталог OKF-бандла и генерирует один самодостаточный файл `viz.html`. Узлы — концепты, цвет задаётся типом, размер зависит от длины тела. Рёбра — markdown-ссылки и записи `sources`, ведущие на другие концепты внутри бандла. Бэкенда нет, содержимое бандла со страницы никуда не уходит.

В панели деталей видно `type`, `description`, `tags`, `status`, `generated`, `verified`, `stale_after` и `sources` с сигналами достоверности, а также обратные ссылки «Links to» и «Cited by». Два бейджа выводятся расчётом, а не читаются из файла: уровень доверия по §5.3 и устаревание. Это подсказки, а не запрет — при отчёте по бандлу просто называйте уровень концепта. Старый `timestamp` из v0.1 читается как `generated.at`, поэтому легаси-бандлы рендерятся целиком.

Запуск идёт через `uv run` со скриптом `scripts/okf_visualize.py`; если `uv` нет, ставится `pyyaml` и скрипт вызывается через `python3`. Каталог бандла обязателен — без пути явно передайте `.okf`. Просмотрщику нужен сетевой доступ: cytoscape, marked и dompurify тянутся с cdn.jsdelivr.net. Выше 1 000 концептов раскладка сама переключается на `concentric`, потому что силовая замораживает страницу; выше 5 000 скилл предупреждает о медленной загрузке и советует рендерить подкаталог.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scaccogatto/okf-skills --skill visualize -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scaccogatto/okf-skills --skill visualize -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scaccogatto/okf-skills --skill visualize -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scaccogatto/okf-skills visualize
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scaccogatto/okf-skills --skill visualize -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add scaccogatto/okf-skills --skill visualize -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- визуализируй бандл .okf
- сделай граф из docs/knowledge и сохрани в report/viz.html
- открой граф бандла с раскладкой circle

## Похожие
- [arquiteto-de-empresa](https://affpapa.org/nevibecode/skills/arquiteto-de-empresa.md) — скилл · 51 установка
- [memory-notes](https://affpapa.org/nevibecode/skills/memory-notes.md) — скилл · 1300 установок
- [understand-anything](https://affpapa.org/nevibecode/plugins/understand-anything.md) — плагин · ★ 88314
- [markdown-to-html](https://affpapa.org/nevibecode/skills/markdown-to-html.md) — скилл · 9899 установок
- [answer-me-with-html](https://affpapa.org/nevibecode/skills/answer-me-with-html.md) — скилл · 5400 установок
- [md2wechat](https://affpapa.org/nevibecode/skills/md2wechat.md) — скилл · 2500 установок

Из того же набора: [scaccogatto/okf-skills](https://affpapa.org/nevibecode/by/scaccogatto/okf-skills.md) — 2 карточки

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

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