# Pdf Report Builder

> Сборка PDF-отчётов из Markdown без обязательных зависимостей. Скрипт pdf_report_builder.py конвертирует markdown (файл или stdin) в HTML (pandoc или встроенный конвертер) и далее в PDF первым доступным движком: Chromium/Chrome headless --print-to-pdf, weasyprint или pandoc с PDF-движком (pdflatex/tectonic/typst). Поддержка заголовков, списков, таблиц, кода, цитат, ссылок, кастомный заголовок доку…

- **Type:** Skill
- **Install:** `agentstack add skill-bestdeejay-design-agent-skills-pdf-report-builder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bestdeejay-design](https://agentstack.voostack.com/s/bestdeejay-design)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bestdeejay-design](https://github.com/bestdeejay-design)
- **Source:** https://github.com/bestdeejay-design/agent-skills/tree/main/skills/pdf-report-builder
- **Website:** https://bestdeejay-design.github.io/agent-skills/

## Install

```sh
agentstack add skill-bestdeejay-design-agent-skills-pdf-report-builder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# PDF Report Builder

> Сборка PDF-отчёта из Markdown-файла: заголовки, таблицы, код, цитаты —
> в аккуратный одностраничный PDF.

Загружай этот скилл когда нужно **сделать PDF-документ из Markdown**: отчёт
по проекту, README в PDF, спецификацию, чек-лист для клиента, экспорт
документации вне GitHub.

## 🎯 When to use

Use this skill when:
- Есть `.md`-файл и нужен PDF (отчёт, README, спецификация, сопроводительное письмо)
- Нужно отправить документ клиенту/коллеге в печатном формате
- Просят «сделай отчёт в pdf», «markdown в pdf», «собери документ»

Do NOT use when:
- Достаточно HTML — проще отдать `.md` или github-rendered страницу
- Нужна презентация — это `presentation-maker`
- Нужна диаграмма — это `diagram-maker` / `mermaid-to-image`

## 📦 Files

- `SKILL.md` — этот файл
- `scripts/pdf_report_builder.py` — конвертер markdown → PDF (Python 3 stdlib)

## 🧰 Usage

```bash
# Из файла:
python3 skills/pdf-report-builder/scripts/pdf_report_builder.py -i report.md -o report.pdf --title "Project Report"

# Из stdin (пайплайн):
cat notes.md | python3 pdf_report_builder.py --stdin -o notes.pdf --title "Notes"

# Прямо из плана v1.2 и пр.
```

## 🧭 Движки (по приоритету)

1. **Chrome/Chromium/Edge headless** — `--headless --print-to-pdf` (обычно стоит на macOS)
2. **weasyprint** — `python3 -m pip install weasyprint`
3. **pandoc + PDF-движок** — `pdflatex`/`tectonic`/`typst`/`context`

Если ни одного нет — скрипт печатает подсказку по установке и завершается с кодом 1.
Разметка отрисовывается через `pandoc` (если установлен) или встроенный конвертер
(заголовки, списки, таблицы, код, цитаты, ссылки).

## 🔬 Проверка результата

- `file out.pdf` → «PDF document, version 1.4»
- Открыть в просмотрщике и проверить: заголовки, таблицы, код-блоки не обрезаны.
- Для кириллицы: шрифт по умолчанию без проблем (системный), размер страницы A4 по умолчанию.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bestdeejay-design](https://github.com/bestdeejay-design)
- **Source:** [bestdeejay-design/agent-skills](https://github.com/bestdeejay-design/agent-skills)
- **License:** MIT
- **Homepage:** https://bestdeejay-design.github.io/agent-skills/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bestdeejay-design-agent-skills-pdf-report-builder
- Seller: https://agentstack.voostack.com/s/bestdeejay-design
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.