# Convert File

> Convierte cualquier archivo de datos a otro formato: CSV, Parquet, JSON, Excel, GeoJSON y más, usando DuckDB.

Fuente: https://skillsagentes.com/skills/duckdb/duckdb-skills/convert-file
Markdown: https://skillsagentes.com/skills/duckdb/duckdb-skills/convert-file.md

Repositorio: https://github.com/duckdb/duckdb-skills
Autor: duckdb
Licencia: MIT
Actualizado: hace 5 meses
Coste de contexto: 97 tok instalada, 725 tok al activarse, 725 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: bash

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add duckdb/duckdb-skills --skill convert-file --agent claude-code
# Cursor
npx -y skills add duckdb/duckdb-skills --skill convert-file --agent cursor
# Codex
npx -y skills add duckdb/duckdb-skills --skill convert-file --agent codex
# Gemini CLI
npx -y skills add duckdb/duckdb-skills --skill convert-file --agent gemini
# Windsurf
npx -y skills add duckdb/duckdb-skills --skill convert-file --agent windsurf
# Cline
npx -y skills add duckdb/duckdb-skills --skill convert-file --agent cline
```

## Qué hace

- Resuelve la ruta del archivo de entrada y determina el formato de salida según la extensión
- Construye y ejecuta un comando DuckDB único (COPY ... TO ...) con las cláusulas de formato y extensiones necesarias
- Añade configuración de protocolo para entradas remotas (s3://, gs://, https://)
- Aplica opciones de PARTITION_BY o CODEC si el usuario menciona particionado o compresión
- Informa el archivo de salida, formato, tamaño y recuento de filas, o diagnostica errores comunes

## Cuándo usarla

- El usuario pide convertir un archivo a otro formato como CSV, Parquet, JSON, Excel o GeoJSON
- El usuario dice frases como "convert to parquet", "save as xlsx", "export as JSON" o "make this a CSV"
- El usuario quiere escribir formatos binarios como Parquet o Excel que Claude no puede generar de forma nativa

## Qué la activa

- "Convierte data.csv a parquet"
- "Guarda este archivo como xlsx"
- "Exporta este JSON como CSV particionado por año"
- "Transforma este shapefile en GeoJSON"

## Antes de instalar

- Requiere el binario duckdb instalado y, según el formato, cargar extensiones como excel, spatial o httpfs.
- runs shell commands

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde duckdb/duckdb-skills bajo MIT. Esta sección es el documento original y está en inglés.

You are helping the user convert a data file from one format to another using DuckDB.

Input file: `$0`
Output file: `${1:-}`

## Step 1 — Resolve input and output

**Input**: `$0`. If it's a bare filename (no `/`), resolve to a full path with `find "$PWD" -name "$0" -not -path '*/.git/*' 2>/dev/null | head -1`.

**Output**: If `$1` is provided, use it as the output path. If not, default to the same stem as the input with a `.parquet` extension (e.g., `data.csv` → `data.parquet`).

Infer the output format from the output file extension:

| Extension | Format clause |
|---|---|
| `.parquet`, `.pq` | *(default, no clause needed)* |
| `.csv` | `(FORMAT csv, HEADER)` |
| `.tsv` | `(FORMAT csv, HEADER, DELIMITER '\t')` |
| `.json` | `(FORMAT json, ARRAY true)` |
| `.jsonl`, `.ndjson` | `(FORMAT json, ARRAY false)` |
| `.xlsx` | `(FORMAT xlsx)` — requires `INSTALL excel; LOAD excel;` |
| `.geojson` | `(FORMAT GDAL, DRIVER 'GeoJSON')` — requires `LOAD spatial;` |
| `.gpkg` | `(FORMAT GDAL, DRIVER 'GPKG')` — requires `LOAD spatial;` |
| `.shp` | `(FORMAT GDAL, DRIVER 'ESRI Shapefile')` — requires `LOAD spatial;` |

## Step 2 — Convert

Run a single DuckDB command. Prepend extension loads as needed based on both the input and output formats.

```bash
duckdb -c "
<EXTENSION_LOADS>
COPY (FROM '<INPUT_PATH>') TO '<OUTPUT_PATH>' <FORMAT_CLAUSE>;
"
```

For remote inputs (`s3://`, `https://`, etc.), prepend the same protocol setup as `read-file`:

| Protocol | Prepend |
|---|---|
| `s3://` | `LOAD httpfs; CREATE SECRET (TYPE S3, PROVIDER credential_chain);` |
| `gs://` / `gcs://` | `LOAD httpfs; CREATE SECRET (TYPE GCS, PROVIDER credential_chain);` |
| `https://` / `http://` | `LOAD httpfs;` |

**If the user mentions partitioning** (e.g., "partition by year"), add `PARTITION_BY (col)` to the format clause. This only works with Parquet and CSV output.

**If the user mentions compression** (e.g., "use zstd"), add `CODEC 'zstd'` for Parquet output.

## Step 3 — Report

On success, report:
- Input file and detected format
- Output file, format, and size (`ls -lh`)
- Row count if quick to compute

On failure:
- **`duckdb: command not found`** → delegate to `/duckdb-skills:install-duckdb`
- **Missing extension** → install it and retry
- **Input parse error** → suggest the user check the input format or try `/duckdb-skills:read-file` first to inspect it

## Dónde encaja

- Categoría: [Datos y analítica](https://skillsagentes.com/categorias/datos-analitica.md) — Consulta, limpia y visualiza datos sin salir del agente.
- Creador: [duckdb](https://skillsagentes.com/creators/duckdb.md) — 0 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Spatial](https://skillsagentes.com/skills/duckdb/duckdb-skills/spatial.md): Responde preguntas sobre datos espaciales con DuckDB: ubicaciones, coordenadas, distancias, mapas, direcciones, formatos como GeoJSON, Shapefile, GeoPackage, GPX o GeoParquet, usando también Overture Maps.
- [S3 Explore](https://skillsagentes.com/skills/duckdb/duckdb-skills/s3-explore.md): Explora y consulta datos en S3, Cloudflare R2, GCS, MinIO o cualquier almacenamiento compatible con S3, sin necesidad de descargarlos.
- [Duckdb Docs](https://skillsagentes.com/skills/duckdb/duckdb-skills/duckdb-docs.md): Busca en la documentación de DuckDB y DuckLake y en posts del blog, devolviendo fragmentos relevantes mediante búsqueda de texto completo contra un índice local cacheado.
- [Read File](https://skillsagentes.com/skills/duckdb/duckdb-skills/read-file.md): Lee cualquier archivo de datos (CSV, JSON, Parquet, Avro, Excel, spatial, SQLite) o URL remota (S3, HTTPS) usando DuckDB. No sirve para código fuente.
- [Read Memories](https://skillsagentes.com/skills/duckdb/duckdb-skills/read-memories.md): Busca en los logs de sesiones pasadas de Claude Code para recordar decisiones, patrones o trabajo pendiente. Úsalo cuando el usuario mencione conversaciones anteriores o necesites contexto previo.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)