Elegant Reports Agent Skill

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.

101k tokens

context cost

the whole folder, loaded on every use

files

ships runnable scripts

copies elsewhere

how many repositories repackaged it

239

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/jdrhyne/agent-skills --skill elegant-reports

The instruction itself

11 sections, as written by the author

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

Other skills for the same job

different authors, same section of the catalogue

Matplotlib

by christophacham

×3

Low-level plotting library for full customization. Use when you need fine-grained control over every plot element, creating novel plot types, or integrating with specific scientific workflows. Export to PNG/PDF/SVG for publication. For quick statistical plots use seaborn; for interactive plots use plotly; for publication-ready multi-panel figures with journal styling, use scientific-visualization.

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

> This skill orchestrates autonomous discovery of brand materials across enterprise platforms (Notion, Confluence, Google Drive, Box, SharePoint, Figma, Gong, Granola, Slack). It should be used when the user asks to "discover brand materials", "find brand documents", "search for brand guidelines", "audit brand content", "what brand materials do we have", "find our style guide", "where are our brand docs", "do we have a style guide", "discover brand voice", "brand content audit", or "find brand assets".

6k tokens

Matplotlib Scientific Plotting

by BioTender-max

×1

Low-level Python plotting for scientific figures: publication-quality line, scatter, bar, heatmap, contour, 3D; multi-panel layouts; fine control of every element. PNG/PDF/SVG export. Use seaborn for quick stats, plotly for interactive.

4k tokens

Baoyu Format Markdown

by ComeOnOliver

×1

Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layout. Outputs to {filename}-formatted.md.

Enterprise-grade PowerPoint deck generation system using evidence-based prompting techniques, workflow enforcement, and constraint-based design. Use when creating professional presentations (board decks, reports, analyses) requiring consistent visual quality, accessibility compliance, and integration of complex data from multiple sources. Implements html2pptx workflow with spatial layout optimization, validation gates, and multi-chat architecture for 30+ slide decks.

PPTX HTML Fidelity Audit

by nexu-io

Audit a python-pptx export against its source HTML deck, identify layout/content drift (footer overflow, cropped content, missing italic/em, lost styling, off-rhythm spacing), and re-export with strict footer-rail + cursor-flow layout discipline. Use this skill whenever the user has a .pptx that was generated from an HTML slide deck and asks to compare/audit/verify/fix the export — including phrases like "compare ppt with html", "fidelity audit", "fix the pptx", "ppt is cut off", "footer overlap", "italic missing in pptx", "re-export the deck", "pptx-html-fidelity-audit", or any case where a python-pptx → HTML round-trip needs verification or repair. Also trigger when the user shows you a deck.html and a deck.pptx side by side and is debugging visual differences.

15k tokens scripts

How to use it

Copy the folder

Take jdrhyne/elegant-reports from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.