Skill docx: ler, escrever e editar documentos Word

Para quem

Para quem precisa que um agente crie, leia, edite ou trate documentos Word (.docx / .dotx): relatórios, memorandos, cartas, modelos, ou extrair, reordenar, trocar imagens, localizar e substituir, revisões e comentários num Word existente. A evidência diz para usar este skill quando se fala em documento Word, .docx, .dotx, ou se pede um documento formal com índice, títulos, números de página ou cabeçalho.

Não para PDF, folhas de cálculo, Google Docs nem programação geral sem geração de documento. Do NOT use trava esse limite; não alargue a outros formatos.

Admita primeiro as dependências: docx (npm, pré-instalado), pandoc, LibreOffice (soffice), pdftoppm (Poppler). Sem pandoc no caminho de leitura, a primeira leitura não avança. Não se exige um marketplace de agente; não infira loja nem instalação num clique.

Primeira tentativa em 3 minutos

Pré-requisito: o agente atual carregou o skill chamado docx e pandoc pode ser chamado nesta máquina ou nesse diretório do skill. Oficialmente docx vem pré-instalado; não rode npm install primeiro. Só se require('docx') falhar: npm install docx.

O caminho principal recomendado é só leitura, não editar de imediato. Numa conversa com o skill carregado, execute o comando oficial de leitura num .docx seu:

pandoc -t markdown file.docx

Troque file.docx pelo nome real. Lê o ficheiro e produz Markdown. É leitura, não garantia sem perdas. Confirme o caminho para não converter um documento que deva ficar privado. Não há desfazer na evidência. Sucesso: o comando termina com texto Markdown. Não descreve como escolher o skill na UI; só usá-lo quando for preciso Word.

Se depois editar um documento existente, pare: o caminho oficial é unzip → editar word/document.xml → zip, e o docx-js não abre ficheiros existentes. É escrita e altera o arquivo; tenha uma cópia. Não comece a primeira tentativa pelo caminho de escrita.

Casos de uso

Caso 1: leitura. pandoc -t markdown file.docx passa um Word existente para Markdown; verifique títulos e corpo. A evidência cobre só este comando de leitura, não outros conversores.

Caso 2: editar um documento existente. Os três passos oficiais no arquivo, alterar word/document.xml e voltar a zipar. docx-js não abre existentes; não “abra o ficheiro antigo com docx-js”. Caminho com efeito colateral explícito; faça cópia primeiro. Não há script completo; parâmetros em falta permanecem desconhecidos.

Limites

A leitura depende de pandoc. A escrita depende de descompactar / XML / voltar a empacotar e depois pode usar LibreOffice e pdftoppm para verificações fora desta primeira tentativa. Não use para PDF, tabelas ou Google Docs. Um docx pré-instalado não dispensa npm install docx se require('docx') falhar. UI de agente, desfazer e modelo de permissões não estão na evidência; deixe lacunas desconhecidas e não escreva “sem risco”.