# Tabular

> Skill `tabular` on Faro. 2 sub-skills.

Work with CSV, JSON, and XLSX files without writing code. Convert a file from one format to another with every column preserved, or reshape it by selecting columns, filtering rows, sorting, and taking a top-N slice. The result is always a download link to the transformed file.

**Category:** Documents  
**Tags:** csv, json, xlsx, convert, spreadsheet, data  
**Use when:** You have a CSV, JSON, or XLSX file and need it in another of those formats, or trimmed to the columns and rows you want.  
**Not for:** Computing totals, averages, group-by, pivots, deduplication, joining files, renaming or deriving columns, running SQL or formulas, reading the values into your reasoning, or handling nested JSON, TSV, or Parquet.  
**Returns:** file — Returns a time-limited download link to the result file, not the rows inline. JSON is an array of row objects.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/tabular/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Convert this CSV to an Excel file."}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run tabular "Convert this CSV to an Excel file."
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Convert this CSV to an Excel file.
- From this CSV, keep only the name and revenue columns where revenue is over 10000.

## Sub-skills

### Convert format

Reads a CSV, JSON, or XLSX file and writes it out in another of those formats, keeping every column and value.

**Cost:** ~1 credits / MB of input (up to 5) — A 4 MB file costs about 2 credits; larger inputs cost more.

**Use when:** You want the same data in a different file format, such as a CSV export turned into XLSX or an XLSX turned into JSON for an API.

**Details:** https://askfaro.com/llms/skills/tabular/convert.md

---

### Reshape table

Keeps chosen columns, filters rows by simple conditions, sorts, and limits, then writes the result in CSV, JSON, or XLSX.

**Cost:** ~1 credits / MB of input (up to 5) — Charged on the input size, so a wide source costs the same whether you keep one column or all.

**Use when:** You want a large file cut down to specific columns and rows, or a sorted top-N slice, with no code.

**Details:** https://askfaro.com/llms/skills/tabular/reshape.md

---

---
On the web: https://askfaro.com/search/tabular