К основному содержанию
скилл CX Codex

pdf-report-generator — скилл для Claude Code: генерация PDF-отчётов

Скилл pdf-report-generator автоматизирует создание PDF-отчётов из данных строительных проектов. Собирает графики, таблицы и ключевые показатели в оформленный документ — без ручного монтажа.

MIT 132 установок ★ 434 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a claude-code
Открыть на GitHub

Что делает pdf-report-generator

pdf-report-generator содержит Python-класс PDFReportGenerator, который строит отчёты из блоков: заголовок, текст, таблицы, диаграммы, KPI-карточки. Поддерживает несколько типов отчётов — прогресс, затраты, безопасность, качество, еженедельный и ежемесячный.

Для работы нужен Python 3 и библиотека pandas. Скилл принимает данные проекта (прогресс, КПЭ, историю затрат, список активностей), преобразует их в структурированные секции и выводит PDF с разметкой и стилями. Встроены методы для добавления KPI-карточек со статусом (норма, предупреждение, критично), линейных и столбчатых диаграмм, таблиц из DataFrame.

Автор создал скилл для строительных команд, где еженедельные отчёты — рутина. Логика берёт данные из одного интерфейса, применяет шаблон и экспортирует готовый PDF без переделок и форматирования вручную.

Какие задачи решает

  • собрать PDF-отчёт из табличных данных проекта с диаграммами
  • создать еженедельные или ежемесячные отчёты по одному шаблону
  • визуализировать KPI и историю прогресса на одной странице
  • избежать несогласованности в оформлении отчётов разных проектов

Примеры запросов агенту

  • Сгенерируй отчёт о прогрессе проекта со статусом активностей и графиком прогресса
  • Создай PDF-отчёт затрат с бюджетом, фактическими расходами и дисперсией по периодам
  • Собери отчёт безопасности с KPI-карточками и таблицей происшествий

Как установить pdf-report-generator

1Через Skills CLI (Vercel)

npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a claude-code

2Вручную: положить файлы

~/.claude/skills/pdf-report-generator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pdf-report-generator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pdf-report-generator

Как установить pdf-report-generator в Claude Code?

Выполни npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-report-generator -a claude-code, затем обрати внимание на файл ~/.claude/skills/pdf-report-generator/SKILL.md.

Что делает pdf-report-generator?

Автоматизирует создание PDF-отчётов из строительных данных. Собирает графики, таблицы, KPI-показатели и текст в единый отформатированный документ по шаблону.

Какой язык программирования и зависимости нужны?

Python 3 в PATH. Скилл использует pandas для работы с таблицами, поэтому убедись, что библиотека установлена.

Исходный текст

