# html-over-markdown

Скилл html-over-markdown создаёт автономные HTML-файлы с диаграммами, сетками и интерактивом вместо Markdown для отчётов, планов и разборов кода.

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

## Что делает

Скилл переключает вывод агента с плоского Markdown на один самостоятельный файл `.html` в папке `./outputs/`. Внутрь встраиваются SVG-диаграммы вместо ASCII-графики, интерактивные вкладки, адаптивная сетка и стили по шаблону `assets/base-template.html`. Документ открывается в браузере без сборки проекта.

Поддерживаются пять сценариев: спецификации и планы, разбор пуллреквестов с аннотированными диффами, прототипы интерфейсов со слайдерами, отчёты и временные редакторы конфигураций. Любые интерактивные элементы содержат кнопку копирования JSON или промпта обратно в буфер обмена.

Для версионируемых спецификаций в Git, где коллегам нужны строковые диффы, скилл использовать нельзя: в этом случае лучше оставить Markdown.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill html-over-markdown -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill html-over-markdown -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill html-over-markdown -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install happycapy-ai/Happycapy-skills skills/html-over-markdown
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill html-over-markdown -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/happycapy-ai/Happycapy-skills --path skills/html-over-markdown
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- визуализировать архитектуру и зависимости в SVG вместо ASCII
- сравнить несколько вариантов дизайна или подходов в сетке
- составить понятный разбор пуллреквеста с заметками на полях
- собрать временный интерактивный редактор конфигов или флагов

## Примеры запросов агенту
- Сделай план миграции базы данных в виде HTML-страницы с диаграммой связей
- Разбери изменения в этом PR и оформи интерактивный отчёт со списком диффов
- Сравни три варианта архитектуры кэширования в таблице с плюсами и минусами

## Похожие
- [markdown-html-skills](https://affpapa.org/nevibecode/plugins/markdown-html-skills.md) — плагин · ★ 30251 у репозитория
- [markdown-html-orchestrator](https://affpapa.org/nevibecode/skills/markdown-html-orchestrator.md) — скилл · 46 установок
- [article-to-html](https://affpapa.org/nevibecode/skills/article-to-html.md) — скилл · 220 установок
- [baoyu-markdown-to-html](https://affpapa.org/nevibecode/skills/baoyu-markdown-to-html.md) — скилл · 32900 установок
- [markdown-to-html](https://affpapa.org/nevibecode/skills/markdown-to-html.md) — скилл · 9899 установок
- [Markdown to HTML — Headings, Code, Tables](https://affpapa.org/nevibecode/mcp/markdown-to-html-headings-code-tables.md) — MCP-сервер · 4038 установок

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

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

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