# Csv To Report

> Convert a raw CSV into a structured, business-ready report using a 3-step framework — load + label, define rules, request structured deliverables. Trigger when the user says "csv to report", "report from this csv", "summarize this spreadsheet", "training log report", "compliance report", "turn this data into a report", or uploads a CSV and wants narrative output rather than raw numbers.

- **Type:** Skill
- **Install:** `agentstack add skill-zacharticulatev-designer-pro-and-seo-csv-to-report`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ZachArticulateV](https://agentstack.voostack.com/s/zacharticulatev)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ZachArticulateV](https://github.com/ZachArticulateV)
- **Source:** https://github.com/ZachArticulateV/designer-pro-and-seo/tree/main/skills/csv-to-report

## Install

```sh
agentstack add skill-zacharticulatev-designer-pro-and-seo-csv-to-report
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# csv-to-report

**Family:** content-and-data
**Status:** Stable

## Purpose

Turn raw CSV data into a structured, narrative report. A small Python helper does
the deterministic profiling/filtering/grouping; the skill adds the human layer —
what the columns mean and what the business rules are.

The 3-step framework: **Load + label** → **Define rules** → **Request the
structured deliverable**, then iterate (same data, new lenses). Common uses:
training compliance, staff scheduling, billing audits, inventory snapshots.

## Triggers

- "csv to report" / "report from this csv"
- "summarize this spreadsheet"
- "training log report" / "compliance report"
- "turn this data into a report"

## Inputs

- CSV file (path or pasted)
- Column meanings (labels the agent needs to interpret correctly)
- Business rules (what counts as overdue, complete, required, etc.)
- Desired deliverable format

## Steps

1. **Profile the data mechanically:**
   ```
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/workflow/csv_to_report.py" --in  --human   # use `py` on Windows if python3 is absent
   ```
   Returns row/column counts, per-column type + fill rate + distinct values,
   numeric stats, and top categories — so labeling is grounded in real data.
2. **Load + label.** Confirm what each non-obvious column means (abbreviations,
   joined fields, date formats). Flag data-quality issues the profile reveals
   (blanks, mixed types, totals rows mixed into data rows).
3. **Define rules.** Capture explicit business rules ("annual training expires 365
   days after Completion_Date"; "overdue = past expiration AND status != complete").
4. **Slice as needed** using the helper's `--filter`, `--group-by`, and `--select`
   flags to answer specific questions deterministically.
5. **Render the deliverable** — table, grouped lists, narrative summary, or an
   exported sub-CSV — applying the business rules to the profiled data.
6. **Offer an iteration menu** — filter, group, export, re-summarize on the same
   data ("now only clinical staff", "now group by training type").

## Outputs

- Structured report (Markdown or HTML)
- Optional filtered sub-CSV(s) for downstream use

## Dependencies

- `scripts/workflow/csv_to_report.py` (required) — Python 3.10+, standard library only (no pandas)

## Notes

Output quality scales with input quality: the helper surfaces clean-CSV issues
(inconsistent dates, merged cells, totals rows) so they're flagged before the
report is generated. Data stays local — see `PRIVACY.md`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ZachArticulateV](https://github.com/ZachArticulateV)
- **Source:** [ZachArticulateV/designer-pro-and-seo](https://github.com/ZachArticulateV/designer-pro-and-seo)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zacharticulatev-designer-pro-and-seo-csv-to-report
- Seller: https://agentstack.voostack.com/s/zacharticulatev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.