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
