Communitygithub.com

Desnarrar

Remove auto-narrativa meta-comentário — texto que descreve o artefato em que vive, reafirma o que o leitor já vê ou narra o processo que o produziu — de textos de UI, documentação, comentários de código, mensagens de commit e descrições de PR. Aplique ao escrever ou revisar essas superfícies e antes de "descapar" ao editar prosa.

O que é Desnarrar?

Este skill, chamado "Desnarrar", é um complemento direto ao conceito de "descapar" (unslop) — enquanto o unslop melhora o som da prosa gerada por IA, o Desnarrar elimina texto que não deveria existir: metadiscursos que descrevem o próprio artefato, reafirmam o que o leitor já vê ou narram o processo de criação. Agentes de IA produzem esse tipo de conteúdo constantemente ao injetar sua cadeia de pensamento em cada superfície que tocam. O skill define três categorias de corte — descrição do artefato, redundância visual e narração de processo — e oferece dois testes mentais simples (deleção mental e portabilidade) para decidir casos ambíguos. Ele cobre cinco superfícies principais: textos de UI, documentação/READMEs, comentários de código, mensagens de commit e descrições de PR, com exemplos específicos para cada uma. Também orienta o que manter (narração ao vivo durante streaming, comentários de motivo, instruções com informações implícitas, TODOs com link de rastreamento) e sugere uma ordem de aplicação: primeiro varrer e deletar os padrões, depois consertar o artefato se a deleção criar uma lacuna real e, por fim, rodar o unslop no que sobreviveu. É compatível com qualquer plataforma que use edição de texto — interfaces web, documentação, código — e referência um arquivo `reference/terminology.md` para nomenclatura e fontes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/T0mSIlver/skills/tree/HEAD/unnarrate

Perguntar na sua IA favorita

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

Documentação

O que Desnarrar faz?

Companheiro do descapar (unslop). Descapar corrige o som da prosa de IA; este apaga texto que não deveria existir: metadiscurso — escrita que narra o artefato para seu próprio público. Uma barra de progresso já anuncia progresso; "progresso é mostrado enquanto é executado" ao lado dela é um segundo significante redundante. Agentes produzem isso constantemente porque narram sua cadeia de pensamento em cada superfície que tocam.

O teste da deleção

Apague qualquer frase, rótulo ou comentário cujo único conteúdo seja:

  1. uma descrição do artefato em que vive ("Esta seção descreve..."),
  2. algo que o leitor já pode ver (um tooltip reafirmando o rótulo, um comentário reafirmando a próxima linha), ou
  3. o processo que o produziu (// Conforme solicitado, extraído para um helper).

Duas verificações decidem casos ambíguos:

  • Apague mentalmente. Se o leitor não perder nada, era uma não-operação — texto que parece fazer algo mas não muda nada.
  • Portabilidade. Se a linha pudesse aparecer inalterada em outro projeto, outro PR, ou acima de código diferente, ela não diz nada sobre este. Corte-a.

O que cortar, por superfície

Cópia de UI

  • Cópia descrevendo comportamento que a interface já executa: "Progresso é mostrado enquanto instala", "Um spinner aparece enquanto carrega", "A lista atualiza automaticamente". O widget é o significante; não adicione um verbal.
  • Texto "Carregando..." ao lado de um spinner visível; "Arquivo enviado com sucesso" → "Arquivo enviado".
  • Tooltips e texto de ajuda reafirmando o rótulo: campo "Cidade de nascimento", dica "Insira a cidade do seu nascimento".
  • Narração posicional: "Clique no botão abaixo para enviar", "Selecione uma opção do menu suspenso".
  • Cópia de onboarding/coach-mark que inventaria cada controle em vez de apontar para a única ação não óbvia.
  • Duplicatas de acessibilidade: aria-label="Botão de enviar" em um <button>, alt="Imagem de um gráfico" (leitores de tela já anunciam a função).

Documentação e READMEs

  • "Este documento descreve...", "Neste guia, vamos...", "Bem-vindo à documentação de X". Comece com o conteúdo.
  • Seções de visão geral que apenas anunciam as seções que seguem; parágrafos finais "Em resumo" reafirmando a página.
  • Docstrings reafirmando a assinatura (get_user(id) — "Obtém o usuário pelo id"); <summary>Obtém ou define o X</summary>. PEP 257 bane exatamente isso.
  • "O exemplo a seguir mostra como..." acima de um exemplo; prosa reafirmando o bloco de código adjacente.
  • Marcadores de funcionalidades e introduções de seção que seriam verdadeiros para qualquer projeto.

Comentários de código

  • Reafirmando a próxima linha: // Importar React, // Retornar o valor, // Percorrer os itens.
  • Banners de seção: // ===== HELPERS =====, // --- Etapa 3: Validar ---.
  • Narração de plano e fase: // Fase 2: refatorar, // Usando o modelo Foo recém-criado.
  • Narração de changelog: // Alterado de useState para useReducer, `// Removido o handler antigo". O histórico do Git mantém isso.
  • Comentários endereçados ao revisor em vez do leitor futuro: // Nota: Mantive este comportamento intacto.

Commits e PRs

  • Listas de marcadores reafirmando o diff arquivo por arquivo; "Este PR adiciona..." seguido do título literalmente.
  • Seções de modelo preenchidas com reafirmação; "Plano de teste: executou os testes" sem especificidades.
  • Narração de esforço: "Refatoração abrangente", "Compatibilidade com versões anteriores preservada cuidadosamente". Declare fatos que um revisor possa verificar.

Manter — nem tudo que narra é uma não-operação

  • Narração ao vivo é um significante; narração estática é o sinal. Um agente transmitindo "Instalando dependências…" enquanto trabalha é feedback real. Cópia descrevendo que esse feedback existe é o anti-padrão.
  • Comentários de "porquê" permanecem: justificativa, invariantes, avisos sobre comportamento não óbvio, links para issues e incidentes. A regra apaga reafirmação, não comentários — combine com a densidade de comentários do código ao redor.
  • Instruções carregando informações que a superfície não pode mostrar permanecem: formatos ("AAAA-MM-DD"), restrições ("8+ caracteres"), efeitos colaterais ("isto envia e-mail para a equipe"), avisos de irreversibilidade.
  • Texto alternativo real permanece. Apague o prefixo "Imagem de...", mantenha a descrição do que a imagem mostra.
  • TODOs com link de rastreamento permanecem; // TODO: melhorar isto simples vai.

Aplicando

  1. Varra as superfícies alteradas em busca dos padrões acima. Apague, não reescreva — a maioria dos acertos não precisa de substituição.
  2. Quando a deleção deixar uma lacuna real, corrija o artefato (rótulo mais claro, controle autoexplicativo), não a narração.
  3. Então execute o descapar no que sobreviveu.

reference/terminology.md nomeia o fenômeno por comunidade (metadiscurso, happy talk, comentários óbvios, não-operações) com fontes, para citar ou estender a lista de verificação.

Habilidades Relacionadas