CommunityImagemgithub.com

AshfanAnsari/conversão-de-páginas-escritas-à-mão

Converte fotografias de documentos escritos à mão (tarefas, páginas de caderno) em um documento limpo e completo, escrito em UMA única caligrafia de referência escolhida — combinando estilo de caligrafia, espessura do traço, cor da tinta e tom do papel de uma única página de referência aprovada, página por página, com precisão de texto verificada. Use quando solicitado a reescrever um documento 'nesta caligrafia', clonar uma caligrafia em várias páginas ou transformar fotos de páginas manuscritas em um PDF uniforme para impressão.

O que é conversão-de-páginas-escritas-à-mão?

Esta skill permite reescrever cada página de um documento manuscrito fotografado em uma única caligrafia de referência (a 'página padrão'), combinando quatro eixos independentes: texto, identidade da caligrafia, espessura/tamanho do traço e cor (tinta + papel). Ela é útil para usuários que precisam clonar uma caligrafia específica em muitas páginas, como em trabalhos acadêmicos ou cadernos, garantindo uniformidade visual e precisão textual. A skill suporta plataformas que fornecem um gerador de imagens que aceita uma imagem de referência, um visualizador de imagens com zoom e um runtime de scripting com biblioteca de imagens (por exemplo, Python + PIL/numpy) para medição, composição e avaliação. O fluxo de trabalho envolve travar a página padrão, transcrever exatamente o texto de cada página fonte (incluindo erros de ortografia), gerar cada página do zero usando apenas a imagem padrão e a transcrição, corrigir tamanho/espessura por meio de processamento de pixels (não regeneração cega), graduar a cor para corresponder à página padrão e montar o PDF final apenas com páginas aprovadas. A skill evita modos de falha comuns, como páginas 'fotocopiadas' que parecem convertidas mas não estão, caligrafias inconsistentes entre páginas e distorções de escala ou cor.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AshfanAnsari/handwriting-page-conversion-skill/tree/HEAD

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Conversão de Páginas Escritas à Mão

Reescreva cada página de um documento manuscrito em uma única caligrafia alvo. A caligrafia alvo é definida por UMA página de referência aprovada (a "página padrão"). Todas as outras páginas devem corresponder a ela em quatro eixos independentes: texto, identidade da caligrafia, espessura/tamanho do traço e cor (tinta + papel). Uma página só está pronta quando todos os quatro eixos passarem.

Você precisa de: um gerador de imagens que aceite uma imagem de referência, um visualizador de imagens que possa dar zoom e um runtime de script com uma biblioteca de imagens (ex.: Python + PIL/numpy) para medição, composição e avaliação.

Regras principais (aprendidas da maneira mais difícil — não pule)

  1. Nunca forneça a foto da página fonte ao gerador como referência de estilo/layout. Ele fotocopiará a fonte — a caligrafia original retorna inalterada e parece convertida. Gere cada página do zero a partir de: a imagem da página padrão + uma transcrição exata do texto da página fonte. Nada mais.
  2. Preserve a ortografia e os erros do escritor original. Transcreva exatamente o que a fonte diz, incluindo erros de ortografia ("equilíbrio" escrito como "equilíbrio", "sinal" como "sinal", "coexistir" como "coexistir"). A página fonte é a autoridade no conteúdo, mesmo sobre livros de referência e seu próprio conhecimento. Verifique números, valores de tabela e fórmulas dígito por dígito contra a fonte com zoom.
  3. Verifique os quatro eixos separadamente. Uma página pode passar no texto e falhar na caligrafia (muito limpa, redonda, ousada, parecendo fonte — o padrão do gerador). A verificação apenas de texto trivialmente "passa" em uma página fotocopiada, que é como versões ruins são enviadas.
  4. Trabalhe página por página. Construa uma página, apresente-a, obtenha o veredito do usuário (ou seu "construa todas, julgarei depois") antes de montar qualquer coisa. Corrija apenas as páginas que o usuário sinalizar — nunca troque páginas extras silenciosamente.
  5. Não redesenhe gráficos, diagramas ou tabelas se puder evitar. Redesenhos quebram a geometria (curvas que não se encontram, marcas de eixo duplicadas, pontos finais errados). Carregue páginas impressas/de diagrama como estão. Para um pequeno defeito de rótulo em um desenho correto, corrija pixels: apague com um patch de papel em branco verificado da mesma página, redesenhe o segmento danificado na cor da tinta amostrada. Localize a tinta pelos perfis de linha/coluna de pixels escuros — nunca adivinhe coordenadas em uma visualização redimensionada.

Fluxo de trabalho

1. Trave o padrão

  • Escolha a melhor página (ou gere uma página demo e obtenha aprovação). Esta página fixa: formas das letras, altura mediana da linha (meça, ex.: ~40 px na resolução de trabalho), peso do traço, cor da tinta (amostre, ex.: azul-escuro RGB ≈ [58,58,65]) e tom do papel (ex.: RGB ≈ [208,206,209]).
  • Cada página posterior é julgada contra esta página em escala correspondente — comparações de espessura em diferentes níveis de zoom mentem.

