# visual-explainer

Скилл visual-explainer превращает баги, PR и фичи в пошаговые инфографики с диаграммами, подсвеченным кодом и чётким разделением на «было» и «стало».

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 235 установок · ★ 2687 у репозитория
- Автор: vercel-labs
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/vercel-labs/vgpu/tree/HEAD/.claude/skills/visual-explainer/SKILL.md
- Обновлён: 2026-10-16
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/vercel-labs-visual-explainer

## Что делает

Скилл собирает объяснение от пользовательского кода до итога: читает исходники, issue или diff PR, строит последовательность шагов и показывает, где именно сломалось и как это исправили. Для личного разбора выдаёт PDF с векторными диаграммами и текстовым кодом. Для описания PR встраивает объяснение в Markdown: нативные fence-блоки, таблицы до/после, Mermaid-диаграммы или небольшие SVG.

Диаграмма появляется только там, где нужна связь — ownership, зависимости, порядок или сравнение результатов. Код остаётся текстом с подсветкой синтаксиса, скриншоты запрещены. Скилл проверяет, что объяснение читается и без картинок: метки дублируют цвет, проза содержит суть.

Структура фиксирована: сначала проблема с заголовком вроде «До этого PR», пример кода, трассировка до точки отказа; затем решение под отдельным заголовком, те же шаги через изменённый путь и подтверждённый результат с единицами измерения. Для фичи вместо бага пишется «Было ограничение — стало возможно».

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/vgpu --skill visual-explainer -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/vgpu --skill visual-explainer -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/vgpu --skill visual-explainer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vercel-labs/vgpu .claude/skills/visual-explainer
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/vgpu --skill visual-explainer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/vercel-labs/vgpu --path .claude/skills/visual-explainer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/vgpu --skill visual-explainer -a opencode
```

### Claude.ai

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

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

## Когда брать
- объяснить баг или фичу от кода пользователя до результата
- собрать пошаговую инфографику для PR с диаграммами и подсветкой
- показать, где именно сломалось и как fix это чинит
- сделать образовательный PDF с векторными схемами и копируемым кодом

## Примеры запросов агенту
- Объясни этот PR как инфографику: что было сломано, где fix срабатывает и что изменилось для пользователя
- Сделай визуальное объяснение бага в `gpu-buffer.ts` — от вызова API до точки отказа
- Собери PDF, который покажет, как работает новая фича `parallel-compute` пошагово

## Похожие
- [plannotator-visual-explainer](https://affpapa.org/nevibecode/skills/plannotator-visual-explainer.md) — скилл · 15100 установок
- [visual-testing-advanced](https://affpapa.org/nevibecode/skills/visual-testing-advanced.md) — скилл · 163 установки
- [visual-storyteller](https://affpapa.org/nevibecode/agents/visual-storyteller.md) — субагент · ★ 1013 у репозитория
- [image-gen](https://affpapa.org/nevibecode/skills/krishagel-image-gen.md) — скилл · 4 установки
- [markdown-viewer-skills](https://affpapa.org/nevibecode/skills/markdown-viewer-skills.md) — скилл · 202 установки
- [canvas-design](https://affpapa.org/nevibecode/plugins/canvas-design.md) — плагин · ★ 2003 у репозитория

## Другие версии с тем же именем
- [visual-explainer · nicobailon](https://affpapa.org/nevibecode/skills/visual-explainer.md) — 885 установок

Из того же набора: [vercel-labs/vgpu](https://affpapa.org/nevibecode/by/vercel-labs/vgpu.md) — 3 карточки

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

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