Skill: csv-tools

When to Use

Use this skill when the user asks to:

View or pretty-print a CSV/JSON file
Filter rows from a data file
Sort data by a column
Get summary statistics (count, mean, min, max)
Convert CSV to JSON or JSON to CSV
Query or analyze tabular data
Count rows or summarize a dataset

Input Parameters

Parameter	Required	Description	Example
`action`	Yes	`view`, `filter`, `sort`, `stats`, `convert`	view
`file_path`	Yes	Path to the CSV or JSON file	data.csv
`column`	For filter/sort	Column name to operate on	age
`value`	For filter	Value to match (supports operators: `>`, `<`, `>=`, `<=`, `!=`, `=`)	>30
`order`	For sort	`asc` (default) or `desc`	desc
`output`	For convert	Output file path	data.json
`limit`	For view	Max rows to display (default: 50)	20

Procedure

Determine the action from the user's request

Run the bundled script:

# View first 50 rows
python3 skills/csv-tools/scripts/query.py view data.csv

# Filter rows
python3 skills/csv-tools/scripts/query.py filter data.csv --column age --value ">30"

# Sort by column
python3 skills/csv-tools/scripts/query.py sort data.csv --column name --order asc

# Summary statistics
python3 skills/csv-tools/scripts/query.py stats data.csv

# Convert CSV to JSON
python3 skills/csv-tools/scripts/query.py convert data.csv --output data.json

Report the result to the user

Bundled Scripts

Script	Type	Description
`scripts/query.py`	Python	Query, filter, sort, and transform CSV/JSON data

Script Usage

# View data (pretty-printed table)
python3 scripts/query.py view data.csv
python3 scripts/query.py view data.csv --limit 10

# Filter rows
python3 scripts/query.py filter data.csv --column status --value "active"
python3 scripts/query.py filter data.csv --column price --value ">100"
python3 scripts/query.py filter data.csv --column name --value "!=John"

# Sort
python3 scripts/query.py sort data.csv --column date --order desc

# Statistics
python3 scripts/query.py stats data.csv
python3 scripts/query.py stats data.csv --column revenue

# Convert formats
python3 scripts/query.py convert data.csv --output data.json
python3 scripts/query.py convert data.json --output data.csv

Example

show me the contents of sales.csv
filter users.csv where age is greater than 30
sort the data by revenue descending
what are the statistics for this CSV file
convert this CSV to JSON
how many rows are in data.csv