md-slidesавтор Alireza Rezvani

MD Slides Skill.

Q: Какие агенты для кода могут запускать этот skill?

В файле перечислены claude-code, codex-cli, cursor, antigravity, opencode и gemini-cli как совместимые инструменты, а также его может запустить markdown-html-orchestrator, классифицировав входные данные как SLIDES.

Q: Что если в моём markdown нет явных границ слайдов?

Skill отказывается вместо того, чтобы угадывать, и завершается с кодом 6; документированный следующий шаг — направить этот файл в md-document, который обрабатывает один непрерывный документ, а не отдельные слайды.

Q: Как получить PDF из презентации?

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

Навык для Claude Code и Codex в области презентаций и слайд-колод: преобразует Markdown-презентацию в брендированные слайды.

Presentations
HTML-слайды

Скачать OpenDesign Инструкция по использованию

alirezarezvani/claude-skills · markdown-html/skills/md-slides/SKILL.mdSKILL.md

--- name: md-slides description: Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional `` presenter notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide … --- ## When to invoke ## Pipeline ## What ships in the HTML ## Hard rules ## Forcing-question library (Matt Pocock grill discipline) ## Distinct from

Преамбула и заголовки разделов прочитаны из исходного файла 2026-09-14 · 6 506 символов полностью

01 Что делает

Что делает Skill md-slides в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

md-slides преобразует markdown-презентацию в единый HTML-файл, работающий в любом браузере. Презентация — это слайды, разделённые границами --- HR или заголовками # H1, с необязательными блоками заметок докладчика . Конвейер из трёх Python-скриптов stdlib: slide_splitter.py, presenter_notes_parser.py, deck_html_renderer.py.

Результат включает навигацию с клавиатуры, глубокие ссылки через URL-hash, индикатор прогресса и счётчик слайдов, режим докладчика с часами и предпросмотром следующего слайда, а также таблицу стилей для печати с экспортом в PDF по одному слайду на страницу. Skill повторно использует парсер markdown из md-document и считывает токены дизайн-системы через config_loader.py. Он отказывается обрабатывать входные данные без чётких границ слайдов, презентации из 1 слайда, файлы менее 100 строк и презентации, не проходящие 50%-ное покрытие --strict-notes.

Что он выдаёт

Отрендеренная HTML-презентация, записанная как deck-{slug}.html в разрешённую директорию вывода по умолчанию, с добавлением -2, -3 и так далее при коллизиях.
Промежуточные JSON-файлы, содержащие разделённые слайды, а затем слайды с прикреплёнными к ним заметками.
PDF с одним слайдом на странице, созданный через таблицу стилей для печати путём печати из браузера.

Смотрите пример запроса ↗

Как это работает

01
Разбиение презентации на упорядоченные слайды
slide_splitter.py считывает исходный markdown и разбивает его по строкам --- HR или заголовкам H1, по умолчанию автоматически определяя стиль границ, и записывает упорядоченный список слайдов.
02
Прикрепление заметок докладчика к каждому слайду
presenter_notes_parser.py сканирует каждый слайд на наличие блоков заметок и прикрепляет их к этому слайду, чтобы режиму докладчика было что показать на панели справа.
03
Рендеринг единого HTML-файла презентации
deck_html_renderer.py объединяет слайды с токенами дизайн-системы и формирует презентацию, принимая заголовок и путь вывода в командной строке.
04
Применение токенов дизайн-системы
Двенадцать брендовых CSS custom properties берутся из дизайн-системы, а design_style меняет плотность макетов слайдов.
05
Отказ от входных данных, которые не являются презентациями
Skill завершает работу вместо преобразования, если во входных данных нет чётких границ слайдов, если результатом стал бы один слайд, либо если проверка покрытия заметками не пройдена в режиме --strict-notes.

02 Определите своё применение

Когда использовать Skill md-slides

Используйте skill md-slides в Claude Code или Codex, когда задача — PPT и слайд-презентации такого рода. Соответствие и ограничения ниже взяты из собственного файла skill.

Хорошо подходит

