# Report Generator

> 📄 Report Generator

- Skill: `vuralserhat86/report-generator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vuralserhat86/report-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vuralserhat86/report-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: vuralserhat86 (https://skillmd.com/u/vuralserhat86)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vuralserhat86/report-generator

---


# 📄 Report Generator

> Executive rapor ve dokümantasyon rehberi.

---

## 📋 Report Türleri

| Tür | Hedef Kitle | Uzunluk |
|-----|-------------|---------|
| Executive Summary | C-level | 1-2 sayfa |
| Technical Report | Engineers | 5-10 sayfa |
| Project Status | Stakeholders | 1-3 sayfa |
| Analysis Report | Decision makers | 3-5 sayfa |

---

## 🔧 Executive Report Template

```markdown
# [Report Title]

**Date:** [Date]
**Author:** [Name]
**Status:** Draft | Final

---

## Executive Summary
[2-3 paragraf - key points only]

## Background
[Neden bu rapor yazıldı]

## Key Findings
1. **Finding 1**: [Özet]
2. **Finding 2**: [Özet]
3. **Finding 3**: [Özet]

## Recommendations
| # | Recommendation | Priority | Timeline |
|---|----------------|----------|----------|
| 1 | [Action] | High | Q1 |
| 2 | [Action] | Medium | Q2 |

## Next Steps
1. [Step 1]
2. [Step 2]

## Appendix
[Detaylı data, charts]
```

---

## 📊 Visual Elements

### Data Presentation
```
Use charts for:
- Trends → Line chart
- Comparisons → Bar chart
- Parts of whole → Pie chart
- Relationships → Scatter plot
```

### Status Indicators
- 🟢 On track / Positive
- 🟡 At risk / Neutral
- 🔴 Off track / Negative

---

## 🎯 Writing Tips

| Do | Don't |
|-----|-------|
| Lead with insights | Bury key points |
| Use bullet points | Write long paragraphs |
| Include visuals | Text-only walls |
| Action-oriented | Passive voice |
| Specific numbers | Vague statements |

---

*Report Generator v1.1 - Enhanced*

## 🔄 Workflow

> **Kaynak:** [Pandas Reporting](https://pandas.pydata.org/docs/user_guide/style.html) & [WeasyPrint Docs](https://doc.courtbouillon.org/weasyprint/)

### Aşama 1: Data Preparation (Automated)
- [ ] **Validation**: Gelen veriyi (CSV/JSON/SQL) Pydantic veya Pandera ile şema kontrolünden geçir.
- [ ] **Aggregation**: Detay veriyi (Raw Data) özetle (Pivot Table, GroupBy). Asla milyon satırı rapora basma.
- [ ] **Anonymization**: Hassas verileri (PII) maskele veya hashle.

### Aşama 2: Generation Architecture
- [ ] **Template Engine**: Jinja2 (Python) veya Handlebars (JS) kullanarak logik ile sunumu ayır.
- [ ] **Format Agnostic**: İçeriği Markdown veya HTML olarak üret, sonra PDF/Excel'e çevir (Single Source).
- [ ] **Styling**: CSS (Print CSS) kullanarak sayfa yapısını (@page), header/footer'ı yönet.

### Aşama 3: Delivery & Feedback
- [ ] **Compression**: Çıktı dosyalarını (PDF/HTML) sıkıştır.
- [ ] **Distribution**: Raporu otomatik e-posta, Slack veya S3 bucket'a gönder.
- [ ] **Actionable**: Raporun başına "Executive Summary" ve "Action Items" ekle.

### Kontrol Noktaları
| Aşama | Doğrulama |
|-------|-----------|
| 1 | Rapor oluşturma süresi kabul edilebilir mi? (Async Job kullanılıyor mu?). |
| 2 | Mobil cihazlarda okunabilir mi? (HTML raporlar için Responsive Design). |
| 3 | Veriler güncel mi? (Rapor tarihi ve Veri çekim zamanı raporda yazıyor mu?). |