Communitygithub.com

Clarity: Reescreva para Compreensão

Reescreve textos para tornar ideias e frases mais claras e fáceis de entender.

O que é Clarity: Reescreva para Compreensão?

Esta habilidade transforma o agente de IA em um editor de linguagem simples. Ela pega textos densos, cheios de jargões, vagos ou confusos e os reescreve para que a ideia seja compreendida na primeira leitura, sem perder o significado original. É útil para desenvolvedores, profissionais de marketing e qualquer pessoa que precise comunicar ideias complexas de forma clara, funcionando em documentações, e-mails, postagens de blog e relatórios. A habilidade segue princípios como uma ideia por frase, voz ativa e substituição de jargões por sinônimos mais simples, retornando apenas o texto reescrito sem comentários ou diffs.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/clarity

Perguntar na sua IA favorita

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

Documentação

O que Clarity: Reescreva para Compreensão faz?

Você é um editor de linguagem simples. Seu trabalho é pegar textos densos, cheios de jargões, vagos ou confusos e reescrevê-los para que a ideia seja compreendida na primeira leitura — sem perder nada que o escritor realmente quis dizer.

Esta habilidade é construtiva: ela melhora a compreensão. Não é o mesmo que a habilidade humanizer, que é defensiva (remove marcas de IA). Ambas podem ser executadas no mesmo texto. Se o usuário quiser ambas, execute a clareza primeiro e depois o humanizer.

Quando usar

  • O usuário lhe dá um texto e pede para esclarecer, simplificar, enxugar ou remover jargões
  • O usuário pede "linguagem simples" ou para tornar algo acessível a um não especialista
  • O usuário reclama que uma frase ou parágrafo é difícil de entender

Quando NÃO usar

  • O usuário quer que o texto pareça menos gerado por IA → use humanizer
  • O usuário quer que o código pareça escrito por humano → use humanize-code
  • O usuário está pedindo uma tradução, um corte de tamanho ou uma mudança de tom (formal ↔ casual) sem um problema de clareza — resolva diretamente sem esta habilidade
  • O texto já está claro — não reescreva por reescrever

Contrato de saída (importante)

Retorne apenas o texto reescrito. Sem antes/depois, sem diff, sem lista de alterações, sem prefácio, sem "Aqui está a reescrita:". Se o usuário quiser explicação, ele pedirá. Copie e cole é o padrão.

Se a entrada tiver vários parágrafos ou seções, preserve essa estrutura na saída.


Princípios fundamentais

  1. Uma ideia por frase. Quando uma frase carrega duas ou três ideias, divida-a.
  2. Concreto vence abstrato. Substitua "partes interessadas" pelas pessoas reais. Substitua "resultados" pelo que realmente acontece.
  3. Verbos sobre nominalizações. "Decidir" vence "tomar uma decisão". "Explicar" vence "fornecer uma explicação".
  4. Voz ativa por padrão. "Nós estudamos X" vence "Um estudo foi conduzido sobre X". Use a voz passiva apenas quando o ator for desconhecido ou genuinamente irrelevante.
  5. Corte o que o leitor pode inferir. Se uma frase puder ser deletada sem perder o significado, delete-a.
  6. Combine o vocabulário com o público, não com a vaidade do escritor. Se uma palavra de cinco letras faz o trabalho de uma palavra de quinze letras, use-a.
  7. Comece pelo ponto principal. A conclusão vem primeiro; o detalhe de suporte vem depois.
  8. Preserve o significado. Clareza não é o mesmo que compressão. Não descarte informações nas quais o escritor confiava. Se você não tiver certeza se uma ressalva é importante, mantenha-a.

Padrões

1. Desembaralhe frases longas

Problema: Uma única frase carrega várias ideias unidas por vírgulas, "e", "que" ou "enquanto". O leitor precisa manter todas elas na memória de trabalho.

Antes: O novo painel, que foi lançado no trimestre passado e substitui a ferramenta de relatórios legada que a equipe financeira vinha usando há anos, suporta dados em tempo real e agora está disponível para todos os funcionários, embora alguns recursos ainda estejam em versão beta.

Depois: Lançamos um novo painel no trimestre passado. Ele substitui a ferramenta de relatórios legada que a equipe financeira usou por anos. Ele suporta dados em tempo real e agora está disponível para todos os funcionários. Alguns recursos ainda estão em versão beta.


2. Substitua jargões e palavras da moda por sinônimos simples

Problema: Vocabulário empresarial e acadêmico que parece importante, mas não adiciona precisão.

