К основному содержанию
скилл CX Codex

plannotator-visual-explainer — скилл для Claude Code

Скилл plannotator-visual-explainer для Claude Code создаёт HTML-визуализации планов, PR-разборов, архитектурных диаграмм и слайдов в тёмной теме Plannotator.

Apache-2.0 15 100 установок ★ 14 187 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add backnotprop/plannotator --skill plannotator-visual-explainer -a claude-code
Открыть на GitHub

Что делает plannotator-visual-explainer

Скилл строит самодостаточные HTML-документы с фиксированной типографикой (serif для заголовков, mono для меток), палитрой и компонентами Plannotator. Для планов внедрения и дизайн-доков он рисует временные шкалы без оценок длительности, инлайн-SVG с выделением новых компонентов, таблицы рисков с тремя уровнями серьёзности. Для PR-разборов — мета-ленту с числом файлов и строк, двухколоночное сравнение «до/после», файловые карточки со статусом NEW/MOD/DEL и подсветкой синтаксиса через Pierre diffs.

Всё остальное (архитектурные диаграммы, таблицы данных, слайды) передаёт visual-explainer с подменой палитры на токены Plannotator. Для Mermaid-диаграмм обязательна отрисовка в светлой и тёмной палитре до открытия: исключение, пустой SVG или aria-roledescription="error" блокируют доставку. Поддержка zoom-контролов для диаграмм требует читаемой подписи на всех масштабах и панорамах.

Отправка всегда через plannotator annotate <файл> — без open или xdg-open. Планы и предложения получают флаг --gate для согласования.

Какие задачи решает

  • собрать план внедрения с временной шкалой, SVG-схемой и таблицей рисков
  • визуализировать PR для ревьюера: карта файлов, diff-блоки, зоны внимания
  • сгенерировать архитектурную диаграмму или слайд-дек с темой Plannotator
  • отрисовать Mermaid в светлой и тёмной палитре с проверкой ошибок до доставки
  • построить HTML-мокап интерфейса прямо в документе без описаний

Примеры запросов агенту

  • Нарисуй план миграции базы на Postgres с временной шкалой и SVG-схемой — через plannotator annotate с флагом --gate
  • Сделай PR-разбор: мета-лента, сравнение до/после, файловые карточки со статусом и картой рисков
  • Построй архитектурную диаграмму с темой Plannotator и zoom-контролами — проверь оба рендера Mermaid перед открытием

Как установить plannotator-visual-explainer

1Через Skills CLI (Vercel)

npx skills add backnotprop/plannotator --skill plannotator-visual-explainer -a claude-code

2Вручную: положить файлы

~/.claude/skills/plannotator-visual-explainer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/plannotator-visual-explainer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о plannotator-visual-explainer

Как установить plannotator-visual-explainer в Claude Code?

Выполни npx skills add backnotprop/plannotator --skill plannotator-visual-explainer -a claude-code, затем проверь ~/.claude/skills/plannotator-visual-explainer/SKILL.md.

Что делает plannotator-visual-explainer?

Генерирует HTML-визуализации планов, PR-разборов и архитектурных диаграмм с темой Plannotator. Планы получают временные шкалы и SVG-схемы, PR — файловые карточки с diff-блоками, остальное передаёт visual-explainer с заменой палитры.

Чем отличается путь плана от пути PR?

План читает design-system.md и svg-patterns.md, строит временную шкалу без оценок длительности, таблицу рисков и инлайн-SVG. PR читает pr-components.md, рисует мета-ленту с числом строк, файловые карточки со статусом NEW/MOD/DEL и diff-блоки через Pierre.

Исходный текст

SKILL.md · Apache-2.0
---
name: plannotator-visual-explainer
disable-model-invocation: true
description: >
  Generate self-contained HTML visualizations with Plannotator theming. Use for implementation
  plans, PR explainers, architecture diagrams, data tables, slide decks, and any visual
  explanation of technical concepts. Plans and PR explainers follow Plannotator's prescriptive
  approach; all other visual content delegates to nicobailon/visual-explainer.
---

# Plannotator Visual Explainer

Three paths depending on content type. Each has its own references and structure.

## Route by content type

