Faça o Claude mostrar, não discursar

Você pediu pra entender, não pra ler

Você faz uma pergunta sobre um trecho de código, uma arquitetura, um fluxo que não fecha na sua cabeça. A resposta vem em três parágrafos densos, com um quarto de reforço, e você relê duas vezes pra montar o desenho que a explicação descreve mas não mostra. No fim você entendeu, mas gastou mais tempo decifrando a resposta do que teria gasto olhando um diagrama.

O problema não é o agente saber menos. É que ele conta quando devia mostrar. Uma árvore de chamadas, um diff, três caixas com setas: muita coisa que vira meia tela de prosa caberia num desenho que você lê de um golpe.

O que muda

Isto ensina o seu agente a escolher a forma visual antes de despejar texto. Quando a pergunta é sobre estrutura, ele responde com uma árvore de arquivos. Quando é sobre o que muda, com um diff. Quando é sobre fluxo entre partes, com um diagrama. Quando o assunto é denso demais pra caber num diagrama, ele monta um HTML focado e abre pra você. E acompanha cada visual de uma linha curta de texto, no lugar de um muro.

O ganho aparece de dois jeitos. Ao entender: você pede algo complexo e recebe a imagem que a explicação só descrevia. E ao comunicar: você manda o agente fazer uma tarefa e pede pra ele fechar mostrando o que fez em forma, não em ata. A regra que guia tudo é a mesma: a menor peça visual que deixa o ponto claro, e nada além dela.

O que vem no pacote

• A skill show-me, completa: a peça que o agente lê, fixada nesta versão pra não mudar embaixo de você.
• Um guia em português que instala em qualquer agente que roda skills e mostra como pedir a resposta visual, com exemplos.
• A licença original (MIT) do autor, junto.

O que ele NÃO faz

• Não é um app nem um gerador de imagem. Ele roda dentro do seu agente de IA (Claude Code, Codex, Cursor, ou o Claude no navegador com skills) e trabalha com o que texto e código já permitem: pseudocódigo, árvores, Mermaid, diff e um arquivo HTML quando o assunto pede. Sem um agente desses, não há onde rodar.
• Não desenha sozinho o tempo todo: é uma orientação de quando e como mostrar, e o agente ainda decide caso a caso. Em pergunta simples, a resposta em texto continua sendo a certa, e é isso que a skill manda fazer.
• O HTML focado abre no seu navegador por um comando local. Precisa de um ambiente onde o agente possa rodar comando e abrir arquivo (no Claude do navegador, com a execução de código ligada).
• Não muda o modelo nem melhora o raciocínio: muda a forma da resposta, não o que o agente sabe.

Pra quem é

Pra você que está aprendendo e entende três vezes mais rápido quando o conceito complexo vira um desenho em vez de um parágrafo. Pra você que programa há anos e quer o sinal direto, a árvore de chamadas ou o diff, sem a camada de prosa em volta. E pra você que já entrega com IA e quer que o próprio agente feche cada tarefa mostrando o que fez, numa forma que você e o time leem de um golpe.

Não é pra quem quer um gerador de arte ou de imagem: aqui o visual é diagrama, código e estrutura, a serviço de entender. E não é pra quem não roda um agente de IA que aceite skills.

De onde vem

A skill é open source, feita pela HumanLayer sob licença MIT. Você recebe uma cópia fixada da versão, com a licença junto. A comunidade empacotou e traduziu o guia de instalação para o português. É de graça porque a base já é aberta: o trabalho de reunir, traduzir e testar fica de cortesia, como porta de entrada.