SKILL.md · MIT
---
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(),
            'version': '1.0'
        }

    def set_metadata(self, author: str = "", report_date: date = None, version: str = "1.0"):
        """Set report metadata."""
        self.metadata['author'] = author
        self.metadata['date'] = report_date or date.today()
        self.metadata['version'] = version

    def add_header(self, title: str, subtitle: str = ""):
        """Add report header section."""
        self.sections.append(ReportSection(
            section_type=SectionType.HEADER,
            title=title,
            content={'subtitle': subtitle, 'date': self.metadata['date'].isoformat()}
        ))

    def add_text(self, title: str, content: str):
        """Add text section."""
        self.sections.append(ReportSection(
            section_type=SectionType.TEXT,
            title=title,
            content=content
        ))

    def add_table(self, title: str, df: pd.DataFrame, style: Dict[str, Any] = None):
        """Add table section from DataFrame."""
        self.sections.append(ReportSection(
            section_type=SectionType.TABLE,
            title=title,
            content=df.to_dict('records'),
            style=style or {}
        ))

    def add_kpi_cards(self, title: str, kpis: List[KPICard]):
        """Add KPI cards section."""
        self.sections.append(ReportSection(
            section_type=SectionType.KPI_CARDS,
            title=title,
            content=[{
                'name': k.name,
                'value': k.value,
                'unit': k.unit,
                'target': k.target,
                'status': k.status
            } for k in kpis]
        ))

    def add_chart(self, title: str, chart_config: ChartConfig):
        """Add chart section."""
        self.sections.append(ReportSection(
            section_type=SectionType.CHART,
            title=title,
            content={
                'type': chart_config.chart_type,
                'data': chart_config.data,
                'x_label': chart_config.x_label,
                'y_label': chart_config.y_label
            }
        ))

    def add_page_break(self):
        """Add page break."""
        self.sections.append(ReportSection(section_type=SectionType.PAGE_BREAK))

    def generate_progress_report(self, data: Dict[str, Any]):
        """Generate standard progress report."""

        self.add_header(
            f"{self.project_name} - Progress Report",
            f"Report Date: {self.metadata['date']}"
        )

        # KPIs
        kpis = [
            KPICard("Overall Progress", f"{data.get('overall_progress', 0)}%", target="100%",
                   status="good" if data.get('overall_progress', 0) >= data.get('planned_progress', 0) else "warning"),
            KPICard("SPI", f"{data.get('spi', 1.0):.2f}", target="1.00",
                   status="good" if data.get('spi', 1) >= 0.95 else "critical"),
            KPICard("CPI", f"{data.get('cpi', 1.0):.2f}", target="1.00",
                   status="good" if data.get('cpi', 1) >= 0.95 else "critical"),
            KPICard("Days Remaining", str(data.get('days_remaining', 0)), "days")
        ]
        self.add_kpi_cards("Key Performance Indicators", kpis)

        # Progress summary
        self.add_text("Executive Summary", data.get('summary', 'No summary provided.'))

        # Activities table
        if 'activities' in data:
            activities_df = pd.DataFrame(data['activities'])
            self.add_table("Activity Status", activities_df)

        # Progress chart
        if 'progress_history' in data:
            self.add_chart("Progress Trend", ChartConfig(
                chart_type="line",
                data=data['progress_history'],
                title="Progress Over Time",
                x_label="Date",
                y_label="Progress %"
            ))

        # Issues
        if 'issues' in data:
            self.add_text("Current Issues", "\n".join(f"- {issue}" for issue in data['issues']))

    def generate_cost_report(self, data: Dict[str, Any]):
        """Generate cost report."""

        self.add_header(
            f"{self.project_name} - Cost Report",
            f"Period: {data.get('period', 'Current')}"
        )

        # Cost KPIs
        budget = data.get('budget', 0)
        actual = data.get('actual_cost', 0)
        variance = budget - actual

        kpis = [
            KPICard("Budget", f"${budget:,.0f}"),
            KPICard("Actual Cost", f"${actual:,.0f}"),
            KPICard("Variance", f"${variance:,.0f}",
                   status="good" if variance >= 0 else "critical"),
            KPICard("CPI", f"{data.get('cpi', 1.0):.2f}",
                   status="good" if data.get('cpi', 1) >= 0.95 else "warning")
        ]
        self.add_kpi_cards("Cost Summary", kpis)

        # Cost breakdown
        if 'cost_breakdown' in data:
            breakdown_df = pd.DataFrame(data['cost_breakdown'])
            self.add_table("Cost Breakdown by Category", breakdown_df)

        # Cost trend
        if 'cost_history' in data:
            self.add_chart("Cost Trend", ChartConfig(
                chart_type="bar",
                data=data['cost_history'],
                title="Monthly Cost",
                x_label="Month",
                y_label="Cost ($)"
            ))

    def generate_safety_report(self, data: Dict[str, Any]):
        """Generate safety report."""

        self.add_header(
            f"{self.project_name} - Safety Report",
            f"Period: {data.get('period', 'Current')}"
        )

        # Safety KPIs
        kpis = [
            KPICard("Days Without Incident", str(data.get('days_without_incident', 0)), "days"),
            KPICard("TRIR", f"{data.get('trir', 0):.2f}",
                   status="good" if data.get('trir', 0) <= 2 else "critical"),
            KPICard("Near Misses", str(data.get('near_misses', 0))),
            KPICard("Safety Observations", str(data.get('observations', 0)))
        ]
        self.add_kpi_cards("Safety Metrics", kpis)

        # Incidents
        if 'incidents' in data and data['incidents']:
            incidents_df = pd.DataFrame(data['incidents'])
            self.add_table("Incident Log", incidents_df)

        # Training
        if 'training' in data:
            self.add_text("Training Summary", data['training'])

    def to_html(self) -> str:
        """Generate HTML representation of report."""

        html = f"""
<!DOCTYPE html>
<html>
<head>
    <title>{self.project_name} Report</title>
    <style>
        body {{ font-family: Arial, sans-serif; margin: 40px; }}
        .header {{ background: #2196F3; color: white; padding: 20px; margin-bottom: 20px; }}
        .section {{ margin-bottom: 30px; }}
        .section-title {{ color: #333; border-bottom: 2px solid #2196F3; padding-bottom: 5px; }}
        .kpi-grid {{ display: grid; grid-template-columns: repeat(4, 1fr); gap: 15px; }}
        .kpi-card {{ border: 1px solid #ddd; padding: 15px; border-radius: 5px; text-align: center; }}
        .kpi-value {{ font-size: 24px; font-weight: bold; }}
        .kpi-name {{ color: #666; }}
        .status-good {{ border-left: 4px solid #4CAF50; }}
        .status-warning {{ border-left: 4px solid #FF9800; }}
        .status-critical {{ border-left: 4px solid #F44336; }}
        table {{ width: 100%; border-collapse: collapse; }}
        th, td {{ border: 1px solid #ddd; padding: 8px; text-align: left; }}
        th {{ background: #f5f5f5; }}
        .page-break {{ page-break-after: always; }}
    </style>
</head>
<body>
"""

        for section in self.sections:
            if section.section_type == SectionType.HEADER:
                html += f"""
    <div class="header">
        <h1>{section.title}</h1>
        <p>{section.content.get('subtitle', '')}</p>
    </div>
"""
            elif section.section_type == SectionType.TEXT:
                html += f"""
    <div class="section">
        <h2 class="section-title">{section.title}</h2>
        <p>{section.content}</p>
    </div>
"""
            elif section.section_type == SectionType.KPI_CARDS:
                html += f"""
    <div class="section">
        <h2 class="section-title">{section.title}</h2>
        <div class="kpi-grid">
"""
                for kpi in section.content:
                    status_class = f"status-{kpi['status']}" if kpi['status'] != 'normal' else ''
                    html += f"""
            <div class="kpi-card {status_class}">
                <div class="kpi-name">{kpi['name']}</div>
                <div class="kpi-value">{kpi['value']}</div>
                <div class="kpi-target">Target: {kpi['target'] or 'N/A'}</div>
            </div>
"""
                html += "</div></div>"

            elif section.section_type == SectionType.TABLE:
                html += f"""
    <div class="section">
        <h2 class="section-title">{section.title}</h2>
        <table>
            <tr>
"""
                if section.content:
                    for key in section.content[0].keys():
                        html += f"<th>{key}</th>"
                    html += "</tr>"

                    for row in section.content:
                        html += "<tr>"
                        for value in row.values():
                            html += f"<td>{value}</td>"
                        html += "</tr>"

                html += "</table></div>"

            elif section.section_type == SectionType.PAGE_BREAK:
                html += '<div class="page-break"></div>'

        html += "</body></html>"
        return html

    def export_to_excel(self, output_path: str) -> str:
        """Export report data to Excel."""

        with pd.ExcelWriter(output_path, engine='openpyxl') as writer:
            # Metadata
            meta_df = pd.DataFrame([{
                'Project': self.project_name,
                'Report Type': self.report_type.value,
                'Date': self.metadata['date'],
                'Author': self.metadata['author'],
                'Version': self.metadata['version']
            }])
            meta_df.to_excel(writer, sheet_name='Metadata', index=False)

            # Each section
            table_count = 0
            for section in self.sections:
                if section.section_type == SectionType.TABLE:
                    table_count += 1
                    sheet_name = section.title[:31] if section.title else f"Table_{table_count}"
                    df = pd.DataFrame(section.content)
                    df.to_excel(writer, sheet_name=sheet_name, index=False)

                elif section.section_type == SectionType.KPI_CARDS:
                    kpi_df = pd.DataFrame(section.content)
                    kpi_df.to_excel(writer, sheet_name='KPIs', index=False)

        return output_path

    def get_report_structure(self) -> Dict[str, Any]:
        """Get report structure as dictionary."""

        return {
            'project': self.project_name,
            'type': self.report_type.value,
            'metadata': self.metadata,
            'sections': [
                {
                    'type': s.section_type.value,
                    'title': s.title,
                    'content': s.content
                }
                for s in self.sections
            ]
        }
