xlsx: tratar la hoja de cálculo como entregable principal

Para quién

Cuando una hoja de cálculo es la entrada o salida principal, usa esta guía xlsx. Cubre abrir, leer, editar o reparar archivos .xlsx, .xlsm, .xltx, .csv o .tsv existentes. El entregable debe ser un archivo de hoja de cálculo.

No dispares esto cuando el entregable principal sea un documento Word, un informe HTML, un script de Python independiente, un pipeline de base de datos o una integración Google Sheets API, aunque en medio haya datos tabulares. El material no lista productos de agente; no lo trates como exclusivo de un software. La página oficial de la guía es

https://raw.githubusercontent.com/anthropics/skills/main/skills/xlsx/SKILL.md

Primera prueba en 3 minutos

Ruta recomendada: openpyxl, pandas y markitdown ya vienen preinstalados. No hagas pip install primero; escribe un script e impórtalos directamente.

Requisito: el entorno actual puede importar estas tres bibliotecas directamente. La primera prueba de bajo riesgo es una mirada de solo lectura; no escribas en disco todavía. Para un archivo local que ya existe, importa markitdown para una vista rápida. Si el archivo no existe, detente en el fallo de apertura; no crees una hoja de ejemplo no nombrada.

Señal de éxito: la importación funciona y puedes ver un resumen de texto de ese archivo. Esto no es reparación ni sobrescritura. Si aún no hay archivo y el usuario pide explícitamente una hoja, pasa a crear con openpyxl, pero confirma el nombre y si sobrescribe antes de escribir en disco.

Al crear, recuerda: usa fórmulas; no escribas resultados fijos que Python ya calculó. El ejemplo del material escribe una celda como =SUM(B2:B9) para que la hoja pueda recalcular cuando cambien las entradas.

Casos de uso

Caso 1: crear o cambiar una hoja que recalcule. Escribe un script con el openpyxl preinstalado. Tras importar, escribe los totales como fórmulas — por ejemplo B10 usa =SUM(B2:B9) — en lugar de sumar en Python y escribir un número. El criterio de cierre: el archivo contiene fórmulas y la hoja puede recalcular tras cambiar entradas. El resumen deja pandas para lectura/escritura por lotes y markitdown para la vista rápida; este caso cubre solo la escritura de fórmulas. El extracto no da una API de estilo completa; no inventes funciones de formato que no aparecen.

Caso 2: un archivo con fórmulas debe recalcularse antes de leer valores. El material indica: siempre que el archivo contenga fórmulas, el recálculo es obligatorio. openpyxl escribe las fórmulas como cadenas y no tiene valores en caché; hasta que recalcules, cada celda de fórmula se lee como None. Es una comprobación reversible: abre el archivo que acabas de escribir y lee una celda de fórmula; si obtienes None, aún no se recalculó — detente ahí, termina el recálculo y luego trata el valor leído como resultado. No interpretes None como un total de cero.

Límites de uso

Úsalo solo cuando la hoja de cálculo misma sea el entregable principal. Word, HTML, scripts independientes, pipelines de base de datos y Google Sheets API no toman este camino aunque contengan tablas. Las tres bibliotecas están preinstaladas; por defecto no hagas pip install primero. Las fórmulas deben poder recalcular cuando cambien las entradas; después de escribir hay que recalcular, o la lectura vuelve None.

No escribas una ruta de repositorio que no aparece como comando de instalación. No hagas pasar números fijos por totales. Antes de escribir en disco o sobrescribir la hoja original, confirma la ruta de destino y los efectos secundarios, luego ejecuta. Más allá de estos tipos de archivo, esta forma de importar y estos requisitos de recálculo ya escritos, esta guía no cubre el resto.