report-to-pdf — скилл для Codex: что делает и как установить
Конвертирует отчёты Data Analytics и графики из статического HTML в PDF через headless Chrome с проверкой вёрстки.
npx skills add openai/plugins --skill report-to-pdf -a codexЧто делает report-to-pdf
Скилл берёт готовый аналитический отчёт или график и переводит его в PDF. В качестве основы нужен статический HTML-файл. Если запустить печать напрямую из живого MCP-приложения в ChatGPT Desktop, ничего не выйдет из-за изоляции хоста без моста печати.
Основной путь сборки — запуск системного Chrome или Chromium в режиме --headless=new с флагом --print-to-pdf. Скрипт очищает итоговый документ от интерфейсных кнопок вроде обновления или шаринга. Если готового HTML нет, но в сессии остался artifact.json, конвертер может собрать переносимый файл через Node.js-скрипт.
Готовый PDF проходит валидацию через утилиты pdfinfo, pdftotext и pdftoppm. Они проверяют читаемость текста и отсутствие пустых графиков. Без установленного браузера Chrome процесс остановится с ошибкой.
Какие задачи решает
- экспортировать аналитический HTML-отчёт в документ PDF без потери разметки
- убрать интерфейсные кнопки и служебные панели веб-приложения со страниц отчёта
- проверить сгенерированный PDF на пустые графики и битые переносы через
pdftoppm - собрать статический HTML из
artifact.json, если нет прямого экспорта дашборда
Примеры запросов агенту
- Сохрани открытый дашборд Data Analytics в файл PDF
- Сконвертируй статический отчёт report.html в PDF через Chrome
Как установить report-to-pdf
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill report-to-pdf -a codex2Вручную: положить файлы
.agents/skills/report-to-pdf/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill report-to-pdf -a claude-code2Вручную: положить файлы
~/.claude/skills/report-to-pdf/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/report-to-pdf/
Вручную: положить файлы
.cursor/skills/report-to-pdf/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins report-to-pdf2Вручную: положить файлы
.github/skills/report-to-pdf/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/build-report/report-to-pdfВручную: положить файлы
.devin/skills/report-to-pdf/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о report-to-pdf
Как установить report-to-pdf в Codex?
Выполните команду npx skills add openai/plugins --skill report-to-pdf -a codex. Также можно вручную поместить файл навыка по пути .agents/skills/report-to-pdf/SKILL.md.
Что делает report-to-pdf?
Скилл находит локальный HTML-экспорт отчёта или дашборда и преобразует его в векторный PDF с помощью безголового Chrome. Перед отдачей файла он убирает лишние кнопки интерфейса и проверяет целостность графиков.
Почему скилл не печатает отчёт напрямую из окна MCP-приложения?
Окружение ChatGPT Desktop изолирует MCP-интерфейсы и не даёт прямого доступа к механизму печати. Поэтому процессу требуется предварительный экспорт разметки в статичный HTML.
