Skill docx: leer, escribir y editar documentos Word

Para quién

Para quien necesita que un agente cree, lea, edite o trate documentos Word (.docx / .dotx): informes, notas, cartas, plantillas, o extraer, reordenar, sustituir imágenes, buscar y reemplazar, cambios y comentarios en un Word existente. La evidencia dice usar este skill cuando se menciona un documento Word, .docx, .dotx, o se pide un documento formal con índice, títulos, números de página o membrete.

No para PDF, hojas de cálculo, Google Docs ni programación general ajena a generar documentos. Do NOT use fija ese límite; no lo amplíes a otros formatos.

Reconoce primero las dependencias: docx (npm, preinstalado), pandoc, LibreOffice (soffice), pdftoppm (Poppler). Sin pandoc en la ruta de lectura, la primera lectura no sigue. No se exige un marketplace de agente; no infieras tienda ni instalación en un clic.

Primer intento en 3 minutos

Requisito: el agente actual cargó el skill llamado docx y se puede llamar pandoc en la máquina o desde ese directorio del skill. Según lo oficial, docx viene preinstalado; no ejecutes npm install primero. Solo si falla require('docx'): npm install docx.

La vía principal recomendada es una mirada de solo lectura, no editar de inmediato. En una conversación con el skill cargado, ejecuta el comando oficial de lectura sobre un .docx tuyo:

pandoc -t markdown file.docx

Sustituye file.docx por el nombre real. Lee el archivo y produce Markdown. Es lectura, no garantía sin pérdida. Confirma la ruta para no convertir un documento que deba quedar privado. No hay deshacer en la evidencia. Éxito: el comando termina con texto Markdown. No se describe cómo elegir el skill en la UI; solo usarlo cuando hace falta Word.

Si luego editas un documento existente, párate: la vía oficial es unzip → editar word/document.xml → zip, y docx-js no puede abrir archivos existentes. Es escritura y cambia el archivo; ten una copia. No empieces el primer intento por la escritura.

Casos de uso

Caso 1: lectura. pandoc -t markdown file.docx pasa un Word existente a Markdown; comprueba títulos y cuerpo. La evidencia cubre solo este comando de lectura, no otros convertidores.

Caso 2: editar un documento existente. Los tres pasos oficiales sobre el archivo, cambiar word/document.xml y volver a zip. docx-js no abre existentes; no «abras el archivo viejo con docx-js». Ruta con efecto secundario explícito; copia de seguridad primero. No hay script completo; los parámetros que falten siguen desconocidos.

Límites

La lectura depende de pandoc. La escritura depende de descomprimir / XML / volver a empaquetar y luego puede usar LibreOffice y pdftoppm para comprobaciones fuera de este primer intento. No lo uses para PDF, tablas o Google Docs. Un docx preinstalado no omite npm install docx si falla require('docx'). UI de agente, deshacer y modelo de permisos no están; deja huecos desconocidos y no escribas «sin riesgo».