**Implementation plan, design doc, or proposal** → Follow the [Plan path](#plan-path). Read `references/design-system.md` and `references/svg-patterns.md`. Prescriptive structure.

**PR explainer, diff review, or code change walkthrough** → Follow the [PR path](#pr-path). Read `references/design-system.md` and `references/pr-components.md`. Prescriptive structure.

**Everything else** (architecture diagrams, data tables, slide decks, project recaps, general visual explanations) → Follow the [Visual explainer path](#visual-explainer-path). Delegates to nicobailon/visual-explainer with Plannotator theme tokens.

## Delivery

Always deliver via Plannotator's annotation UI. Do NOT use `open` or `xdg-open`.

For any deliverable that uses Mermaid, render every diagram with Mermaid 12 in both the light
and dark palettes before opening the annotation UI. Rendering is a hard gate: an exception,
empty SVG, or error output such as `aria-roledescription="error"` or `Syntax error in text`
means the explainer is not deliverable. Fix the diagram or theme configuration and rerun both
palettes until every SVG passes.

For zoomable diagram shells, additionally zoom to the maximum and pan to all extremes in both palettes before delivering: the figure caption must stay fully legible throughout (see `references/diagram-shell.md`).

**Plans/proposals** (user should approve/deny):
```bash
plannotator annotate <file> --gate
```

**Everything else** (informational):
```bash
plannotator annotate <file>
```

---

## Plan path

For implementation plans, design docs, feature specs, migration guides, and proposals.

**Before generating, read:**
1. `references/design-system.md` — Plannotator theme tokens, typography, component patterns
2. `references/svg-patterns.md` — inline SVG building blocks for architecture diagrams, flowcharts, data flow

**Document structure (in order, pick what fits):**

1. **Header** — eyebrow label (mono, uppercase), title (serif, large), prompt box (the original brief)
2. **Summary strip** — 3-5 stat cards showing key numbers at a glance (components, endpoints, tables, etc.)
3. **Milestones / timeline** — vertical timeline showing phases without time estimates. Phases show sequence and dependencies, not duration.
4. **Architecture / data flow** — inline SVG diagram. Use for 3+ interacting components. Highlighted boxes for new components, dashed arrows for async paths.
5. **Mockups** — build UI mockups in HTML/CSS directly, not as descriptions
6. **Key code** — dark-theme code blocks with syntax highlighting. Only architecturally significant interfaces/schemas — not every function.
7. **Risks & mitigations** — table with severity badges (HIGH/MED/LOW)
8. **Open questions** — callout cards with decision owner ("Decide with: backend team")

Not every plan needs every section. Skip what doesn't serve the content. Never include time estimates, boilerplate sections, or exhaustive file lists.

**Adapt to the task:** Backend → lead with data flow. Frontend → lead with mockups. Refactoring → lead with before/after diagrams. Infrastructure → lead with architecture.

**Quality bar:** The plan answers "what, why, and how" within 30 seconds of reading. Whitespace is a feature — one idea per viewport.

---

## PR path

For PR walkthroughs, diff reviews, code change explainers, and reviewer guides.

**Before generating, read:**
1. `references/design-system.md` — Plannotator theme tokens, typography, component patterns
2. `references/pr-components.md` — diff rendering, review comment bubbles, risk chips, file cards, before/after panels

**Document structure (in order, pick what fits):**

1. **Header** — PR title, meta strip (file count, +/- lines, branch, author)
2. **TL;DR** — bordered card with primary accent left border. 2-3 sentences. Readers who see nothing else should get the gist.
3. **Why** — motivation and before/after comparison (two-column grid)
4. **File tour** — collapsible cards per file. Each has: file path + badge (NEW/MOD/DEL) + line stats, a "why" paragraph, and important diff hunks. High-risk files expanded, safe files collapsed.
5. **Risk map** — visual chips showing which files need careful review vs. which are mechanical. Three tiers: attention (destructive), medium (warning), safe (success).
6. **Where to focus** — numbered callout cards. Each names a file/function and describes the concern.
7. **Test plan** — checkbox-style verification checklist
8. **Rollout** (if applicable) — phased deployment with feature flags

Use Pierre diffs via CDN for syntax-highlighted inline diffs — see `references/pr-components.md` for the pattern.

---

## Visual explainer path

For architecture diagrams, data tables, slide decks, project recaps, comparisons, and any other visual explanation.

**Before generating:**

1. Ensure `visual-explainer` is installed:
   - Check: `~/.claude/skills/visual-explainer/SKILL.md` or `~/.agents/skills/visual-explainer/SKILL.md`
   - If not found: do not install it on your own. Stop and ask the person whether to install it, showing the exact command:
     `npx skills add nicobailon/visual-explainer -g --yes`
     Run it only after they agree (their yes is the consent; without `--yes` the installer waits for input your shell can't give). They can also run the command themselves if they prefer. If they decline, say this path needs visual-explainer and stop. The Plan and PR paths do not need it and work without it.
2. Read visual-explainer's `SKILL.md` (workflow, diagram types, anti-slop rules)
3. Read the relevant visual-explainer references and templates for your content type
4. Read `references/theme-override.md` — Plannotator tokens replacing Nico's palettes
5. For zoomable Mermaid diagrams with controls and a caption: read `references/diagram-shell.md` and copy its shell — do not hand-roll viewport, canvas, or caption markup

Follow visual-explainer's structure, component classes (`.ve-card`, `.kpi-card`, `.pipeline`), and anti-slop rules. Overrides are the color/typography layer — Plannotator tokens instead of Nico's custom palettes — plus the zoomable diagram shell in `references/diagram-shell.md` when the deliverable has one.

---

## Design philosophy (all paths)

- **Whitespace is a feature.** Generous padding, large section gaps. If cramped, add space — don't shrink text.
- **One idea per viewport.** Hero section, then diagram, then detail grid — not all crammed together.
- **Show, don't describe.** A timeline shows sequencing. A diagram shows relationships. A code block shows the interface.
- **No time estimates.** Timelines show phases and dependencies. Never attach hour/day estimates.

© backnotprop · Apache-2.0 · backnotprop/plannotator

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
visual-explainer nicobailon Скилл visual-explainer для Claude Code и Codex строит наглядные автономные HTML-страницы вместо длинных текстовых ответов. Превращает архитектуру, дифы кода и планы миграций в интерактивные схемы. CX Codex +1 885установок code-to-diagram zebbern Скилл code-to-diagram разбирает импорты в кодовой базе и строит архитектурные схемы, блок-схемы и иерархии файлов. Пригодится перед ревью или рефакторингом. CX Codex +1 ★ 4 719звёзд репо visual syahiidkamil Команда visual превращает обсуждение изменения в самодостаточный HTML-документ с диаграммами, вайрфреймами и таблицами, из которого агент строит код в plan mode. CX Codex +1 ★ 406звёзд репо diagram-creator claude-office-skills Скилл diagram-creator генерирует схемы и архитектурные диаграммы на языках разметки Mermaid, PlantUML или D2. Пригодится при оформлении документации, описании API и баз данных. CX Codex +1 5 200установок arch-diagram bassnova42 Скилл arch-diagram для Claude Code превращает исходный код, статьи или заметки в подробные архитектурные схемы. Он визуализирует структуру проекта в интерактивные HTML-страницы или диаграммы Mermaid. CX Codex +1 ★ 145звёзд репо agent-mermaid-diagram-specialist softaworks Плагин agent-mermaid-diagram-specialist для Claude Code генерирует диаграммы Mermaid: flowchart, sequence diagram, ERD и архитектурные схемы. Визуализирует процессы, связи в базе и взаимодействие компонентов. ★ 2 707звёзд репо

Из того же набора8

plannotator-compound Скилл plannotator-compound разбирает архив Plannotator и собирает из отклонённых планов паттерны отказов, таксономию фидбека и готовые правки промптов. На выходе — HTML-дашборд с отчётом. CX Codex +1 13 900установок plannotator-setup-goal Скилл plannotator-setup-goal превращает идею в готовый пакет цели через интервью с пользователем, сбор фактов и анализ кодовой базы. Помогает чётко сформулировать, что нужно сделать, и создать план выполнения. CX Codex +1 13 600установок plannotator-last Скилл plannotator-last открывает утилиту Plannotator для разметки последнего ответа ассистента и передаёт комментарии обратно в чат. CX Codex +1 1 200установок plannotator-annotate Скилл plannotator-annotate открывает интерфейс аннотаций Plannotator для файла, папки или ссылки и передаёт правки обратно агенту. CX Codex +1 1 200установок plannotator-review Скилл plannotator-review для Claude Code запускает браузерный интерфейс ревью кода Plannotator и передаёт правки агенту. Проверяет диффы перед слиянием. CX Codex +1 1 200установок plannotator Скилл подключает Plannotator к агенту для ревью планов, диффов и документов через локальный браузер. Ответы человека возвращаются агенту структурированными. CX Codex +1 276установок plannotator-inbox Открывает Plannotator Inbox в браузере и сообщает его адрес. В течение сессии он помогает передавать решения и результаты долгой работы через Inbox. CX Codex +1 199установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой