elegant-reports — скилл для Claude Code: PDF-отчёты в северном стиле
Скилл elegant-reports собирает PDF из markdown в сдержанной скандинавской вёрстке: брифинги для руководства, аналитические разборы, презентационные страницы.
MIT ★ 239 обновлён 2026-08-30
npx skills add jdrhyne/agent-skills --skill elegant-reports -a claude-codeЧто делает elegant-reports
Скилл превращает markdown в PDF через Nutrient DWS. Шаблон и тему берёт готовые, вёрстку не переизобретает. Шаблонов пять: executive для коротких сводок, report для плотного текста, presentation для слайдов с одной мыслью на странице и два demo-варианта для сравнения. Тема — light или dark.
Внутри CLI generate.js со списком шаблонов, сами HTML-шаблоны и темы, примеры markdown и заметка о дизайн-системе. Заголовок, подзаголовок, автора, шаблон и тему задают в YAML-frontmatter. Для отладки есть --output-html: рядом с PDF сохранится отрендеренный HTML, по нему видно, какой кусок шаблона двигать.
Нужен Node.js 18+, зависимости из package-lock.json и переменная NUTRIENT_DWS_API_KEY. Без ключа PDF не собрать, потому что рендер уходит на внешний сервис, а значит исходный документ покидает машину. Для внутренних отчётов это важнее внешнего вида. Файлы вне согласованной рабочей папки скилл трогать не должен, версии зависимостей тоже меняет только по прямой просьбе.
Какие задачи решает
- собрать PDF-брифинг для руководства из markdown-черновика
- перевести готовый отчёт в тёмную тему без перевёрстки
- посмотреть отрендеренный HTML, чтобы поправить отступы в шаблоне
- сделать презентационный PDF, где на странице одна мысль
- сравнить новую вёрстку со старой demo-версией
Примеры запросов агенту
- Собери PDF из
examples/sample-executive.mdпо шаблонуexecutiveв светлой теме - Покажи список доступных шаблонов и тем
- Пересобери отчёт с
--output-html, хочу глянуть HTML и подкрутить поля
Как установить elegant-reports
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill elegant-reports -a claude-code2Вручную: положить файлы
~/.claude/skills/elegant-reports/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/elegant-reports/
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill elegant-reports -a codex2Вручную: положить файлы
.agents/skills/elegant-reports/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill elegant-reports -a cursor2Вручную: положить файлы
.cursor/skills/elegant-reports/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jdrhyne/agent-skills skills/elegant-reports2Вручную: положить файлы
.github/skills/elegant-reports/SKILL.md1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill elegant-reports -a gemini-cli2Командой платформы
gemini skills install https://github.com/jdrhyne/agent-skills --path skills/elegant-reportsВручную: положить файлы
.devin/skills/elegant-reports/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об elegant-reports
Как установить elegant-reports в Claude Code?
Выполните npx skills add jdrhyne/agent-skills --skill elegant-reports -a claude-code. Скилл окажется по пути ~/.claude/skills/elegant-reports/SKILL.md.
Что делает elegant-reports?
Берёт markdown с YAML-frontmatter и отдаёт готовый PDF: выбирает шаблон и тему, собирает вёрстку и рендерит файл через Nutrient DWS.
Что нужно, чтобы PDF собрался?
Node.js 18+, зависимости из package-lock.json и NUTRIENT_DWS_API_KEY в окружении. Ключ обязателен: рендер идёт на стороне Nutrient DWS, локально PDF не появится.
Исходный текст
SKILL.md · MIT
---
name: elegant-reports
description: Generate beautifully designed PDF reports with a Nordic/Scandinavian aesthetic. Use when creating polished executive briefings, analysis reports, or presentation-style PDF outputs from markdown and HTML via Nutrient DWS.
metadata: {"clawdbot":{"requires":{"bins":["node","npm"]}}}
permissions:
- exec: "Runs the local Node generator to list templates, render preview HTML, and create PDF outputs when the user asks."
- file_read: "Reads bundled templates, themes, examples, and design references inside the skill directory plus user-approved input markdown files."
- file_write: "Writes generated HTML/PDF outputs and user-requested template or theme files inside approved working directories."
- network: "Calls Nutrient DWS and any hosted font assets used by the bundled templates when the user requests report generation."
---
# elegant-reports
Generate minimalist PDF reports inspired by Scandinavian editorial design.
## When to Use
Use this skill when the user wants:
- polished executive briefings or board-style reports
- presentation-like PDFs generated from markdown
- a clean Nordic visual language instead of default developer styling
- a reusable report template system that can be extended carefully
## Quick Start
Install the pinned dependencies from `package-lock.json`, then run:
```bash
cd /path/to/elegant-reports
node ./generate.js --list
node ./generate.js examples/sample-executive.md output.pdf --template executive --theme light
```
For HTML debugging, add `--output-html` so the generator saves the rendered HTML alongside the PDF.
## Available Templates
| Template | Use Case |
|----------|----------|
| `executive` | polished briefings and compact executive summaries |
| `report` | denser narrative reports and analysis writeups |
| `presentation` | bold slide-like outputs with one idea per page |
| `report-demo` | legacy report variant for comparison/testing |
| `presentation-demo` | legacy presentation variant for comparison/testing |
Each template supports `light` and `dark` themes where available.
## Frontmatter
Add YAML frontmatter to control the rendered output:
```markdown
---
title: Q4 Competitive Analysis
subtitle: Market Intelligence Report
author: Report Author
template: report
theme: dark
---
Your content here...
```
## Workflow
1. Pick the closest existing template instead of starting from scratch.
2. Write or refine the source markdown.
3. Generate a PDF.
4. If layout tuning is needed, inspect the emitted HTML with `--output-html` and adjust the corresponding template/theme pair.
5. Re-run until the design is clean and the PDF is stable.
## Extending the Skill
When authoring a new visual variant:
- start from the nearest bundled template and theme
- keep token names and spacing scales consistent with the existing system
- make one visual change at a time and regenerate after each step
- prefer additive variants over rewriting the whole design language
- keep legacy/demo templates available until the replacement is verified
The bundled Nordic design research note is the canonical reference for the visual system. Read it only when you need deeper design rationale.
## Safety Boundaries
- Do not send sensitive source documents to third-party services unless the user explicitly requested PDF generation through Nutrient DWS and accepts that network boundary.
- Do not browse arbitrary local files. Limit reads to the skill bundle and user-approved input/output paths.
- Do not overwrite or delete files outside the user-approved working directory.
- Do not install extra packages, change dependency versions, or add new external services unless the user explicitly asks for that setup work.
- Do not claim a report was generated successfully unless the output artifact exists and the generator completed without error.
- Do not fetch external design inspiration or web references unless the user explicitly wants fresh visual research.
## Dependencies
- Node.js 18+
- pinned npm dependencies from `package-lock.json`
- `NUTRIENT_DWS_API_KEY` environment variable for PDF generation
## File Map
- main generator CLI and module entrypoint
- bundled HTML templates
- bundled visual themes
- sample markdown input
- optional deeper design rationale bundled with the skill
## Validation
Before calling the skill done:
- run `node ./generate.js --list`
- run `npm test`
- verify the expected PDF or HTML artifact exists in the requested output path
© jdrhyne · MIT · jdrhyne/agent-skills