2. Transcreva

  • Leia cada página fonte no tamanho real, depois leia com zoom cada palavra suspeita. Escreva a transcrição exata, preservando ortografias, pontuação, sublinhados, caixas, cabeçalhos e regiões em branco (se o original deixa metade da página em branco, a reescrita também deixa).
  • Liste as "palavras-armadilha" da página (palavras longas/incomuns, valores, fórmulas) explicitamente — estas recebem proteções de ortografia letra por letra no prompt de geração e uma verificação pessoal com zoom depois.

3. Gere do zero

  • Prompt: a imagem da página padrão como a ÚNICA referência de imagem + a transcrição exata + uma especificação de estilo "fino primeiro": "caneta esferográfica fina, pressão leve, traços finos irregulares, tinta azul-escura, nunca grosso / ousado / pesado / limpo". Apenas prompts de texto tendem ao padrão limpo do modelo — a imagem de referência deve estar na chamada.
  • Se seu gerador suporta retomar/continuar de um estado de geração anterior, retomar da própria geração da página padrão e substituir apenas o texto dá a correspondência de caligrafia mais próxima. Nota: esses handles de retomada podem expirar (~1 hora) — então recorra à geração do zero a partir da imagem de referência; nunca encadeie retomada-de-retomada.
  • As primeiras tentativas frequentemente deixam escapar palavras isoladas. Rejeite e tente novamente com a palavra soletrada letra por letra no prompt.

4. Meça e corrija tamanho/espessura (a passagem de composição)

Gerações geralmente vêm superdimensionadas e muito pesadas. Corrija como pixels, não regenerando cegamente:

  • Detecte a borda da página (ex.: um quadro de margem colorido: verde = G excede max(R,B) em >20; encontre linhas de borda a partir de perfis de projeção, linha mais forte mais externa por lado; permita substituição manual para bordas fracas).
  • Limpe o interior com preenchimento de papel por linha amostrado da própria página (cor mediana do papel por linha).
  • Transfira apenas tinta: construa um canal alfa a partir da escuridão e afinque os traços com uma curva de escuridão^1,35. Nunca cole um retângulo de papel+tinta — um bloco de papel colado deixa contornos fantasmas da escrita antiga e uma costura de papel visível que imprime como tinta.
  • Escalone o bloco de tinta para que sua altura mediana de linha fique LIGEIRAMENTE ABAIXO do padrão (alvo ~35 px contra um padrão de 40 px — o olho lê páginas em escala correspondente como superdimensionadas).
  • Restaure o quadro de borda original, verifique novamente a integridade da borda e imprima a altura mediana final da linha como prova.
  • Não componha páginas de tabela ou estruturas pautadas — regras longas corrompem a detecção de borda e a transferência arrasta linhas. Envie gerações de tabela limpas sem composição.

5. Avalie a cor

Meça papel e tinta na página finalizada (exclua pixels da borda da amostra de tinta) e remapeie por canal com uma transformação afim ancorada na página padrão: o papel desta página → o papel do padrão, a tinta desta página → a tinta do padrão. (Cuidado com o sinal: a tinta é mais escura que o papel, então o denominador é negativo — fixá-lo inverte a avaliação.) Verifique remensurando: papel e tinta devem cair dentro de alguns pontos RGB do padrão. Avalie cada página gerada; deixe impressões herdadas e a própria página padrão intocadas.

6. Monte e divulgue

  • Monte o PDF apenas com páginas aprovadas, em ordem, verificado o número de páginas.
  • Envie uma folha de contato de todas as páginas para que a consistência possa ser julgada de relance.
  • Divulgue as falhas conhecidas claramente (uma frase omitida, uma curva aproximada). Nunca apresente uma correção como concluída até que ela tenha passado por uma verificação visual recortada — uma sonda numérica não é um olho.

Modos de falha que esta skill existe para prevenir

  • Páginas fotocopiadas enviadas como "convertidas" (fonte fornecida ao gerador; QA apenas de texto).
  • Caligrafia limpa parecendo fonte em algumas páginas, caligrafia alvo em outras (sem padrão único; prompts apenas de texto).
  • Páginas combinando no estilo mas 20–30% maiores / mais grossas que a referência (sem medição em escala correspondente).
  • Papel branco brilhante e tinta preta dura desviando-se dos tons suaves da foto de referência (sem etapa de avaliação).
  • Letras fantasmas no fundo que imprimem como tinta (composição de bloco de papel em vez de transferência apenas de tinta).
  • Gráficos redesenhados com geometria quebrada (regenerando o que deveria ter sido herdado ou corrigido por pixel).
  • Escopo crescente: reconstruindo páginas que o usuário nunca sinalizou.

Habilidades Relacionadas