Skip to content
Skills Library
Data & analytics · Writing

data-reporting

/data-reporting

Produce a parametric PDF report describing a dataset — size, schema, distributions, key statistics, and findings from other skills — compiled via Typst. Use when the user wants a shareable, print-ready document about their data, not a one-off markdown summary.

Licence
MIT
Last repository change
15.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 15.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Produce a parametric PDF report describing a dataset — size, schema, distributions, key statistics, and findings from other skills — compiled via Typst. Use when the user wants a shareable, print-ready document about their data, not a one-off markdown summary.

Original author description

Produce a parametric PDF report describing a dataset — size, schema, distributions, key statistics, and findings from other skills — compiled via Typst. Use when the user wants a shareable, print-ready document about their data, not a one-off markdown summary.

How it works

  1. Inputs
  2. Recommended tooling
  3. Output layout
  4. Procedure
  5. Notes
Original SKILL.md headings · 166 lines, 995 words
SKILL.md preview
---
name: data-reporting
description: Produce a parametric PDF report describing a dataset — size, schema, distributions, key statistics, and findings from other skills — compiled via Typst. Use when the user wants a shareable, print-ready document about their data, not a one-off markdown summary.
---

# Data Reporting

Generate a parametric dataset report as a Typst-compiled PDF. "Parametric" here means the report structure is fixed and reusable — you fill in the parameters (dataset path, title, sections to include, cut-offs) and the document regenerates from scratch.

Use this skill when the user wants:
- A stakeholder-ready PDF describing a dataset.
- A reproducible document that can be regenerated on data refresh.
- A consolidation of outputs from other skills (`data-dictionary-creator`, `trend-analysis`, `correlation-analysis`, `standard-deviation`, `sample-size`, `forensic-sweep`, etc.) into one artefact.

For quick markdown summaries, use the reporting step inside the relevant analysis skill instead — this skill is for when PDF is the deliverable.

## Inputs

- Path to a dataset (CSV / Parquet / Excel / DuckDB table).
- Report parameters (all optional; sensible defaults applied):
  - `title` — report title. Default: dataset filename.
  - `subtitle` — e.g. snapshot date.
  - `author` — defaults to system user.
  - `sections` — which sections to include. Default: `overview`, `schema`, `size`, `distributions`, `quality`, `findings`.
  - `max_columns_profiled` — cap detailed profiling for very wide tables. Default: 50.
  - `include_charts` — boolean. Default: true.
  - `theme` — `plain` / `dsr-business` / `personal`. Default: `plain`.

## Recommended tooling

- `duckdb` — all stat computation.
- `uv run --with pandas --with matplotlib python -c '...'` — distribution plots rendered to PNG for Typst to embed. Matplotlib only (no seaborn) to keep dependencies minimal.
- `typst` — compile the document.
- The `typst-document-generator` skills (`public-doc`, `personal-doc`, `dsr-business-doc`) — for themed output. When `theme != plain`, delegate final compilation to the matching skill.

## Output layout

Create an output folder: `outputs/data-reporting/<dataset-stem>-<YYYYMMDD>/`:

```
outputs/data-reporting/sales-2026-04-23/
  report.typ          -- the Typst source
  report.pdf          -- compiled output
  assets/
    hist_price.png
    hist_quantity.png
    bar_category.png
    missingness.png
  data/
    summary_stats.csv
    schema.csv
  params.json         -- exact parameters used, for reproducibility
```

## Procedure

### Step 1 — Parse parameters

Resolve defaults. Validate that the dataset exists and is readable. Read row count and column count to calibrate the rest.

### Step 2 — Compute sections (as data)

For each requested section, produce the underlying tables / values. Don't render yet — keep everything as CSV / JSON under `data/` so the final compile is pure templating.

**overview** — dataset name, source path, row count, column count, file size, last modified, snapshot timestamp.

**schema** — per-column: name, inferred type, non-null count, null %, unique count, sample values. Cap to `max_columns_profiled`; note the cap in the report if hit.

**size** — delegate to `sample-size` skill (or inline the same computations): total n, unit of analysis (prompt the user if ambiguous), group cell sizes for any low-cardinality categorical.

**distributions** — for each numeric column: mean, median, SD, min, max, q25, q75, skew, kurtosis. For each categorical with ≤ 30 levels: top values with counts and %. Pull SD values from `standard-deviation` if already computed.

**quality** — null rates, duplicate row count, constant columns, suspected sentinel values. If `forensic-sweep` has been run, embed its headline verdict.

**findings** — include outputs from any prior skills the user has run (`trend-analysis`, `correlation-analysis`, `multivariate-analysis`, `hypothesis-testing`, `data-enrichment`). The user passes these in explicitly; don't rerun analyses.

### Step 3 — Render charts (if `include_charts`)

