Faro
Tools/tabular
Tabular

Tabular

Active

Your agent can't reliably reshape large CSV, JSON, or XLSX by hand; this converts and filters them with a structured spec.

2 tools

Convert tabular data between CSV, JSON, and XLSX, and reshape it (select, filter, sort, limit) with a structured spec. 0.5 credits per MB of input.

Documentscsvjsonxlsxconvertspreadsheetdata

Tools (2)

▶reshape

Select columns, filter and sort rows, and limit, then convert format.

Usage-based · 0.5 credits per MB of input

Example prompts

  • “From this CSV keep only name and revenue where revenue is over 1000, sorted descending”
  • “Filter this spreadsheet to rows where status equals active and return JSON”

Parameters

tostringrequired

Target format.

fromstringrequired

Source format.

limitintegeroptional

Keep at most this many rows.

sheetstringoptional

Sheet name for xlsx input.

selectarrayoptional

Columns to keep, in this order.

filtersarrayoptional

Row filters, AND-combined.

sort_byarrayoptional

Sort keys, applied in order.

input_urlstringrequired

Pre-signed GET URL of the input file.

expires_inintegeroptionaldefault: 3600

Download URL TTL in seconds.

output_filenamestringoptional

Filename for the output. Defaults to reshaped.<to>.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tabular/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "From this CSV keep only name and revenue where revenue is over 1000, sorted descending"
  }
}'

CLI Usage

askfaro describe tabular/reshape

Install pip install askfaro-cli, then askfaro auth login.

▶convert

Convert tabular data between CSV, JSON, and XLSX.

Usage-based · 0.5 credits per MB of input

Example prompts

  • “Convert this CSV to XLSX”
  • “Turn this spreadsheet into JSON”
  • “Convert this JSON array into a CSV”

Parameters

tostringrequired

Target format.

fromstringrequired

Source format.

sheetstringoptional

Sheet name for xlsx input (default first sheet).

input_urlstringrequired

Pre-signed GET URL of the input file.

expires_inintegeroptionaldefault: 3600

Download URL TTL in seconds.

output_filenamestringoptional

Filename for the output. Defaults to output.<to>.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tabular/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Convert this CSV to XLSX"
  }
}'

CLI Usage

askfaro describe tabular/convert

Install pip install askfaro-cli, then askfaro auth login.

▶README

Tabular

Interconvert CSV, JSON, and XLSX, and apply a structured reshape (column selection, row filters, sorting, and limit) with no arbitrary code execution.

Workflow

  1. POST /uploads/presign on faro-api, PUT your file, pass the get_url as input_url.
  2. Set from and to formats; download the result from download_url.

Pricing

0.5 credits per MB of input.

Limits

Input up to 50 MB and 1,000,000 rows. Reshape ops are a fixed vocabulary (eq/ne/gt/lt/ge/le/contains/in/notnull/isnull), there is no query/eval string.