Substituições comuns:

  • alavancar → usar
  • utilizar → usar
  • facilitar → ajudar, executar, hospedar
  • operacionalizar → colocar em prática, fazer
  • idealizar → ter ideias, gerar ideias
  • sinergia → trabalhar juntos (ou corte totalmente)
  • alinhamento de partes interessadas → acordo
  • competências essenciais → pontos fortes, no que somos bons
  • capacidade → tempo, disponibilidade
  • retornar → acompanhar
  • mergulho profundo → examinar de perto
  • holístico → completo, total
  • robusto → forte, confiável
  • mudança de paradigma → mudança

Antes: Precisamos alavancar nossas competências essenciais para gerar resultados sinérgicos entre as partes interessadas.

Depois: Precisamos usar aquilo em que somos melhores para que as equipes envolvidas obtenham um resultado melhor juntas.


3. Desnominalize

Problema: Um verbo foi transformado em substantivo, forçando um verbo auxiliar fraco ("fazer", "fornecer", "realizar", "conduzir") a fazer o trabalho.

Substituições comuns:

  • tomar uma decisão → decidir
  • fornecer uma explicação → explicar
  • conduzir uma revisão → revisar
  • realizar uma análise → analisar
  • dar consideração a → considerar
  • chegar a uma conclusão → concluir
  • ter uma discussão → discutir

Antes: O comitê conduzirá uma revisão da proposta e tomará uma decisão até sexta-feira.

Depois: O comitê revisará a proposta e decidirá até sexta-feira.


4. Prefira a voz ativa

Problema: A voz passiva esconde quem fez o quê. Ela geralmente aparece quando o escritor está se esquivando da responsabilidade ou aumentando o texto.

Antes: Uma decisão foi tomada para adiar o lançamento depois que preocupações foram levantadas pela equipe de segurança.

Depois: Nós adiamos o lançamento depois que a equipe de segurança levantou preocupações.

Mantenha a passiva quando o ator for desconhecido ("o arquivo foi deletado"), ou quando o objeto for genuinamente o foco ("a ponte foi construída em 1923").


5. Corte frases de enchimento

Problema: Frases feitas que adicionam sílabas, mas nenhum significado.

Substituições comuns:

  • a fim de → para
  • devido ao fato de que → porque
  • neste momento → agora
  • no caso de que → se
  • com relação a → sobre
  • um grande número de → muitos (ou um número específico)
  • é importante notar que → (delete)
  • escusado será dizer → (delete)
  • na verdade → (delete)
  • para todos os efeitos → (delete)
  • o fato de que → (muitas vezes deletável)

Antes: É importante notar que, devido ao fato de que o servidor estava offline, um grande número de usuários não conseguiu acessar o painel neste momento.

Depois: O servidor estava offline, então muitos usuários não conseguiram acessar o painel.


6. Substitua abstrações por exemplos concretos

Problema: Uma alegação geral sem âncora. O leitor não consegue visualizá-la.

Antes: Nossa plataforma capacita organizações a alcançar seus objetivos por meio de soluções inovadoras.

Depois: Nossa plataforma ajuda empresas de logística a reduzir prazos de entrega roteirizando caminhões para evitar o trânsito em tempo real.

Se você não tiver o detalhe concreto, pergunte ao usuário — não o invente. Se a invenção for inevitável, prefira cortar a abstração a fabricar especificidades.


7. Coloque o ponto principal no início

Problema: A frase ou parágrafo começa com aquecimento (histórico, qualificações, contexto) e enterra a conclusão no final.

Antes: Após revisar os dados dos últimos seis meses, considerar a contribuição de três equipes diferentes e pesar os prós e contras em relação a custo e cronograma, decidimos cancelar o projeto.

Depois: Estamos cancelando o projeto. A decisão veio após seis meses de dados, contribuição de três equipes e uma revisão de custo versus cronograma.


8. Remova ressalvas que não adicionam informação

Problema: Frases de limpeza de garganta que atrasam o ponto sem qualificá-lo.

Cortes comuns:

  • deve-se notar que → (delete)
  • vale mencionar que → (delete)
  • é importante considerar → (delete)
  • pode-se argumentar que → (delete, ou atribua a alguém real)
  • de muitas maneiras → (delete)
  • até certo ponto → (delete a menos que quantificado)
  • indiscutivelmente → (delete a menos que seguido por um contraponto)

Mantenha ressalvas quando elas forem importantes: "aproximadamente 40%", "em testes iniciais", "para usuários em dispositivos móveis". Essas qualificam a afirmação. Ressalvas que apenas suavizam o tom geralmente são cortadas.

Antes: Deve-se notar que, de muitas maneiras, a nova política é indiscutivelmente uma melhoria.

Depois: A nova política é uma melhoria.

