# CSV Insights

> Profile a CSV file and produce a Markdown report with row/column counts, fill rates, unique values, and numeric or categorical summaries.

- Skill: `metadist/csv-insights` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add metadist/csv-insights`
- Raw SKILL.md: https://api.skillmd.com/api/skills/metadist/csv-insights/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: metadist (https://skillmd.com/u/metadist)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/metadist/csv-insights

---


# CSV insights

Turn a CSV file into a readable Markdown report: total rows and columns, and for
each column its fill rate, unique values, and either numeric stats
(min/max/mean/std) or the most common categories.

## How to run

Run with Python. Pass the input CSV and an output Markdown path inside the
out-box:

```
python3 <skill_dir>/run.py <input.csv> <output.md> [title]
```

- `<input.csv>` — a CSV in a folder the user allowed, or already in the out-box.
- `<output.md>` — a path **inside the out-box**.
- `[title]` — optional report title.

Standard library only; no packages to install. It reads one CSV and writes one
Markdown file. After running, tell the user the saved path.