Skill
Skill DOCX (Word)
Crédito: anthropics no GitHub (anthropics/skills) · 0 cópias
Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026
179,8 mil estrelas no GitHubVer no GitHub
Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).
---
name: docx
description: "Use esta skill sempre que o usuário quiser criar, ler, editar ou manipular documentos do Word (arquivos .docx) ou modelos do Word (arquivos .dotx). Os gatilhos incluem: qualquer menção a 'Word doc', 'word document', '.docx', '.dotx', ou pedidos para produzir documentos profissionais com formatação, como sumários, títulos, números de página ou papel timbrado. Use também ao extrair ou reorganizar conteúdo de arquivos .docx ou .dotx, inserir ou substituir imagens em documentos, fazer localizar e substituir em arquivos do Word, trabalhar com alterações controladas ou comentários, ou converter conteúdo em um documento Word bem acabado. Se o usuário pedir um 'relatório', 'memorando', 'carta', 'modelo' ou entregável parecido como arquivo Word ou .docx, use esta skill. NÃO use para PDFs, planilhas, Google Docs nem tarefas gerais de programação sem relação com a geração de documentos."
license: Proprietary. LICENSE.txt has complete terms
---
# Criação, edição e análise de DOCX
Um `.docx` é um arquivo ZIP de arquivos XML. Escolha a abordagem conforme a tarefa:
| Tarefa | Abordagem |
|---|---|
| **Criar** um documento novo | Escreva um script `docx` (npm) — veja as pegadinhas abaixo |
| **Editar** um documento existente | `unzip` → edite `word/document.xml` → `zip` (o docx-js não consegue abrir arquivos existentes) |
| **Ler** o conteúdo | `pandoc -t markdown file.docx` |
> Os caminhos de scripts abaixo são relativos ao diretório desta skill.
## Criando com o docx-js — pegadinhas
O `docx` já vem pré-instalado — não rode `npm install` antes; escreva o script e use `require('docx')` diretamente. Somente se esse require falhar: `npm install docx`. O modelo conhece a API; estas são as armadilhas:
- **O tamanho de página padrão é A4.** Para US Letter, defina `page: { size: { width: 12240, height: 15840 } }` (DXA; 1440 = 1″).
- **Paisagem:** passe as dimensões em retrato e `orientation: PageOrientation.LANDSCAPE` — o docx-js troca largura e altura internamente.
- **As tabelas precisam de larguras duplas:** defina `columnWidths` na tabela E `width` em cada célula, ambos em `WidthType.DXA` (PERCENTAGE quebra no Google Docs). As larguras das colunas devem somar a largura da tabela.
- **Sombreamento de tabela:** use `ShadingType.CLEAR`, nunca `SOLID` (renderiza preto).
- **Listas:** nunca insira `•` literalmente; use uma configuração de `numbering` com `LevelFormat.BULLET`.
- **`ImageRun` exige `type:`** (`"png"`, `"jpg"`, …).
- **`PageBreak` deve ficar dentro de um `Paragraph`.**
- **Nunca use `\n`** — use elementos `Paragraph` separados.
- **Sumário:** os títulos devem usar os `HeadingLevel.*` nativos; estilos de título personalizados precisam de `outlineLevel` definido, senão não aparecem.
- **Não use uma tabela como linha horizontal** — use uma borda inferior de parágrafo.
- **Pontilhado de preenchimento / alinhado à direita na mesma linha:** use `PositionalTab` (`alignment: PositionalTabAlignment.RIGHT`, `leader: PositionalTabLeader.DOT`) dentro de um `TextRun`, e não `.` literais ou espaços de preenchimento.
## Verifique a saída
Depois de escrever um `.docx`, renderize-o e olhe:
```bash
python scripts/office/soffice.py --headless --convert-to pdf output.docx
pdftoppm -jpeg -r 100 output.pdf page
ls page-*.jpg # then Read the images
```
O `pdftoppm` completa com zeros os números de página até a largura da contagem de páginas (`page-01.jpg`…`page-12.jpg`).
## Editando documentos existentes
Arquivos `.doc` legados devem ser convertidos primeiro: `python scripts/office/soffice.py --headless --convert-to docx file.doc`.
```bash
unzip -q doc.docx -d unpacked/
find unpacked -type l -delete # strip symlink entries — docx from external parties is untrusted
python scripts/merge_runs.py unpacked/ # coalesce fragmented runs so text is findable
# edit unpacked/word/document.xml in place — do NOT reformat or pretty-print
(cd unpacked && rm -f ../out.docx && zip -Xr ../out.docx .)
python scripts/office/validate.py out.docx --original doc.docx # XSD checks; --auto-repair fixes common issues
# redlining? add --author "<the name you redlined under>" to check every edit is tracked
```
O Word divide o texto em muitas runs `<w:r>` (ids de revisão, marcadores do corretor ortográfico); por isso, uma frase que você vê no documento muitas vezes não existe como uma string contígua no XML. O `merge_runs.py` mescla runs adjacentes com a mesma formatação em `word/document.xml` sem alterar o conteúdo nem a renderização; ele também aceita um `.docx` diretamente (`python scripts/merge_runs.py doc.docx -o merged.docx`).
**Alterações controladas:** ao fazer redlining, valide com `--author "<the name you redlined under>"` (exige `--original`) — ele relata qualquer texto que você alterou sem um `<w:ins>`/`<w:del>` em volta, o que é fácil de fazer por acidente e invisível na visão com as alterações aceitas. Envolva as runs em `<w:ins>`/`<w:del>` com os atributos `w:id`, `w:author`, `w:date`. Dentro de `<w:del>`, o elemento de texto é `<w:delText>`, e não `<w:t>`. Uma marca de parágrafo excluída (`<w:pPr><w:rPr><w:del w:id=".." w:author=".." w:date=".."/></w:rPr></w:pPr>`) significa "mesclar este parágrafo com o seguinte" — então excluir um parágrafo por completo é isso mais um `<w:del>` em volta de cada run. O `<w:del/>` deve vir antes dos outros filhos do rPr; a ordem deles é imposta pelo esquema.
Para produzir uma cópia limpa com todas as alterações controladas aceitas: `python scripts/accept_changes.py in.docx out.docx`.
Aceitar uma marca de parágrafo excluída deve unir esse parágrafo ao de baixo; portanto, um parágrafo cujas runs foram *todas* excluídas desaparece. O Word faz isso; o `accept_changes.py` e o `pandoc --track-changes=accept` nem sempre. Os dois falham do mesmo jeito — eles removem o texto excluído, mas deixam o parágrafo esvaziado, que aparece como um marcador vazio solto quando era numerado automaticamente:
- O `pandoc --track-changes=accept` nunca une os parágrafos.
- O `accept_changes.py` (LibreOffice) os une corretamente, exceto quando o parágrafo excluído é seguido por um parágrafo espaçador vazio.
Um marcador vazio em qualquer uma das visões é um artefato dessa visão, e não um defeito do documento. Confira as exclusões de parágrafo no XML.
## Comentários
Os comentários exigem seis arquivos interligados. Use o auxiliar — modo diretório quando você também for editar o `document.xml` (economiza um ciclo de unzip/rezip), modo `.docx` direto caso contrário:
```bash
# Against an already-unpacked directory (preferred when also placing markers)
python scripts/comment.py unpacked/ "Fees & expenses cap is too low"
python scripts/comment.py unpacked/ "Agreed" --parent 0
# Against a .docx directly
python scripts/comment.py contract.docx "This cap is too low" -o annotated.docx
```
O script grava `comments.xml`, `commentsExtended.xml`, `commentsIds.xml`, `commentsExtensible.xml`, as relações e as substituições de tipo de conteúdo. Os IDs dos comentários são atribuídos automaticamente. Em seguida, ele imprime o trecho `<w:commentRangeStart>`/`<w:commentRangeEnd>`/`<w:commentReference>` para adicionar ao `word/document.xml`, de modo que o comentário fique ancorado em um texto específico — até você colocar esses marcadores, o comentário existe, mas não é visível.
## Dependências
`docx` (npm, pré-instalado — instale apenas se `require('docx')` falhar) · `pandoc` · LibreOffice (`soffice`) · `pdftoppm` (Poppler)Funciona com:Claude

