CommunityEscrita e Ediçãogithub.com

n0ctx/escrita-primeiro-o-leitor

Use ao escrever ou revisar qualquer texto que um ser humano lerá (artigos, e-mails, avisos, explicações, relatórios, textos de marketing, posts em redes sociais, respostas em chat) ou ao revisar tal texto. Abrange legibilidade em nível de frase em qualquer idioma; não inclui layout, nem 'humanizar' texto para passar por detectores de IA.

O que é escrita-primeiro-o-leitor?

Esta skill foca em escrever para um leitor humano, garantindo que cada frase seja fácil de entender, corrigindo tendências comuns da prosa de LLM que transferem o trabalho de decodificação para o leitor. Ela se baseia em sete princípios: reservar ações humanas para humanos, manter sujeito e verbo próximos, manter palavras que ajudam na previsão, não empilhar mais de dois substantivos, usar verbos que já existem, usar frases que o leitor já viu e dar peso ao que importa. A skill não é um 'humanizador de IA' – seu objetivo é a legibilidade, não passar por detectores. Ela é útil para qualquer tipo de texto para leitores humanos (artigos, e-mails, postagens em redes sociais) e suporta revisão parágrafo por parágrafo, aplicando um teste subjacente: se a mesma ideia pode ser expressa de forma mais simples sem perda de significado, a versão mais simples deve ser usada. Funciona em qualquer idioma e prioriza guias de estilo existentes do usuário ou do projeto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/n0ctx/skills/tree/HEAD/skills/reader-first-writing

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Escrita Primeiro o Leitor

Você está escrevendo para um leitor humano. O leitor não tem nenhum do seu contexto e segura cada frase na memória de trabalho enquanto a lê. Toda vez que uma frase o faz olhar para trás para encontrar o sujeito, desembaralhar uma sequência de substantivos ou inferir uma conexão que você omitiu, fica mais difícil de entender. A prosa de LLM tem algumas tendências habituais que caem exatamente aí: coisas inanimadas realizando ações humanas, longos intervalos entre sujeito e verbo, palavras opcionais omitidas, substantivos empilhados e verbos e frases inventados. Nada disso perde informação; ele transfere o trabalho de decodificação para o leitor. Corrija essas tendências enquanto você escreve e revisa.

Isso não é um "humanizador de IA". Essas ferramentas mudam a redação superficial para passar por detectores; esta skill se preocupa apenas se o leitor entende. Adicionar irregularidades deliberadas ou palavras de preenchimento para soar mais humano não é o objetivo.

Escopo

Qualquer texto destinado a leitores humanos, em qualquer gênero ou idioma, incluindo revisões de texto escrito por outras pessoas ou outros modelos. Não se aplica a código, prompts escritos para IA ou reescrita puramente para passar na detecção de IA. Um guia de estilo que o usuário ou projeto já tenha tem precedência; esta skill cobre apenas a legibilidade em nível de frase.

O teste subjacente

Entender uma frase custa esforço ao leitor, e esse esforço tem que comprar algo. Se o mesmo significado tem uma redação mais simples e você escolheu a mais difícil, o esforço do leitor é desperdiçado: mude-a. Se uma redação entrega algo que a versão simples não pode, como um ritmo memorável, uma imagem precisa ou um termo técnico necessário, então não significa a mesma coisa, e pode ficar, desde que você possa nomear o que ela compra.

Os sete princípios abaixo são onde a prosa de LLM mais frequentemente falha neste teste.

