Generate beautifully designed PDF reports

Elegant reports

by jdrhyne · MIT license · ★ 240 on GitHub · updated Aug 30

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.

---
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:

Overview

Generate minimalist PDF reports inspired by Scandinavian editorial design.

Manual install (npx, ZIP)

Claude Codenpx skills add jdrhyne/agent-skills --skill elegant-reports -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/jdrhyne/agent-skills/tar.gz/439cd3a9da78 \
  | tar -xz -C ~/.claude/skills --strip-components=2 agent-skills-439cd3a9da78/skills/elegant-reports

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/814171a029a0a6a9fbcf/elegant-reports.zip" -OutFile "$env:TEMP\elegant-reports.zip"; Expand-Archive "$env:TEMP\elegant-reports.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md4.4 KB
.gitignore28 B
NORDIC_DESIGN_RESEARCH.md8.6 KB
generate.js11.5 KB
package-lock.json10.1 KB
package.json599 B
examples/3 files · 252.8 KB
references/1 file · 8.6 KB
scripts/1 file · 1.1 KB
templates/8 files · 46.1 KB
themes/5 files · 51.4 KB

Read the files here

jdrhyne/439cd3a24 files

SKILL.md

Show the full text112 lines

elegant-reports/SKILL.md112 lines · 4.4 KB

PreviewCode

Outline

RawView on GitHub

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:

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:

---
title: Q4 Competitive Analysis
subtitle: Market Intelligence Report
author: Report Author
template: report
theme: dark
---

Your content here...

Workflow

Pick the closest existing template instead of starting from scratch.
Write or refine the source markdown.
Generate a PDF.
If layout tuning is needed, inspect the emitted HTML with --output-html and adjust the corresponding template/theme pair.
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

1	---
2	name: elegant-reports
3	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.
4	metadata: {"clawdbot":{"requires":{"bins":["node","npm"]}}}
5	permissions:
6	- exec: "Runs the local Node generator to list templates, render preview HTML, and create PDF outputs when the user asks."
7	- file_read: "Reads bundled templates, themes, examples, and design references inside the skill directory plus user-approved input markdown files."
8	- file_write: "Writes generated HTML/PDF outputs and user-requested template or theme files inside approved working directories."
9	- network: "Calls Nutrient DWS and any hosted font assets used by the bundled templates when the user requests report generation."
10	---
11
12	# elegant-reports
13
14	Generate minimalist PDF reports inspired by Scandinavian editorial design.
15
16	## When to Use
17
18	Use this skill when the user wants:
19	- polished executive briefings or board-style reports
20	- presentation-like PDFs generated from markdown
21	- a clean Nordic visual language instead of default developer styling
22	- a reusable report template system that can be extended carefully
23
24	## Quick Start
25
26	Install the pinned dependencies from `package-lock.json`, then run:
27
28	```bash
29	cd /path/to/elegant-reports
30	node ./generate.js --list
31	node ./generate.js examples/sample-executive.md output.pdf --template executive --theme light
32	```
33
34	For HTML debugging, add `--output-html` so the generator saves the rendered HTML alongside the PDF.
35
36	## Available Templates
37
38	\| Template \| Use Case \|
39	\|----------\|----------\|
40	\| `executive` \| polished briefings and compact executive summaries \|
41	\| `report` \| denser narrative reports and analysis writeups \|
42	\| `presentation` \| bold slide-like outputs with one idea per page \|
43	\| `report-demo` \| legacy report variant for comparison/testing \|
44	\| `presentation-demo` \| legacy presentation variant for comparison/testing \|
45
46	Each template supports `light` and `dark` themes where available.
47
48	## Frontmatter
49
50	Add YAML frontmatter to control the rendered output:
51
52	```markdown
53	---
54	title: Q4 Competitive Analysis
55	subtitle: Market Intelligence Report
56	author: Report Author
57	template: report
58	theme: dark
59	---
60
61	Your content here...
62	```
63
64	## Workflow
65
66	1. Pick the closest existing template instead of starting from scratch.
67	2. Write or refine the source markdown.
68	3. Generate a PDF.
69	4. If layout tuning is needed, inspect the emitted HTML with `--output-html` and adjust the corresponding template/theme pair.
70	5. Re-run until the design is clean and the PDF is stable.
71
72	## Extending the Skill
73
74	When authoring a new visual variant:
75	- start from the nearest bundled template and theme
76	- keep token names and spacing scales consistent with the existing system
77	- make one visual change at a time and regenerate after each step
78	- prefer additive variants over rewriting the whole design language
79	- keep legacy/demo templates available until the replacement is verified
80
81	The bundled Nordic design research note is the canonical reference for the visual system. Read it only when you need deeper design rationale.
82
83	## Safety Boundaries
84
85	- 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.
86	- Do not browse arbitrary local files. Limit reads to the skill bundle and user-approved input/output paths.
87	- Do not overwrite or delete files outside the user-approved working directory.
88	- Do not install extra packages, change dependency versions, or add new external services unless the user explicitly asks for that setup work.
89	- Do not claim a report was generated successfully unless the output artifact exists and the generator completed without error.
90	- Do not fetch external design inspiration or web references unless the user explicitly wants fresh visual research.
91
92	## Dependencies
93
94	- Node.js 18+
95	- pinned npm dependencies from `package-lock.json`
96	- `NUTRIENT_DWS_API_KEY` environment variable for PDF generation
97
98	## File Map
99
100	- main generator CLI and module entrypoint
101	- bundled HTML templates
102	- bundled visual themes
103	- sample markdown input
104	- optional deeper design rationale bundled with the skill
105
106	## Validation
107
108	Before calling the skill done:
109	- run `node ./generate.js --list`
110	- run `npm test`
111	- verify the expected PDF or HTML artifact exists in the requested output path
112