Оркестратор классифицировал входные данные как SLIDES и направил их сюда.
Кто-то вызывает skill напрямую для markdown-файла с помощью слеш-команды.
В markdown уже есть 3 или более строк-разделителей --- либо 5 или более заголовков H1 с короткими телами.
Презентация будет показана вживую, и именно в этом случае заметки докладчика важны, а при самостоятельном чтении они становятся необязательными.

Знайте границы

Входные данные представляют собой развёрнутую спецификацию, а не презентацию; это должно направляться в md-document.
Входные данные — это код-ревью, которое относится к md-review.
Это не инструмент графического дизайна: Keynote и PowerPoint занимают эту область, а этот инструмент работает с презентациями, написанными в markdown и проецируемыми из браузера.

Что предоставить

Файл презентации в markdownЕго путь передаётся в slide_splitter.py с помощью --input, а результат разбиения записывается в JSON-файл с помощью --output.
Стиль границСлайды должны быть различимы — либо по границам-разделителям ---, либо по заголовкам H1, чтобы у сплиттера было, по чему резать.
Необязательные заметки докладчикаЗаметки задаются как блоки HTML-комментариев внутри слайдов и разбираются и прикрепляются к каждому слайду на втором шаге конвейера.

03 Внутри скилла

Правила, которые skill md-slides задаёт Claude Code и Codex

8 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт для агента — та часть файла, которая влияет на результат.

Требование к границам
Автоматический режим требует минимум 3 строки-разделителя или минимум 5 заголовков H1 в исходнике; если ни одно из условий не выполнено, skill отказывается работать, и входные данные должны направляться в md-document.
Запрет на результат в один слайд
Презентация, которая сводится к одному слайду, отклоняется как плакат, а не презентация, с кодом выхода 5.
Минимум 100 строк исходника
Входные данные короче 100 строк отклоняются — используется тот же порог Shihipar, что и во всех конвертерах.
Проверка онбординга
Skill отказывается работать без онбординга — тот же барьер, что и у всех конвертеров.
Строгое покрытие заметками
В режиме --strict-notes skill отклоняет презентацию, где менее 50% слайдов содержат заметки, поскольку она не подготовлена для режима докладчика; такой отказ завершается кодом выхода 7.
Предупреждение о слишком длинных слайдах
Слайды из более 40 исходных строк вызывают мягкое предупреждение о соотношении сигнал/шум; колода всё равно рендерится, но количество строк отображается.
Оставлять вывод в виде одного файла
Весь CSS и JS встроены инлайн; единственный внешний ресурс — CSS Google Fonts, а Prism.js подключается опционально через --syntax, а не встроен по умолчанию.
Без Рантайма Фреймворка
Колода использует только чистый JS и обработчики событий клавиатуры, без рантайма React, Vue или Svelte.

04 Применение

Установите md-slides в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавьте md-slides в Claude Code, Codex или ваш агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

Terminal

npx skills add https://github.com/alirezarezvani/claude-skills --skill md-slides

Общая форма CLI skills для markdown-html/skills/md-slides/SKILL.md; репозиторий может документировать собственный путь.

Дайте skill первую задачу с PPT и слайд-деками

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt

Convert [deck.md] into a presentation. It uses --- HR boundaries for slides and each slide has a <!-- notes: ... --> block. Title it "[Talk title]" and run it with --strict-notes, since it will be presented live rather than read on its own. Write the result to [output/deck.html].

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

Откройте колоду в браузере и пройдитесь по клавишам: стрелки, Space и PgDn продвигают вперёд, PgUp возвращает назад, Home и End переходят к началу/концу, P переключает режим докладчика, Esc выходит из него.
Проверьте глубокие ссылки: #3 должен переходить на слайд 3, кнопки браузера «назад» и «вперёд» должны перемещаться по слайдам, а общая ссылка deck.html#5 должна открываться прямо на слайде 5.
Проверьте счётчик слайдов в правом нижнем углу, который выглядит как «3 / 12», сопоставив его с общей длиной колоды.
Убедитесь, что медиазапрос reduced-motion учитывается, чтобы анимация отключалась для зрителей, запросивших меньше движения.

В OpenDesign импортируйте md-slides по его ссылке SKILL.md: Plugins → Add → Skill → Import from link, затем выберите его в верхней панели.

Скачать OpenDesign Читать quickstart

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

Откуда взяты факты на этой странице и когда они были последний раз проверены.

