report-template

name	report-template
description	Publication-quality PDF report generation using Typst templates. Produces professional scientific reports with colored section bands, styled tables, figure captions, callout boxes, and page headers/footers.

Report Template System

Generate publication-quality PDF reports using the BioClaw Typst template engine.

Quick Start

import sys
sys.path.insert(0, "/home/node/.claude/skills/report-template")
from report_builder import (
    ReportBuilder, typst_table, typst_callout, typst_image,
    typst_metadata_block, typst_metric_cards, typst_pagebreak,
    typst_text, typst_list, typst_bold, typst_italic,
)

report = ReportBuilder(
    title="My Analysis Report",
    subtitle="Project XYZ",
    author="BioClaw",
)

# Add sections with Typst markup
report.add_section("Background", "Description of the project...")

# Add tables
table = typst_table(
    ["Sample", "Value", "Status"],
    [["A", "92.3", "Pass"], ["B", "87.1", "Pass"]],
    caption="Summary of results",
)
report.add_section("Results", table)

# Compile to PDF
report.compile("output/report.pdf")

Available Components

Tables

typst_table(headers, rows, caption=None)

Callout Boxes

typst_callout(text, title="Note", kind="note")
# kind: "note" (blue), "warning" (yellow), "success" (green), "danger" (red)

Figures

typst_image(path, caption=None, width="100%")
# path is relative to the output directory

Metadata Blocks

typst_metadata_block([("Key", "Value"), ("Date", "2026-04-15")])

Metric Cards

typst_metric_cards([
    {"label": "Samples", "value": "6"},
    {"label": "Quality", "value": "A+"},
])

Text Formatting

typst_text("Plain paragraph")
typst_bold("Bold text")
typst_italic("Italic text")
typst_list(["Item 1", "Item 2"])
typst_enum(["Step 1", "Step 2"])
typst_pagebreak()

Template Features

• Dark navy section heading bands with white text
• Teal sub-heading accents
• Professional page headers and footers with page numbers
• Alternating-row table styling
• Four callout box types (note, warning, success, danger)
• Figure numbering and italic captions
• Key-value metadata blocks
• Metric card rows

Requirements

• Python package: typst (pip install typst)
• No system dependencies required