```

## Quick Start

```python
# Create report generator
report = PDFReportGenerator("Office Building A", ReportType.PROGRESS)
report.set_metadata(author="Project Manager", version="1.0")

# Generate progress report
report.generate_progress_report({
    'overall_progress': 65,
    'planned_progress': 60,
    'spi': 1.08,
    'cpi': 0.97,
    'days_remaining': 120,
    'summary': 'Project is ahead of schedule but slightly over budget.',
    'activities': [
        {'Activity': 'Foundation', 'Status': 'Complete', 'Progress': 100},
        {'Activity': 'Structure', 'Status': 'In Progress', 'Progress': 80},
        {'Activity': 'MEP', 'Status': 'In Progress', 'Progress': 45}
    ],
    'issues': ['Material delivery delay', 'Weather impact on exterior work']
})

# Generate HTML
html = report.to_html()
with open("report.html", "w") as f:
    f.write(html)
```

## Common Use Cases

### 1. Cost Report
```python
report = PDFReportGenerator("Project X", ReportType.COST)
report.generate_cost_report({
    'period': 'January 2024',
    'budget': 5000000,
    'actual_cost': 4800000,
    'cpi': 1.04,
    'cost_breakdown': [
        {'Category': 'Labor', 'Budget': 2000000, 'Actual': 1950000},
        {'Category': 'Materials', 'Budget': 2500000, 'Actual': 2400000},
        {'Category': 'Equipment', 'Budget': 500000, 'Actual': 450000}
    ]
})
```

### 2. Safety Report
```python
report = PDFReportGenerator("Project X", ReportType.SAFETY)
report.generate_safety_report({
    'days_without_incident': 45,
    'trir': 1.2,
    'near_misses': 3,
    'observations': 25
})
```

### 3. Custom Report
```python
report = PDFReportGenerator("Project X", ReportType.WEEKLY)
report.add_header("Weekly Status Report", "Week 15")
report.add_kpi_cards("Summary", [
    KPICard("Tasks Completed", "15"),
    KPICard("Hours Worked", "480")
])
report.add_text("Notes", "Key accomplishments this week...")
```

## Resources
- **DDC Book**: Chapter 4.2 - ETL and Process Automation
- **Website**: https://datadrivenconstruction.io

© datadrivenconstruction · MIT · datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

Похожие скиллы

Все скиллы по теме «Документы и офис» →
market-report-pdf zubair-trabzada Скилл market-report-pdf собирает данные маркетинговых аудитов и оформляет их в PDF с графиками оценок, сравнительными таблицами конкурентов и планом действий. CX Codex +1 ★ 2 938звёзд репо tufte-report glebis Скилл tufte-report собирает HTML-отчёты с интерактивными графиками и таблицами в стиле Эдварда Тафти — высокая плотность данных, минимум украшений, двухколоночная вёрстка с боковыми врезками. CX Codex +1 202установок report-with-html daymade Скилл report-with-html для Claude Code создаёт автономные визуальные HTML-отчёты, интерактивные дашборды и верстаки для ревью. Запускается по прямому запросу на веб-отчёт или визуализацию данных. CX Codex +1 143установок report-to-pdf официальный Data Analytics Maintainers Скилл report-to-pdf конвертирует отчёты Data Analytics и графики из статического HTML в PDF через headless Chrome с проверкой вёрстки. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо geo-report-pdf geo-seo-claude Скилл geo-report-pdf превращает markdown-отчёт GEO-аудита в PDF с обложкой, цветными таблицами оценок и дорожной картой на 90 дней. Использует pandoc и Chrome headless. CX Codex +1 982установок pdf-to-docx claude-office-skills Скилл pdf-to-docx для Claude Code конвертирует PDF в редактируемый Word через библиотеку pdf2docx. Правит отчёты и договоры — не читает их. CX Codex +1 6 200установок

Из того же набора156

Весь набор →
bim-validation-report Скилл bim-validation-report проверяет элементы BIM-модели на корректность данных, геометрию и стандарты проекта, формируя отчёт об ошибках. Пригодится инженерам и разработчикам для автоматического контроля качества данных. CX Codex +1 133установок safety-inspection-checklist Скилл safety-inspection-checklist генерирует и проводит цифровые чек-листы безопасности на строительных площадках. Собирает данные инспекций, фото, отслеживает нарушения и автоматически составляет отчёты. CX Codex +1 133установок schedule-delay-analyzer Скилл schedule-delay-analyzer учитывает задержки проекта, их причины и влияние на критический путь. Помогает оценить перенос сроков и подготовить расчёт для требования о продлении. CX Codex +1 132установок subcontractor-payment-tracker Скилл subcontractor-payment-tracker отслеживает расчёты с субподрядчиками, график счетов, гарантийные удержания и отказные от залога (lien waivers). Пригодится при контроле строительных договоров. CX Codex +1 132установок rfi-management Скилл rfi-management управляет запросами на информацию (RFI) на стройке: регистрирует обращения в Excel, отслеживает дедлайны и фиксирует задержки графика. CX Codex +1 131установок safety-compliance-checker Скилл safety-compliance-checker для Claude Code автоматически проверяет соблюдение норм безопасности на стройплощадках. Отслеживает СИЗ, доступ в зоны и работу на высоте, формирует отчёты о нарушениях. CX Codex +1 131установок daily-report-generator Скилл daily-report-generator собирает данные со строительной площадки — погоду, рабочие часы, прогресс — и генерирует профессиональные PDF-отчёты. Экономит 45–60 минут в день на ручное составление документов. CX Codex +1 130установок energy-simulation Скилл energy-simulation для Claude Code считает тепловые нагрузки, анализирует оболочку здания и помогает подобрать HVAC. Проверяет энергокод и сценарии энергопотребления. CX Codex +1 129установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой