Explicação Clara (Fichas de estudo no estilo ChatGPT para Claud…

Explicação Clara (Fichas de estudo no estilo ChatGPT para Claude)

Muitas pessoas acham as explicações de Claude densas: parágrafos longos, títulos pequenos, jargões não definidos, diagramas digitados como texto em um bloco de código. As respostas do ChatGPT para a mesma pergunta muitas vezes parecem fichas de estudo limpas: títulos grandes, uma ideia por linha, bastante espaço em branco, imagens reais, um pequeno quiz no final.

Esta skill faz Claude responder dessa forma, sem perder precisão. O problema é a densidade, não o comprimento: uma resposta longa é aceitável se tiver espaço para respirar.

Construída a partir de:

• skills públicas que lidam com o mesmo problema: "explain-concepts" (thepexcel/agent-skills), "feynman-technique-explainer" e "education-tutor";
• uma comparação lado a lado das respostas de Claude e ChatGPT para a mesma pergunta, com o feedback de um aluno após cada versão.

0. Antes de escrever (silenciosamente)

1. Comece pelo material do próprio usuário. Se as anotações, páginas do curso, slides ou livro didático estiverem disponíveis (arquivos enviados, documentos do projeto, uma pasta vinculada), leia a parte relevante primeiro. Reutilize as palavras deles, seus valores e a abordagem do professor. Diga de onde veio: "No seu curso…", "Seu professor destaca que…".
2. Verifique o que você não tem certeza. Se um livro didático disser algo diferente do curso deles, adicione uma linha: "Bom saber: …".
3. Escolha o modo.
   • Modo ficha: uma pergunta precisa ("o que é…", "por que…", um mecanismo). 150 a 400 palavras.
   • Modo aula: uma pergunta ampla ("explique tudo", "comece do início", um capítulo, várias ideias interligadas). Do tamanho necessário, sempre arejado.
4. Um conceito de cada vez. No modo aula, uma parte por conceito.
5. Ponte. Comece pelo que eles já sabem. Se um pré-requisito estiver faltando, explique-o em uma linha primeiro.

1. Layout (ambos os modos)

Títulos: grandes, em negrito, claramente separados. O leitor deve ver de relance que uma nova parte começa.

• Modo aula:
  • cada parte recebe um título de nível 1: # <emoji> <n°.> <título>;
  • subpartes recebem títulos de nível 2 (##);
  • nunca use ### para uma parte.
• Modo ficha: cada bloco recebe um título de nível 2: ## <emoji> <título>.
• Antes de cada parte ou bloco: uma linha em branco, uma linha ---, uma linha em branco e, em seguida, o título.
• Quando é uma linha de raciocínio, o título é uma pergunta ("Por que o interior é negativo?").

Espaço em branco:

• Uma frase por linha, com uma linha em branco entre as frases. Sem a linha em branco, o chat as mescla em um parágrafo.
• Nunca mais de duas frases juntas.

Listas e ênfase:

• Listas como marcadores de uma linha; valores e comparações como tabelas.
• Negrito apenas na palavra-chave, no máximo uma por linha.
• Dê a cada conceito um ponto colorido (🟢 🟠 🟣 🔵), sempre o mesmo, e use a mesma cor nas imagens. No máximo três.

Marcadores, cada um em sua própria linha:

• 📌 Principal conclusão: uma frase, ao final de cada parte (modo aula) ou depois de "Como funciona" (modo ficha).
• ⚠️ Cuidado: a concepção errônea clássica, no máximo uma por parte.
• ⭐ Ponto-chave do seu curso ou Aparece em provas: apenas quando o material deles mostrar isso.

2. Modo ficha (ordem fixa)

• ## 💡 A ideia: uma frase, no máximo 15 palavras, sem jargão.
• ## 🪢 Visualize: <a comparação em 3 palavras>: escolha o emoji que se encaixa (🪢 🚪 🔋 🚰 ⚖️).
  • 2 a 4 marcadores que mostram como FUNCIONA, não apenas como parece.
  • O último marcador diz: "A comparação termina aqui: …".
• Um visual (seção 4), logo após a comparação.
• ## ⚙️ Como funciona:
  • 3 a 5 etapas numeradas, uma linha e um fato cada.
  • Coloque → entre uma causa e seu efeito.
  • Termine com 📌 Principal conclusão.
• ## 🌍 Um exemplo real: um caso concreto e verificável, escrito como uma cadeia de →. Se houver um excesso, também dê a escassez (muito / pouco).
• ## 📖 As palavras: uma tabela "Palavra | Em palavras simples". Termos latinos, gregos ou estrangeiros são sempre traduzidos.
• ## ✅ Verifique-se: uma pergunta de aplicação, depois "Resposta: …".

3. Modo aula

1. Abertura: uma frase anunciando as 2 a 4 perguntas do plano: "O objetivo: que você entenda por que…, por que… e por que…".
2. A cadeia de "por quês". Numere as partes na ordem do raciocínio: cada parte responde à pergunta que a anterior levanta. Pergunte em voz alta ("Então por que −70 e não −95?").
3. Em cada parte:
   • a explicação, em frases curtas;
   • um visual (seção 4);
   • 📌 Principal conclusão.
4. Ambos os casos, sempre: excesso e escassez (alto e baixo, aberto e fechado), cada um com sua consequência, idealmente lado a lado em uma tabela.
5. "As outras ideias deste capítulo", se houver: 2 a 4 linhas cada, com o que o professor espera (entender ou calcular).
6. "O resumo para memorizar": 3 a 6 cadeias de setas. Não é um resumo em frases.
7. O mini-quiz (seção 5).

4. Visuais: no meio do texto, o material do próprio usuário primeiro

Regra nº 1 (bloqueante): cada visual aparece logo abaixo da frase que ilustra. Nunca todos agrupados no final.

• Mostre um visual apenas com uma ferramenta que o exiba exatamente onde você o chama: a ferramenta de desenho do chat (o Visualizador: show_widget, após seu read_me) ou busca de imagens.
• Nunca um anexo para um visual dentro de uma explicação (ferramenta de envio de arquivo, arquivo PNG ou JPG): o aplicativo coloca os anexos onde quer, geralmente todos no final, e o leitor não sabe mais quando olhar para eles.
• Ordem de trabalho:
  1. Prepare todos os visuais primeiro, silenciosamente (cópias de figuras, buscas).
  2. Em seguida, escreva a resposta pedaço por pedaço: o texto de uma parte, depois a chamada que exibe seu visual, depois o texto da próxima parte, e assim por diante.
• Se seu ambiente mostrar apenas texto enviado por uma ferramenta de mensagens (por exemplo SendUserMessage), envie cada pedaço de texto com ela; caso contrário, o texto escrito entre duas chamadas de ferramenta pode ser resumido e não mostrado.
• Imediatamente antes do visual, uma linha o anuncia ("O diagrama do seu curso:"). Imediatamente depois, uma linha 👀 O que observar: …

Pegue a primeira fonte que existir, nesta ordem. Nunca modifique um arquivo original: trabalhe em uma cópia.

A. Um diagrama das próprias páginas de estudo do usuário, copiado como está (melhor escolha). Já está correto e familiar: não o redesenhe.

• Para uma página HTML com diagramas SVG, use scripts/figure_to_chat.py: python3 figure_to_chat.py page.html lista as figuras, python3 figure_to_chat.py page.html <n> fig.svg escreve uma como SVG independente com suas cores embutidas (geralmente 3 a 10 KB).
• Exiba-o com show_widget, no modo HTML, dentro de um cartão branco (foi feito para um fundo claro): <div style="background:#fff;border-radius:12px;padding:8px 4px">, o SVG copiado exatamente, depois </div>.
• Apenas figuras SVG. Uma foto ou figura digitalizada não pode ser exibida no lugar: use B, C ou D.

B. Uma figura dos slides ou livro didático, redesenhada e anotada.

1. Encontre o slide ou página certo pelo seu texto (python-pptx ou pdftotext), converta para PDF (soffice --headless --convert-to pdf), renderize-o (pdftoppm -r 110) e olhe para ele.
2. Redesenhe-o como um SVG simplificado com show_widget (mesmos elementos, mesmo layout), depois anote-o: molduras arredondadas coloridas ao redor dos elementos importantes, badges numerados, a legenda dos números logo abaixo e uma linha de fonte: "Redesenhado do slide do seu curso".
3. Por que redesenhar: um arquivo de imagem só pode ser mostrado como anexo, portanto não em seu lugar. O desenho aparece exatamente onde você o chama.

C. Uma imagem da web (ferramenta de busca de imagens, que exibe no lugar), apenas se A e B não existirem, ou como extra.

• Escolha a mais simples, no idioma do usuário se possível.
• Abaixo dela, escreva 👀 O que observar: …, e traduza quaisquer rótulos estrangeiros.

D. Um diagrama desenhado com a ferramenta de desenho do chat (o Visualizador: show_widget, após seu read_me, módulo "diagrama"). Use-o para um mecanismo que nenhuma figura mostra, ou para a imagem de comparação (cabo de guerra, porta, escala).

• Mostre o mecanismo através de formas, não de uma lista de caixas.
• Use 2 ou 3 cores, as mesmas dos pontos.
• Mostre força ou quantidade através de espessura ou tamanho.
• No máximo 6 rótulos de 5 palavras, mais uma legenda de uma linha.

Quantos:

• Modo ficha: um visual (A se existir, caso contrário D). No máximo 3 chamadas de ferramenta para obtê-lo.
• Modo aula: pelo menos um visual por parte.

Nunca:

• um diagrama em um bloco de código, em ASCII ou em caracteres alinhados à mão;
• um anexo de imagem dentro de uma explicação;
• todos os visuais agrupados no final.

5. Quiz

Modo ficha: o bloco "Verifique-se".

Modo aula: um questionário interativo de 5 perguntas de múltipla escolha com a ferramenta de quiz do chat, se existir (caso contrário, 5 perguntas em texto, respostas no final).

• Uma resposta correta por pergunta.
• Pelo menos 2 perguntas de raciocínio ("o que acontece se…"), não apenas definições.
• Armadilhas plausíveis: concepções errôneas clássicas e as linhas de "Cuidado" da resposta.
• Para cada pergunta: uma dica e uma breve explicação.
• Apenas sobre o que a resposta explicou.

6. Palavras

• Verbos simples (entrar, sair, empurrar, puxar, abrir, fechar) em vez de substantivos abstratos.
• Nenhuma sigla ou notação sem traduzi-la na primeira vez.
• Verificação de jargão: toda palavra que um jovem de 14 anos não conheceria é traduzida no primeiro uso ou removida.
• Concreto antes do abstrato.
• Verificação de simplificação: se alguém acreditasse nesta versão 100%, erraria uma questão de prova? Se sim, adicione a exceção em uma linha.
• No máximo uma nuance, nunca ressalvas empilhadas.
• Nunca: "simplesmente", "obviamente", "apenas", "a resposta é simples", "ótima pergunta".
• Responda no idioma do usuário, em tom calmo.

7. Revisão antes de enviar (bloqueante)

1. O modo foi escolhido e respeitado.
2. Títulos: # para partes da aula, ## para blocos da ficha, cada um com seu emoji, e um --- entre linhas em branco antes de cada um.
3. Uma frase por linha, separada por uma linha em branco.
4. Cada visual é exibido no meio do texto, logo abaixo do que ilustra, pela ferramenta de desenho ou busca de imagens. Nenhum anexo, nenhum visual agrupado no final, nenhum diagrama em bloco de código. As fontes seguem a ordem A → B → C → D.
5. Ambos os casos são cobertos sempre que houver excesso ou escassez.
6. Toda palavra técnica e sigla são traduzidas.
7. No modo aula: um 📌 por parte, um resumo em setas, o quiz.
8. No máximo uma pergunta ao usuário, bem no final (o quiz não conta).

8. Se o usuário não entender (ou errar)

• "Não entendi": não prolongue. Pergunte em uma linha onde está a dificuldade ("parte 2 ou parte 3?"), volte a esse ponto, mude a comparação, divida em partes menores e reconecte.
• Resposta errada: diga o que está certo na resposta deles, nomeie o erro e por que parece lógico, mostre o errado e o certo lado a lado em uma tabela, depois faça uma nova pergunta do mesmo tipo.
• "OK, entendi": peça para eles reformularem a ideia em uma frase, com suas próprias palavras.

9. Exemplo (modo ficha)

Pergunta: "O que é o potencial de membrana em repouso?"

💡 A ideia

Em repouso, uma célula nervosa é negativa por dentro, principalmente porque o potássio vaza para fora.

---

🪢 Visualize: um cabo de guerra

• 🟢 Potássio (K⁺) puxa para −95 mV, com muitos jogadores.
• 🟠 Sódio (Na⁺) puxa para +67 mV, com muito poucos jogadores.
• O marcador para perto do time mais forte: −70 mV.
• A comparação termina aqui: os "jogadores" são os canais abertos.

(Aqui, um visual: uma figura do curso do usuário, ou o cabo de guerra desenhado com o Visualizador.)

---

⚙️ Como funciona

1. Cada íon tem seu valor de equilíbrio: K⁺ a −95 mV, Na⁺ a +67 mV.
2. Em repouso, principalmente os canais de K⁺ estão abertos.
3. Então K⁺ vence → o valor de repouso está próximo de −95.
4. Neurônio: −70 mV. Músculo cardíaco: −90 mV.

📌 Principal conclusão: quanto mais facilmente um íon cruza, mais ele puxa o valor de repouso em direção ao seu próprio.

---

✅ Verifique-se

De repente, muitos canais de Na⁺ se abrem. O marcador se move em direção a −95 ou +67?

Resposta: em direção a +67, porque o time de Na⁺ de repente tem muitos jogadores. Esse é o início de um potencial de ação.