Author: Alireza Rezvani
Repository: github.com/alirezarezvani/claude-skills Ветка main
Файл skill: markdown-html/skills/md-slides/SKILL.md Контрольная сумма содержимого зафиксирована при проверке; коммит 19392f7
License: MIT Из LICENSE.
Звёзды репозитория: 25 934 Снимок GitHub сделан 14.09.2026 для всего репозитория alirezarezvani/claude-skills, который содержит 5 skills в этом каталоге. Не является рейтингом или счётчиком использования md-slides.
Проверено OpenDesign: 2026-09-14 Исходный файл, путь, текст лицензии и количество звезд были проверены. Не входит в основной комплект OpenDesign (проверено 2026-08-28); живой запуск не был записан на этой странице.

Внутри SKILL.md

Когда вызыватьСимптомы для маршрутизации, а также какие входные данные следует отклонять или отправлять в другое место.
КонвейерТри команды, которые разбивают, разбирают заметки и рендерят колоду.
Что входит в HTMLНавигация, глубокие ссылки, режим докладчика, стили печати, токены, повторное использование парсера.
Жёсткие правилаПороги отказа, мягкие предупреждения и ограничения на вывод в виде одного файла.
Библиотека уточняющих вопросов (дисциплина разбора Мэтта Покока)Пять вопросов, которые нужно решить перед конвертацией исходного файла.
Отличие отЧем это отличается от md-document, md-review, лендингов, Keynote.
Выходной артефактРазрешение пути вывода и соглашение о суффиксе при коллизии.
ИсточникиИсточники и канон, лежащие в основе соглашений колоды.

Собственное описание skill

"Преобразует колоду слайдов в Markdown (слайды разделены границами `---` или заголовками `# ` H1, с опциональными блоками заметок докладчика ``) в HTML-презентацию в одном файле с навигацией клавишами-стрелками / пробелом / PgDn / PgUp / Home / End / P / Esc, режимом докладчика (разделённый вид с текущим слайдом + заметками + часами + предпросмотром следующего слайда), прямыми ссылками через URL-hash и выводом `@media print` по одной странице на слайд для экспорта в PDF. Срабатывает, когда markdown-html-orchestrator классифицирует ввод как SLIDES, или при прямом вызове через /cs:md-slides. Использует парсер markdown из md-document для рендеринга тела слайдов и читает токены design-system через config_loader.py. Отказывается, если во вводе нет чётких границ слайдов, получается колода из 1 слайда или включён `--strict-notes` при покрытии заметками < 50%. Используйте после роутинга оркестратора."

Описание из front-matter в SKILL.md. Полный файл содержит около 6 506 символов. Читать полный файл на GitHub.

06 Перед установкой

Вопросы о skill md-slides

Ответы взяты из SKILL.md в редакции от 2026-09-14, а не из записанного запуска.

Какие агенты для кода могут запускать этот skill?

В файле перечислены claude-code, codex-cli, cursor, antigravity, opencode и gemini-cli как совместимые инструменты, а также его может запустить markdown-html-orchestrator, классифицировав входные данные как SLIDES.

Что если в моём markdown нет явных границ слайдов?

Skill отказывается вместо того, чтобы угадывать, и завершается с кодом 6; документированный следующий шаг — направить этот файл в md-document, который обрабатывает один непрерывный документ, а не отдельные слайды.

Как получить PDF из презентации?

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

MD Slides

Запустите md-slides на реальной задаче по PPT и слайд-презентациям.

Загрузите OpenDesign, импортируйте md-slides по ссылке на SKILL.md, вставьте промпт выше и прочитайте план перед результатом.

Загрузить OpenDesign Все навыки

Терминал

npx skills add https://github.com/alirezarezvani/claude-skills --skill md-slides

Что делает Skill md-slides в Claude Code и Codex

Словами самого skill

Как это работает

Когда использовать Skill md-slides

Хорошо подходит

Знайте границы

Что предоставить

Правила, которые skill md-slides задаёт Claude Code и Codex

Требование к границам

Запрет на результат в один слайд

Минимум 100 строк исходника

Проверка онбординга

Строгое покрытие заметками

Предупреждение о слишком длинных слайдах

Оставлять вывод в виде одного файла

Без Рантайма Фреймворка