slides-generator — скилл для Claude Code: PDF-слайды из markdown
Собирает презентацию в PDF из markdown-файла: титульный слайд, разделы, таблицы, код и диаграммы Mermaid. Пригодится, когда нужен доклад или техническая документация без ручной вёрстки.
npx skills add hummingbot/skills --skill slides-generator -a claude-codeЧто делает slides-generator
Скилл берёт markdown и превращает его в PDF-колоду в оформлении Hummingbot. Заголовок первого уровня становится титульным слайдом, каждый ## N. Название — отдельным слайдом, а всё под ним уходит в содержимое: списки, жирный и курсив, блоки кода, таблицы. Перед сборкой агент показывает список слайдов и ждёт подтверждения, так что лишний прогон не запустится.
Диаграммы описываются словами через mermaid: — агент переводит описание в код Mermaid и подставляет его в слайд. Если на слайде есть и текст, и диаграмма, они раскладываются в две колонки. Для рендера диаграмм нужен Mermaid CLI: npm install -g @mermaid-js/mermaid-cli. Без него схема не отрисуется, а текстовая часть соберётся как обычно — это повод поставить пакет заранее.
Сборку выполняет generate_slides.sh, который тянется с GitHub и сам проверяет наличие Python 3 и пакета fpdf2. Править готовую колоду можно флагом --edit: агент читает исходный markdown, вносит правки и пересобирает только изменённые слайды. Формат жёсткий — если разметка не следует шаблону ## N. Title, на выходе получится пустой PDF.
Какие задачи решает
- собрать PDF-презентацию из markdown-файла
- вставить диаграмму архитектуры в слайд по текстовому описанию
- разложить текст и схему в две колонки на одном слайде
- поправить отдельные слайды в готовой колоде и пересобрать её
- сделать техническую документацию в виде слайдов с блоками кода
Примеры запросов агенту
- Собери PDF-слайды из
report.md, выход —~/report.pdf - Добавь слайд с диаграммой: mermaid: поток данных от API к Gateway
- Пересобери колоду с флагом
--edit, поменяй только третий слайд
Как установить slides-generator
1Через Skills CLI (Vercel)
npx skills add hummingbot/skills --skill slides-generator -a claude-code2Вручную: положить файлы
~/.claude/skills/slides-generator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/slides-generator/
1Через Skills CLI (Vercel)
npx skills add hummingbot/skills --skill slides-generator -a codex2Вручную: положить файлы
.agents/skills/slides-generator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hummingbot/skills --skill slides-generator -a cursor2Вручную: положить файлы
.cursor/skills/slides-generator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hummingbot/skills slides-generator2Вручную: положить файлы
.github/skills/slides-generator/SKILL.md1Через Skills CLI (Vercel)
npx skills add hummingbot/skills --skill slides-generator -a gemini-cli2Командой платформы
gemini skills install https://github.com/hummingbot/skills --path skills/slides-generatorВручную: положить файлы
.devin/skills/slides-generator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add hummingbot/skills --skill slides-generator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о slides-generator
Как установить slides-generator в Claude?
Выполните npx skills add hummingbot/skills --skill slides-generator -a claude-code. Скилл появится в ~/.claude/skills/slides-generator/SKILL.md.
Что делает slides-generator?
Превращает markdown в PDF-презентацию: титульный слайд, разделы, таблицы, блоки кода и диаграммы Mermaid. Перед сборкой показывает список слайдов и ждёт подтверждения.
Что нужно для работы диаграмм?
Mermaid CLI, ставится командой npm install -g @mermaid-js/mermaid-cli. Скрипт сборки отдельно проверяет Python 3 и пакет fpdf2.