For each numeric column (up to `max_columns_profiled`): histogram PNG at `assets/hist_<col>.png`. 600×400 px, dpi=120, no title (Typst adds the caption).

For each included categorical: horizontal bar chart of top 15 levels at `assets/bar_<col>.png`.

One overall missingness chart: bar chart of null % per column at `assets/missingness.png`.

Keep the matplotlib script minimal — no styling flourishes. Typst handles presentation.

### Step 4 — Write `report.typ`

Emit a single Typst file. Structure:

```typst
#set document(title: "<title>", author: "<author>")
#set page(paper: "a4", margin: 2cm, numbering: "1 / 1")
#set text(font: "New Computer Modern", size: 10pt)
#set heading(numbering: "1.1")

#align(center)[
  #text(size: 20pt, weight: "bold")[<title>]
  #v(0.3em)
  #text(size: 12pt)[<subtitle>]
  #v(0.3em)
  #text(size: 10pt)[<author> · <snapshot-date>]
]

#outline()

= Overview
<overview prose + small table>

= Schema
#table(
  columns: (auto, auto, auto, auto, auto),
  [*Column*], [*Type*], [*Non-null*], [*Unique*], [*Sample*],
  ...rows...
)

= Sample Size
<size section>

= Distributions
== Numeric columns
<for each: summary row + histogram figure>

== Categorical columns
<for each: top-values table + bar figure>

= Data Quality
<null rates table, duplicate count, sentinel flags, forensic-sweep verdict if present>

= Findings
<embedded prior-skill outputs, one subsection each>

= Reproducibility
Generated <date> from `<dataset-path>`.
Parameters: see `params.json`.
```

Use `#figure(image("assets/hist_price.png"), caption: [Distribution of price])` for charts. Use `#table(...)` for tabular data. Keep column widths readable — no tables wider than the page.

### Step 5 — Compile

If `theme == plain`:
```bash
typst compile report.typ report.pdf
```

If `theme` is `dsr-business`, `personal`, or `public`: delegate to the matching `typst-document-generator` skill, passing the generated body. Those skills have the themed templates already wired; don't reinvent styling.

Verify the PDF exists and is non-trivially sized (> 10 KB).

### Step 6 — Save parameters

Write `params.json` with the exact inputs (dataset path, absolute; all parameters resolved; skill version). This is what makes the report reproducible.

### Step 7 — Report back

Tell the user:
- Path to the PDF.
- Path to the Typst source (for edits).
- How to regenerate (`typst compile outputs/.../report.typ`).
- Any sections that were skipped (e.g. "distributions skipped for 12 columns over the cap — raise `max_columns_profiled` to include them").

## Notes

- **Typst must be on PATH.** If it isn't, fall back to markdown output and tell the user how to install (`cargo install typst-cli` or the release binary from typst.app).
- Wide tables: if a table would overflow the page width, split it by column groups or use landscape for that section only (`#page(flipped: true)[ ... ]`).
- Don't put raw data rows in the PDF — aggregates, samples, and schema only. Full data belongs in the source files.
- Pair with `data-dictionary-creator` for the schema section (use its output as-is) and `sample-size` / `standard-deviation` for the stat blocks — avoid re-implementing those computations here.
- If the user wants the report hosted or shared, don't auto-upload. Hand them the PDF path and let them move it.

Versions

The database has no other skills named data-reporting.

Database snapshot: 13.11.2026 · package version 378cf26316af (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100typst
    Typst document creation and package development. Use when: (1) Working with .typ files, (2) User mentions typst, typst.toml, or typst-cli, (3) Creating or using Typst packages, (4) Developing document templates, (5) Converting Markdown/LaTeX to Typst
  • 98data-analysis
    Loads CSV, Excel, and JSON data files, performs statistical analysis, and generates charts and reports. Use when the user asks to analyze a dataset, compute statistics, create visualizations, find trends, or produce a data report.
  • 100typst
    Typst language reference - markup, math and code modes, set/show rules, layout, tables, templates, and PDF/HTML/PNG/SVG export, current to the latest stable release. Use when writing or editing a .typ file, fixing a Typst compile error, building a Typst table, figure or…
  • 100typst
    Write documents in Typst — papers, spec sheets, reports, letters, slides — compile them to PDF with the pinned typst binary, read its diagnostics, and keep the pane current. Use for any request that ends in a PDF or a printed page.
  • 100data-profiling
    Deep-profile the active dataset: distributions, temporal patterns, correlations, completeness gaps, anomalies. Use after connecting a new dataset. Trigger on "profile this data", "deep-profile the dataset", "run a data profile", "check distributions", "find anomalies in the…
  • 100data-profiling
    Deep-profile the active dataset: distributions, temporal patterns, correlations, completeness gaps, anomalies. Use after connecting a new dataset. Trigger on "profile this data", "deep-profile the dataset", "run a data profile", "check distributions", "find anomalies in the…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.