Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Turn a CSV of operational data (sales, usage, signups, support tickets) into a multi-page styled PDF executive report with narrative + matplotlib charts.
Install CSV To Executive Report
$ npx skills add skrun-dev/skrun --skill csv-to-executive-report -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install skrun-dev/skrun csv-to-executive-report --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/skrun-dev/skrun.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/csv-to-executive-report .claude/skills/csv-to-executive-report && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "csv-to-executive-report" agent skill from https://github.com/skrun-dev/skrun/tree/main/agents/csv-to-executive-report into .claude/skills/csv-to-executive-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "csv-to-executive-report", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/skrun-dev/skrun/tree/main/agents/csv-to-executive-reportType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add skrun-dev/skrun --skill csv-to-executive-report -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install skrun-dev/skrun csv-to-executive-report --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/skrun-dev/skrun.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agents/csv-to-executive-report .agents/skills/csv-to-executive-report && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "csv-to-executive-report" agent skill from https://github.com/skrun-dev/skrun/tree/main/agents/csv-to-executive-report into .agents/skills/csv-to-executive-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "csv-to-executive-report", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add skrun-dev/skrun --skill csv-to-executive-report -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install skrun-dev/skrun csv-to-executive-report --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/skrun-dev/skrun.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agents/csv-to-executive-report .cursor/skills/csv-to-executive-report && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "csv-to-executive-report" agent skill from https://github.com/skrun-dev/skrun/tree/main/agents/csv-to-executive-report into .cursor/skills/csv-to-executive-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "csv-to-executive-report", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/skrun-dev/skrun.git --path agents/csv-to-executive-report--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add skrun-dev/skrun --skill csv-to-executive-report -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install skrun-dev/skrun csv-to-executive-report --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/skrun-dev/skrun.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agents/csv-to-executive-report .gemini/skills/csv-to-executive-report && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "csv-to-executive-report" agent skill from https://github.com/skrun-dev/skrun/tree/main/agents/csv-to-executive-report into .gemini/skills/csv-to-executive-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "csv-to-executive-report", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install skrun-dev/skrun csv-to-executive-reportInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add skrun-dev/skrun --skill csv-to-executive-report -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/skrun-dev/skrun.git skills-src && mkdir -p .github/skills && cp -r skills-src/agents/csv-to-executive-report .github/skills/csv-to-executive-report && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "csv-to-executive-report" agent skill from https://github.com/skrun-dev/skrun/tree/main/agents/csv-to-executive-report into .github/skills/csv-to-executive-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "csv-to-executive-report", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add skrun-dev/skrun --skill csv-to-executive-report -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install skrun-dev/skrun csv-to-executive-report --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/skrun-dev/skrun.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agents/csv-to-executive-report .opencode/skills/csv-to-executive-report && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "csv-to-executive-report" agent skill from https://github.com/skrun-dev/skrun/tree/main/agents/csv-to-executive-report into .opencode/skills/csv-to-executive-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "csv-to-executive-report", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
csv-to-executive-report- GitHub stars
- 210
- Token cost
- ~1.1k tokens
- SKILL.md length
- 502 words
- Files
- 7 (incl. scripts)
- Skills in repo
- 14
- Repo updated
- First seen
- Licence
- MIT
At a glance
Turn a CSV of operational data (sales, usage, signups, support tickets) into a multi-page styled PDF executive report with narrative + matplotlib charts.
- Works in 7 steps: Analyze the CSV — call analyze_csv with… → Decide what's interesting — based on the… → Choose 2-3 charts based on the data shape → …
- Given a CSV and asked for a report
- SKILL.md covers Workflow, Style and Failure modes
- Runs Python scripts from its folder
What it does
CSV To Executive Report is an agent skill from skrun-dev/skrun. Turn a CSV of operational data (sales, usage, signups, support tickets) into a multi-page styled PDF executive report with narrative + matplotlib charts. The LLM analyzes the data, picks what's interesting, writes the prose, and emits a structured render request that becomes a polished PDF. Use when given a CSV and asked for a report, summary, or analysis.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts (for example `README.md`, `agent.yaml` and `scripts/analyze_csv.py`).
It sits in Documents & Office, covering Report writing, CSV and tabular files and Data visualization. It works with Matplotlib. The repository describes itself as: Deploy any Agent Skill as an API via POST /run. The open-source multi-model alternative to Claude Managed Agents, Microsoft Foundry & Mistral/Koyeb — works with any LLM. The licence is MIT.
When your agent uses it
- Given a CSV and asked for a report
- Tasks that involve Report writing
- Tasks that involve CSV and tabular files
Example prompts
- “/csv-to-executive-report”
Requirements
- Python 3
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- Analyze the CSV — call analyze_csv with the user's csv_path. The tool returns
- Decide what's interesting — based on the data
- Choose 2-3 charts based on the data shape
- Write the narrative — 3-4 sections, each 1-2 short paragraphs
- Build the summary table — 4-6 rows of [label, value] pairs that capture the most useful single-glance facts. Examples
- Call render_pdf — pass report_title, period, narrative_sections (array of { heading, body }), charts (array as defined in the tool…
- Return structured output
What it can do on your machine
Read from SKILL.md and the folder at commit b1d963b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
CSV To Executive Report loads about 1.1k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 502 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from skrun-dev/skrun at commit b1d963b, republished under its MIT licence (© skrun-dev). 502 words, ~1,062 tokens.
Download SKILL.mdSave it as
.claude/skills/csv-to-executive-report/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.- name
- csv-to-executive-report
- description
- Turn a CSV of operational data (sales, usage, signups, support tickets) into a multi-page styled PDF executive report with narrative + matplotlib charts. The LLM analyzes the data, picks what's interesting, writes the prose, and emits a structured render request that becomes a polished PDF. Use when given a CSV and asked for a report, summary, or analysis.
CSV to Executive Report
You are a data analyst writing a report for a CEO who has 4 minutes to read it. Given a CSV, you produce a multi-page PDF with a clean narrative, well-chosen charts, and a summary table — the kind of artifact that gets forwarded with "great work, please make this a monthly thing."
Workflow
Analyze the CSV — call
analyze_csvwith the user'scsv_path. The tool returns:{ columns, dtypes, row_count, numeric_stats (per numeric col: min/max/mean/sum), sample_rows (first 10) }Decide what's interesting — based on the data:
- Identify the primary metric (the column representing the headline number — usually a numeric column with high variance, named like "revenue", "signups", "errors", "duration_ms").
- Identify a categorical breakdown dimension (a string column with 3-15 distinct values — segment, region, channel, status). Skip if no good candidate.
- If there's a date column (named "date", "created_at", or detected as ISO format in samples), use it for trend charts.
Choose 2-3 charts based on the data shape:
- Trend chart (line) — if a date column exists, plot the primary metric over time. X-labels = dates (truncate to 10-15 evenly-sampled dates if there are too many).
- Breakdown chart (bar) — primary metric by categorical dimension, sorted descending. Top 8 categories max.
- Composition chart (pie) — if there's a status / category column with 3-6 values, show the proportional split. Skip if not applicable.
Write the narrative — 3-4 sections, each 1-2 short paragraphs:
- Headline (executive summary): the single most important finding. "Revenue up 23% MoM, driven primarily by enterprise tier."
- Trend: what's changing over time. Reference the trend chart.
- Breakdown: what's outsized in the categorical dimension. Reference the breakdown chart.
- Watch list (optional): 1-2 anomalies / risks worth flagging. Skip if nothing stands out.
Build the summary table — 4-6 rows of
[label, value]pairs that capture the most useful single-glance facts. Examples:[["Total revenue", "$42,300"], ["MoM growth", "+23%"], ["Top segment", "Enterprise (47%)"], ["Records", "1,247 rows"], ["Period", "Q2 2026"]]Call
render_pdf— passreport_title,period,narrative_sections(array of{ heading, body }),charts(array as defined in the tool schema),summary_table(array of[label, value]).Return structured output:
report_path: from the tool responsepage_count: from the tool responsesummary: copy the headline narrative section's body (single paragraph)
Show full SKILL.md (165 more words)Show less
Style
- Narrative is concise, factual, and quantified — every sentence should have a number or a comparison. Avoid vague filler ("performance was strong this quarter" → "revenue grew 23% MoM, driven by the enterprise tier").
- Use the period's currency / unit consistently. If the CSV is in dollars, write
$XX,XXX. If counts, write commas-separated. - Don't fabricate data. If the CSV doesn't contain MoM info (no prior period in the data), don't claim "up X% MoM". Use what's actually there.
- Pick chart titles that read as headlines, not labels. ✅ "Enterprise leads revenue mix" — ✗ "Revenue by segment".
Failure modes
- CSV with no numeric columns: produce a single-section report with row count + categorical breakdown. Skip charts. Return
page_count: 1. - CSV with only a date column and one numeric column: skip the breakdown section, render only the trend chart. The narrative collapses to headline + trend.
- Unparseable CSV: the
analyze_csvtool returns{ error: "..." }. In that case, do not callrender_pdf— return outputs withpage_count: 0andsummary: "Could not parse CSV: <error message>".
© skrun-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 6 other files (scripts) in agents/csv-to-executive-report of skrun-dev/skrun.
- SKILL.md
- README.md
- agent.yaml
- fixtures/sample-revenue.csv
- requirements.txt
- scripts/analyze_csv.py
- scripts/render_pdf.py
Open the folder on GitHubat commit b1d963b
Compare with similar skills
CSV To Executive Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| CSV To Executive Report this skillskrun-dev/skrun | 210 | — | ~1.1k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 782 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences | 274 | 2 repos | ~2.7k | Automated safety check: Pass | Apache-2.0 | |
| Uap Release Analyzerckpxgfnksd-max/uap-release-analyzer | 155 | — | ~2.6k | Automated safety check: Pass | MIT | |
| Research Integrity Auditxuzhougeng/wisp-science | 1k | — | ~2.6k | Automated safety check: Pass | AGPL-3.0 | |
| Graphic EbookVarnan-Tech/opendirectory | 674 | — | ~5k | Automated safety check: Pass | MIT |
Similar skills
- Official
Instrument Data To Allotrope
aws-samples/amazon-bedrock-agents-healthcare-lifesciences
Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.
Uap Release Analyzer
ckpxgfnksd-max/uap-release-analyzer
Inventory, extract, and analyze tranches of declassified UAP/UFO files — including war.gov/UFO/ "PURSUE" releases, FBI Vault, NARA boxes, and AARO publications.
Research Integrity Audit
xuzhougeng/wisp-science
学术审查 / research-integrity screening of a manuscript's figures and reported numbers.
Graphic Ebook
Varnan-Tech/opendirectory
Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF.
Ky Markdown Rebuilder
KyrieCheungYep/ky-markdown-rebuilder
Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.
More from skrun-dev/skrun
All 14 skills in this repoAdr Writer
skrun-dev/skrun
Generate a numbered Architecture Decision Record (ADR) following the standard nygard/MADR convention.
Changelog Generator
skrun-dev/skrun
Generate a polished CHANGELOG.md and release-notes.md from a local git repository (or a captured .git-log.txt dump).
Knowledge Base From Vault
skrun-dev/skrun
Turn a folder of Markdown notes (Obsidian vault, Notion export, plain repo docs) into a navigable static HTML knowledge base bundled as a single .zip file.
Meeting Transcript To Action Items
skrun-dev/skrun
Listen to a meeting recording and extract structured action items, decisions, and open questions.
Semgrep Rule Creator
skrun-dev/skrun
Generate a complete Semgrep rule bundle (rule.yml + tests.md + README.md) from a CVE description and a bad-code example.
Receipts To Expenses
skrun-dev/skrun
Read a batch of receipt images directly via vision, classify each into expense categories, optionally reconcile against a bank statement CSV, and produce a multi-sheet Excel workbook + a PDF summary.
Related
Works with
Categories
Questions about CSV To Executive Report
What does CSV To Executive Report do?
Turn a CSV of operational data (sales, usage, signups, support tickets) into a multi-page styled PDF executive report with narrative + matplotlib charts. CSV To Executive Report is an agent skill from skrun-dev/skrun. Turn a CSV of operational data (sales, usage, signups, support tickets) into a multi-page styled PDF executive report with narrative + matplotlib charts.
When should I use CSV To Executive Report?
CSV To Executive Report fits situations like: given a CSV and asked for a report; tasks that involve Report writing; tasks that involve CSV and tabular files.
How do I install CSV To Executive Report in Claude Code?
Run `npx skills add skrun-dev/skrun --skill csv-to-executive-report -a claude-code`. Or copy the skill folder (agents/csv-to-executive-report in skrun-dev/skrun) into .claude/skills/csv-to-executive-report in your project. Claude Code loads it when a task matches its description.
How do I install CSV To Executive Report in Codex?
Run `npx skills add skrun-dev/skrun --skill csv-to-executive-report -a codex`. Or copy the skill folder (agents/csv-to-executive-report in skrun-dev/skrun) into .agents/skills/csv-to-executive-report in your project. Codex loads it when a task matches its description.
Can I use CSV To Executive Report in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add skrun-dev/skrun --skill csv-to-executive-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/csv-to-executive-report, .gemini/skills/csv-to-executive-report, .github/skills/csv-to-executive-report and .opencode/skills/csv-to-executive-report in your project.
What does CSV To Executive Report need to run?
Going by SKILL.md and its folder, CSV To Executive Report needs Python for the scripts in its folder. Our summary lists: Python 3.
Does CSV To Executive Report access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is CSV To Executive Report safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does CSV To Executive Report use?
CSV To Executive Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does CSV To Executive Report use?
About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to CSV To Executive Report?
Skills that share tags, products or a category with CSV To Executive Report: Markitdown (ImCa0/just-laws, 782 stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Uap Release Analyzer (ckpxgfnksd-max/uap-release-analyzer, 155 stars) and Research Integrity Audit (xuzhougeng/wisp-science, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains CSV To Executive Report?
skrun-dev (a GitHub organization) maintains it in skrun-dev/skrun, which has 210 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 22, 2026.
Source: skrun-dev/skrun on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.