Princípios

  1. Reserve ações humanas para humanos. Quando o sujeito é um objeto, conceito ou processo, dê a ele um verbo que ele possa realmente realizar. "A reforma está silenciosamente corroendo a paciência dos usuários antigos" → "Desde a reforma, muitos usuários antigos acham o produto mais difícil de usar." Sujeitos inanimados comuns são bons: "As vendas subiram 20% ano contra ano", "A nova regra entra em vigor no mês que vem." O que consertar é a personificação casual, coisas que comem, mordem, empurram, esperam ou falam, porque o leitor tem que traduzir a metáfora de volta para o que realmente aconteceu.

  2. Mantenha sujeito e verbo próximos. Uma cláusula longa inserida entre sujeito e verbo força o leitor a manter o sujeito na mente até o verbo chegar; divida a frase. Em línguas que colocam modificadores antes do substantivo, como o chinês, o problema usual é uma longa cadeia de modificadores antes do substantivo, então o leitor não descobre sobre o que é a frase até o final; quando um modificador é mais longo que uma frase, transforme-o em sua própria frase curta ou mova-o para depois do substantivo.

  3. Mantenha as palavras que ajudam os leitores a prever. Mantenha conectivos (porque, então, mas, também), sujeitos que seu idioma permitiria omitir e referências explícitas ("este pagamento" em vez de um "isso" ambíguo). Omiti-los economiza algumas palavras, mas faz o leitor inferir como as frases se relacionam. Em português, mantenha o "que" opcional em orações relativas. Isso não significa adicionar palavras de preenchimento como "na verdade" ou "basicamente"; palavras de preenchimento não ajudam o leitor a acompanhar como as frases se conectam.

  4. Não empilhe mais de dois substantivos. "Processo de avaliação de risco de segurança de conta de usuário" → "o processo para avaliar riscos de segurança em contas de usuário." Quebre uma sequência de substantivos com uma preposição, um possessivo ou um verbo.

  5. Use verbos que já existem. Não transforme substantivos em verbos na hora ("calendarizar" → "colocar no calendário"). Evite jargões verbais como "alinhar", "alavancar", "operacionalizar", "acionar" e seus equivalentes em outros idiomas; nomeie a ação real em vez disso: confirmar o quê com quem, anotar o quê.

  6. Use frases que os leitores já viram antes. Não invente frases como "orçamento de paciência do leitor" ou "fosso de densidade de informação." Se um conceito realmente precisar de um novo termo, explique-o em uma frase na primeira vez que aparecer.

  7. Dê peso ao que importa. Comece com o que o leitor mais precisa saber e reduza ou corte o material secundário. Quando cada ponto recebe o mesmo espaço, o leitor não consegue dizer qual é o mais importante. Estruturas paralelas, antíteses e sequências de adjetivos ou advérbios que não acrescentam informação fazem o leitor extrair o conteúdo da retórica: delete-as.

Revisando

Revise parágrafo por parágrafo, não a partir de uma impressão geral. Para cada frase que é difícil de ler, tente reafirmar o mesmo significado com as palavras mais simples que puder. Se conseguir e nada for perdido, use a versão simples. Se não conseguir, o conteúdo em si é complexo: mantenha o significado e ajude o leitor dividindo a frase e adicionando conectivos. A revisão muda como as coisas são ditas, não o que é afirmado: não adicione nenhum fato que o original não contenha.

Um exemplo da direção e tamanho de uma revisão:

Antes: Este lançamento capacita de forma abrangente uma experiência de sincronização de dados do usuário atualizada, resolvendo sistematicamente o ponto de dor de perda de conteúdo entre dispositivos, e daqui para frente continuaremos a consolidar o feedback do usuário e alinhar direções de otimização.

Depois: Esta atualização melhora a sincronização de dados e corrige o bug que perdia conteúdo ao alternar entre dispositivos. Continuaremos coletando feedback e o usaremos para decidir o que melhorar em seguida.

A revisão elimina "capacita", "consolidar" e "alinhar"; quebra as pilhas de substantivos "experiência de sincronização de dados do usuário" e "ponto de dor de perda de conteúdo entre dispositivos"; substitui o ator abstrato "este lançamento capacita" por "esta atualização" e "nós"; e divide uma frase longa para que cada frase diga uma coisa.

Antes de entregar

Percorra o texto parágrafo por parágrafo. Para cada "sim" abaixo, aplique o teste subjacente para decidir se deve mudá-lo:

  • Um objeto ou conceito está realizando uma ação humana?
  • Há um modificador com mais de uma frase antes de um substantivo, ou uma cláusula longa entre sujeito e verbo?
  • Um conectivo, sujeito ou referência foi omitido?
  • Três ou mais substantivos estão empilhados?
  • Há um substantivo usado como verbo, um verbo jargão ou uma frase inventada que o leitor não viu antes?
  • O que o leitor mais precisa saber está perto do início?
  • Há paralelismo, antítese ou uma sequência de modificadores que não adiciona informação?

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas