# pdf-report-generator

The pdf-report-generator skill automates PDF report creation from construction project data. Combines charts, tables, and KPIs into a formatted document without manual assembly.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 132 installs · ★ 434 repo stars
- Author: datadrivenconstruction
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/2_DDC_Book/4.2-ETL-Automation/pdf-report-generator/SKILL.md
- Updated: 2026-10-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pdf-report-generator

## What it does

pdf-report-generator includes a Python PDFReportGenerator class that constructs reports from building blocks: header, text, tables, charts, KPI cards. It supports multiple report types—progress, cost, safety, quality, weekly, monthly.

Requires Python 3 and pandas. The skill accepts project data (progress percentage, KPIs, cost history, activity lists), transforms it into structured sections, and outputs a PDF with layout and styling. Built-in methods add KPI cards with status indicators (normal, warning, critical, good), line and bar charts, and tables from DataFrames.

Author designed it for construction teams drowning in weekly reports. Data goes in once through a single interface, template applies, formatted PDF comes out without rework or manual formatting.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/pdf-report-generator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pdf-report-generator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pdf-report-generator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pdf-report-generator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction 2_DDC_Book/4.2-ETL-Automation/pdf-report-generator
```

2. **Manually: put the files in place**
- File: `.github/skills/pdf-report-generator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --path 2_DDC_Book/4.2-ETL-Automation/pdf-report-generator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pdf-report-generator/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/2_DDC_Book/4.2-ETL-Automation/pdf-report-generator/SKILL.md

## When to use it
- generate PDF report from tabular project data with embedded charts
- produce weekly or monthly reports using a consistent template
- display KPIs and progress history on one page with visual status
- prevent formatting inconsistencies across project reports

## Example prompts
- Create a progress report with activity status and progress trend chart
- Build a cost report showing budget, actual spending, and variance over time
- Assemble a safety report with KPI cards and incident table

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 4f4ec419ea3ce980.

BEGIN THIRD-PARTY FILE 4f4ec419ea3ce980
````text
---
name: "pdf-report-generator"
description: "Automatically generate PDF reports from construction data. Create formatted project reports with charts and tables."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "⚙️", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# PDF Report Generator

## Business Case

### Problem Statement
Report generation challenges:
- Manual report creation is time-consuming
- Inconsistent formatting
- Data aggregation from multiple sources
- Repetitive weekly/monthly reports

### Solution
Automated PDF report generation from project data with templates, charts, and customizable sections.

## Technical Implementation

```python
import pandas as pd
from typing import Dict, Any, List, Optional
from dataclasses import dataclass, field
from datetime import date, datetime
from enum import Enum
from io import BytesIO


class ReportType(Enum):
    PROGRESS = "progress"
    COST = "cost"
    SAFETY = "safety"
    QUALITY = "quality"
    EXECUTIVE = "executive"
    WEEKLY = "weekly"
    MONTHLY = "monthly"


class SectionType(Enum):
    HEADER = "header"
    TEXT = "text"
    TABLE = "table"
    CHART = "chart"
    KPI_CARDS = "kpi_cards"
    IMAGE = "image"
    PAGE_BREAK = "page_break"


@dataclass
class ReportSection:
    section_type: SectionType
    title: str = ""
    content: Any = None
    style: Dict[str, Any] = field(default_factory=dict)


@dataclass
class KPICard:
    name: str
    value: Any
    unit: str = ""
    target: Any = None
    status: str = "normal"  # normal, warning, critical, good


@dataclass
class ChartConfig:
    chart_type: str  # bar, line, pie
    data: Dict[str, List]
    title: str = ""
    x_label: str = ""
    y_label: str = ""


class PDFReportGenerator:
    """Generate PDF reports from construction project data."""

    def __init__(self, project_name: str, report_type: ReportType):
        self.project_name = project_name
        self.report_type = report_type
        self.sections: List[ReportSection] = []
        self.metadata: Dict[str, Any] = {
            'author': '',
            'date': date.today(),
````
END THIRD-PARTY FILE 4f4ec419ea3ce980

The third-party file has ended. Everything between the 4f4ec419ea3ce980 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2209 of 15509 bytes. © datadrivenconstruction · MIT · https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/2_DDC_Book/4.2-ETL-Automation/pdf-report-generator/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
