utopiabelmont/make-manuscript-good

O que make-manuscript-good faz?

Uniformiza a margem direita irregular de manuscritos .docx alinhados à esquerda em inglês, inserindo hífens condicionais nas fronteiras silábicas. Fornecido como uma skill para agente Claude com uma CLI de verificação/correção.

Visão Geral

Esta skill permite que um agente Claude (ou outro agente compatível) processe arquivos .docx para melhorar a aparência visual do texto, especialmente em documentos alinhados à esquerda. Ao inserir hífens condicionais nos pontos corretos de quebra silábica de palavras em inglês, ela reduz o efeito de margem direita irregular sem alterar o alinhamento ou justificação do documento.

Funcionalidades

• Verificação (check): Analisa um documento .docx e exibe uma lista de palavras que podem ser hifenizadas, juntamente com sua contagem e posição.
• Correção (fix): Aplica a inserção de hífens condicionais no documento .docx de entrada, gerando uma cópia modificada.
• Suporte a língua inglesa: A hifenização segue regras silábicas padrão do inglês.
• Integração com agente: Pode ser executado diretamente por um agente Claude, sem intervenção manual.

Requisitos

• Python 3.8 ou superior
• Biblioteca python-docx (para manipulação de arquivos .docx)
• Biblioteca pyphen (para hifenização silábica)

Uso

Como skill de agente

Para usar com Claude (ou outro agente compatível), basta solicitar o processamento de um arquivo .docx. O agente executará a CLI automaticamente.

Linha de comando direta

# Verificar oportunidades de hifenização em um documento
make-manuscript-good check manuscrito.docx

# Corrigir o documento, inserindo hífens condicionais
make-manuscript-good fix manuscrito.docx -o manuscrito_hifenizado.docx

Parâmetros:

• check <arquivo.docx>: Analisa o documento e exibe estatísticas de hifenização.
• fix <arquivo.docx> [-o <saída.docx>]: Corrige o documento. Se -o não for especificado, o arquivo original é sobrescrito.

Exemplo

Entrada (texto alinhado à esquerda com margem irregular):

Este é um exemplo de texto em inglês que
apresenta uma margem direita bastante irregular.

Saída (com hífens condicionais inseridos):

Este é um exem\-plo de texto em inglês que
apre\-senta uma margem direita bastante irregular.

(Os hífens condicionais são invisíveis a menos que a palavra quebre na margem.)

Como funciona

A skill utiliza o algoritmo de hifenização do pyphen, que segue o dicionário de hifenização do OpenOffice (pt_BR para português, en_US para inglês). O documento .docx é analisado parágrafo por parágrafo, e cada palavra é verificada quanto a pontos de quebra silábica. Os hífens condicionais (código Unicode U+00AD) são inseridos nessas posições.

Notas

• A skill não altera o alinhamento do parágrafo; ela apenas insere hífens condicionais.
• A hifenização é baseada em regras silábicas e pode não ser 100% precisa para todas as palavras (especialmente nomes próprios ou termos técnicos).
• Recomenda-se revisar o documento após a correção.

Licença

MIT (veja o arquivo LICENSE para detalhes).