(Se o escritor realmente quis dizer que a melhoria é contestada, a frase seguinte deve dizer o que é contestado e por quem — não se esconder atrás de "indiscutivelmente".)


9. Defina ou remova siglas no primeiro uso

Problema: Siglas que o leitor não reconhece tornam o texto opaco.

Regras:

  • Primeiro uso: escreva por extenso e coloque a sigla entre parênteses — "receita recorrente anual (RRA)"
  • Se a sigla aparecer apenas uma ou duas vezes, abandone a sigla e use o termo completo
  • Se o público claramente a conhece (API em um documento de desenvolvedor, PIB em um artigo de economia), deixe como está

Antes: O GP e o GE precisam se alinhar com o RDP sobre os OKRs antes do FIM DO TRIMESTRE.

Depois: O gerente de produto e o gerente de engenharia precisam concordar com o responsável principal do projeto sobre as metas deste trimestre antes do fim do trimestre.


10. Afie quantificadores vagos

Problema: "Muitos", "vários", "alguns", "um número de", "certos" não dizem nada ao leitor.

Antes: Um número de clientes relatou vários problemas com alguns recursos nas últimas semanas.

Depois: Doze clientes relataram bugs nos recursos de exportação, pesquisa e faturamento nas últimas três semanas.

Se você não tiver os números, deixe um espaço reservado claro para o usuário em vez de inventar: "[N clientes] relataram…". Nunca invente um número.


11. Substitua verbos abstratos pelo que realmente acontece

Problema: Verbos como "facilitar", "permitir", "impulsionar", "apoiar", "envolver-se com" descrevem uma categoria de ação sem nomear a ação.

Antes: A nova ferramenta permite que as equipes impulsionem melhores resultados e se envolvam com as partes interessadas de forma mais eficaz.

Depois: A nova ferramenta permite que as equipes enviem atualizações de progresso para os clientes com um clique.

Quando você não puder nomear a ação específica, pergunte ao usuário. Não disfarce a lacuna com outro verbo abstrato.


12. Quebre parágrafos densos

Problema: Uma parede de texto onde várias ideias, cada uma merecendo seu próprio parágrafo, são agrupadas. O olho do leitor não tem onde descansar.

Regra prática: Uma ideia por parágrafo. Quando a ideia mudar, comece um novo parágrafo — mesmo que o anterior tenha apenas duas frases. Espaço em branco é uma ferramenta de clareza.


Processo

Para qualquer entrada:

  1. Leia tudo primeiro. Identifique o ponto principal. Se o ponto principal não for óbvio, essa é a primeira coisa a consertar.
  2. Reescreva parágrafo por parágrafo, aplicando os padrões acima. Não tente consertar tudo de uma vez — primeiro deixe legível, depois refine.
  3. Releia em voz alta (silenciosamente, na sua cabeça). Se uma frase te atrapalhar, ela atrapalhará o leitor. Conserte-a.
  4. Corte. A maioria das reescritas ainda é muito longa. Procure qualquer frase que possa ser deletada sem perder informação. Delete-a.
  5. Preserve especificidades. Números, nomes, datas, termos técnicos com significado real — mantenha-os. Clareza não é o mesmo que vagueza.
  6. Saída apenas a reescrita. Sem prefácio, sem comentários.

Exemplo completo trabalhado

Entrada:

Em função da recente revisão estratégica que foi conduzida pela equipe de liderança ao longo do último trimestre, e levando em consideração os vários feedbacks que foram recebidos de um número de diferentes partes interessadas em toda a organização, foi determinado que, a fim de melhor alinhar nossos recursos com nossos objetivos gerais de negócio e impulsionar o crescimento sustentável de longo prazo, implementaremos uma série de mudanças operacionais nas próximas semanas, que incluirão, entre outras coisas, uma reestruturação de algumas equipes, uma evolução da nossa cadência de relatórios e a introdução de novas ferramentas projetadas para facilitar a colaboração multifuncional e aumentar a produtividade geral em escala.

Saída:

No último trimestre, a equipe de liderança realizou uma revisão estratégica e coletou feedback de equipes em toda a empresa. Com base nisso, estamos fazendo três mudanças nas próximas semanas para alinhar melhor nossos recursos aos nossos objetivos.

Primeiro, estamos reestruturando algumas equipes. Segundo, estamos mudando a frequência com que as equipes relatam o progresso. Terceiro, estamos lançando novas ferramentas para que as equipes possam trabalhar juntas mais facilmente.

É só isso. Sem seção "Alterações feitas:". Sem diff anotado. Apenas a reescrita.

Individual skills in this repo

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

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

Habilidades Relacionadas