Agent skill

CSV Insights

by simonw in simonw/research

Summarize a CSV, compute basic stats, and produce a markdown report + a plot image.

No licenceAuto-check passedDocuments & Office

Install CSV Insights

skills CLI
$ npx skills add simonw/research --skill csv-insights -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install simonw/research csv-insights --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/simonw/research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/openai-api-skills/csv_insights_skill .claude/skills/csv-insights && rm -rf skills-src

Use ~/.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/

Facts

Skill name
csv-insights
GitHub stars
781
Token cost
~154 tokens
SKILL.md length
71 words
Files
4 (incl. assets)
Skills in repo
3
Repo updated
First seen
Licence
None found

At a glance

Summarize a CSV, compute basic stats, and produce a markdown report + a plot image.

  • Tasks that involve CSV and tabular files
  • SKILL.md covers When to use this, Inputs, Outputs and How to run
  • Runs Python scripts from its folder

What it does

CSV Insights is an agent skill from simonw/research. Summarize a CSV, compute basic stats, and produce a markdown report + a plot image.

Its SKILL.md is about 150 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including assets (for example `run.py`).

It sits in Documents & Office, covering CSV and tabular files. It works with OpenAI.

When your agent uses it

  • Tasks that involve CSV and tabular files

Example prompts

  • “/csv-insights”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 4f5f23e. 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 script files (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 Insights loads about 154 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 71 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~154

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); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 71 words (~154 tokens).

“Use this skill when the user provides a CSV file and wants:”

— opening of SKILL.md by simonw
name
csv-insights

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (assets) in openai-api-skills/csv_insights_skill of simonw/research.

  • SKILL.md
  • assets/example.csv
  • requirements.txt
  • run.py

Open the folder on GitHubat commit 4f5f23e

Compare with similar skills

CSV Insights 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.

CSV Insights compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
CSV Insights this skillsimonw/research781—~154Automated safety check: PassNone
Openai Spreadsheettrailofbits/skills-curated512—~1.3kAutomated safety check: NotesCC-BY-SA-4.0
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Openai Security Ownership Maptrailofbits/skills-curated5125 repos~2.2kAutomated safety check: NotesCC-BY-SA-4.0
Sector Analysttradermonty/claude-trading-skills3k1 repos~2.3kAutomated safety check: PassMIT
Cliare Artifact Reviewmodiqo/cliare469—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Openai Spreadsheet

    trailofbits/skills-curated

    Official

    A skill your agent uses when tasks involve creating, editing, analyzing, or formatting spreadsheets (.xlsx, .csv, .tsv) using Python (openpyxl, pandas), especially when formulas, references, and…

    512 GitHub stars~1.3k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Openai Security Ownership Map

    trailofbits/skills-curated

    Official

    Analyze git repositories to build a security ownership topology (people-to-file), compute bus factor and sensitive-code ownership, and export CSV/JSON for graph databases and visualization.

    512 GitHub starsUsed in 5 repos~2.2k tokens
    DevelopmentAuto-check: notes
  • Sector Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing sector rotation patterns and market cycle positioning.

    3k GitHub starsUsed in 1 repo~2.3k tokens
    Documents & OfficeAuto-check passed
  • A skill your agent uses when reviewing a CLIARE measurement artifact directory, explaining score changes, triaging issues, finding evidence, or proposing CLI remediation work from artifact-map.json…

    469 GitHub stars~2.4k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Convert File

    duckdb/duckdb-skills

    Official

    Convert any data file to another format: CSV, Parquet, JSON, Excel, GeoJSON, and more.

    599 GitHub starsUsed in 1 repo~720 tokens
    Documents & OfficeAuto-check: notes

More from simonw/research

  • Guide for writing Datasette plugins. An agent skill from simonw/research.

    781 GitHub stars~2.9k tokensUpdated 3 days ago
    Auto-check passed
  • Starlette

    simonw/research

    Build async web applications and APIs with Starlette 1.0, the lightweight ASGI framework for Python.

    781 GitHub stars~8.6k tokensUpdated 3 days ago
    Auto-check: notes

Works with

Questions about CSV Insights

What does CSV Insights do?

Summarize a CSV, compute basic stats, and produce a markdown report + a plot image. CSV Insights is an agent skill from simonw/research. Summarize a CSV, compute basic stats, and produce a markdown report + a plot image.

When should I use CSV Insights?

CSV Insights fits situations like: tasks that involve CSV and tabular files.

How do I install CSV Insights in Claude Code?

Run `npx skills add simonw/research --skill csv-insights -a claude-code`. Or copy the skill folder (openai-api-skills/csv_insights_skill in simonw/research) into .claude/skills/csv-insights in your project. Claude Code loads it when a task matches its description.

How do I install CSV Insights in Codex?

Run `npx skills add simonw/research --skill csv-insights -a codex`. Or copy the skill folder (openai-api-skills/csv_insights_skill in simonw/research) into .agents/skills/csv-insights in your project. Codex loads it when a task matches its description.

Can I use CSV Insights 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 simonw/research --skill csv-insights -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-insights, .gemini/skills/csv-insights, .github/skills/csv-insights and .opencode/skills/csv-insights in your project.

What does CSV Insights need to run?

Going by SKILL.md and its folder, CSV Insights needs Python for the scripts in its folder. Our summary lists: Python 3.

Does CSV Insights 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 Insights 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. Review the folder before installing.

What licence does CSV Insights use?

No licence was found for CSV Insights or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does CSV Insights use?

About 154 tokens (SKILL.md is roughly 616 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 Insights?

Skills that share tags, products or a category with CSV Insights: Openai Spreadsheet (trailofbits/skills-curated, 512 stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Openai Security Ownership Map (trailofbits/skills-curated, 512 stars) and Sector Analyst (tradermonty/claude-trading-skills, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains CSV Insights?

simonw (a GitHub user) maintains it in simonw/research, which has 781 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 4, 2026.

Source: simonw/research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.