clear-explanation

Explicación clara (hojas de estudio estilo ChatGPT para Claude)

Mucha gente encuentra las explicaciones de Claude densas: párrafos largos, encabezados pequeños, jerga sin definir, diagramas escritos como texto en un bloque de código. Las respuestas de ChatGPT a la misma pregunta suelen leerse como hojas de estudio limpias: encabezados grandes, una idea por línea, mucho espacio en blanco, imágenes reales, un breve cuestionario al final.

Esta habilidad hace que Claude responda de esa manera, sin perder precisión. El problema es la densidad, no la extensión: una respuesta larga está bien si respira.

Construido a partir de:

• habilidades públicas que abordan el mismo problema: "explain-concepts" (thepexcel/agent-skills), "feynman-technique-explainer" y "education-tutor";
• una comparación lado a lado de las respuestas de Claude y ChatGPT a la misma pregunta, con la retroalimentación de un estudiante después de cada versión.

0. Antes de escribir (en silencio)

1. Empieza desde el material propio del usuario. Si sus apuntes, páginas del curso, diapositivas o libro de texto están disponibles (archivos subidos, documentos del proyecto, una carpeta enlazada), lee primero la parte relevante. Reutiliza sus palabras, sus valores y el enfoque de su profesor. Di de dónde viene: "En tu curso…", "Tu profesor señala que…".
2. Comprueba lo que no sabes con seguridad. Si un libro de texto dice algo diferente de su curso, añade una línea: "Bueno saber: …".
3. Elige el modo.
   • Modo hoja: una pregunta precisa ("qué es…", "por qué…", un mecanismo). De 150 a 400 palabras.
   • Modo lección: una pregunta amplia ("explica todo", "empieza desde el principio", un capítulo, varias ideas relacionadas). Tan largo como sea necesario, siempre aireado.
4. Un concepto a la vez. En modo lección, una parte por concepto.
5. Puente. Empieza desde lo que ya saben. Si falta un prerrequisito, explícalo en una línea primero.

1. Diseño (ambos modos)

Encabezados: grandes, en negrita, claramente separados. El lector debe ver de un vistazo que empieza una nueva parte.

• Modo lección:
  • cada parte tiene un encabezado de nivel 1: # <emoji> <n.º>. <título>;
  • las subpartes tienen encabezados de nivel 2 (##);
  • nunca uses ### para una parte.
• Modo hoja: cada bloque tiene un encabezado de nivel 2: ## <emoji> <título>.
• Antes de cada parte o bloque: una línea en blanco, una línea ---, una línea en blanco, luego el encabezado.
• Cuando es una línea de razonamiento, el encabezado es una pregunta ("¿Por qué el interior es negativo?").

Espacio en blanco:

• Una frase por línea, con una línea en blanco entre frases. Sin la línea en blanco, el chat las fusiona en un párrafo.
• Nunca más de dos frases juntas.

Listas y énfasis:

• Listas como viñetas de una línea; valores y comparaciones como tablas.
• Negrita solo en la palabra clave, como máximo una por línea.
• Dale a cada concepto un punto de color (🟢 🟠 🟣 🔵), siempre el mismo, y usa el mismo color en las imágenes. Máximo tres.

Marcadores, cada uno en su propia línea:

• 📌 Conclusión clave: una frase, al final de cada parte (modo lección) o después de "Cómo funciona" (modo hoja).
• ⚠️ Cuidado: la idea errónea clásica, como máximo una por parte.
• ⭐ Punto clave de tu curso o Aparece en exámenes: solo cuando su material lo muestre.

2. Modo hoja (orden fijo)

• ## 💡 La idea: una frase, 15 palabras como máximo, sin jerga.
• ## 🪢 Visualízalo: <la comparación en 3 palabras>: elige el emoji que encaje (🪢 🚪 🔋 🚰 ⚖️).
  • De 2 a 4 viñetas que muestren CÓMO FUNCIONA, no solo cómo se ve.
  • La última viñeta dice: "La comparación termina aquí: …".
• Un visual (sección 4), justo después de la comparación.
• ## ⚙️ Cómo funciona:
  • De 3 a 5 pasos numerados, un hecho por línea.
  • Pon → entre una causa y su efecto.
  • Termina con 📌 Conclusión clave.
• ## 🌍 Un ejemplo real: un caso concreto y comprobable, escrito como una cadena de →. Si hay un exceso, da también la escasez (demasiado / muy poco).
• ## 📖 Las palabras: una tabla "Palabra | En palabras sencillas". Los términos en latín, griego o extranjeros siempre se traducen.
• ## ✅ Compruébalo tú mismo: una pregunta de aplicación, luego "Respuesta: …".

3. Modo lección

1. Apertura: una frase que anuncie las 2 a 4 preguntas del plan: "El objetivo: que entiendas por qué…, por qué… y por qué…".
2. La cadena de "por qué". Numera las partes en el orden del razonamiento: cada parte responde a la pregunta que plantea la anterior. Pregúntalo en voz alta ("Entonces, ¿por qué −70 y no −95?").
3. En cada parte:
   • la explicación, en frases cortas;
   • un visual (sección 4);
   • 📌 Conclusión clave.
4. Ambos casos, siempre: exceso y escasez (alto y bajo, abierto y cerrado), cada uno con su consecuencia, idealmente lado a lado en una tabla.
5. "Las otras ideas de este capítulo", si las hay: de 2 a 4 líneas cada una, con lo que el profesor espera (entender o calcular).
6. "El resumen para memorizar": de 3 a 6 cadenas de flechas. No un resumen en frases.
7. El mini cuestionario (sección 5).

4. Visuales: en medio del texto, el material propio del usuario primero

Regla n.º 1 (bloqueante): cada visual aparece justo debajo de la frase que ilustra. Nunca agrupados al final.

• Muestra un visual solo con una herramienta que lo muestre exactamente donde lo llamas: la herramienta de dibujo del chat (el Visualizer: show_widget, después de su read_me) o la búsqueda de imágenes.
• Nunca un archivo adjunto para un visual dentro de una explicación (herramienta de envío de archivos, archivo PNG o JPG): la aplicación coloca los archivos adjuntos donde quiere, a menudo todos al final, y el lector ya no sabe cuándo mirarlos.
• Orden de trabajo:
  1. Prepara todos los visuales primero, en silencio (copias de figuras, búsquedas).
  2. Luego escribe la respuesta pieza por pieza: el texto de una parte, luego la llamada que muestra su visual, luego el texto de la siguiente parte, y así sucesivamente.
• Si tu entorno solo muestra texto enviado a través de una herramienta de mensajería (por ejemplo SendUserMessage), envía cada pieza de texto con ella; de lo contrario, el texto escrito entre dos llamadas a herramientas podría resumirse y no mostrarse.
• Justo antes del visual, una línea lo anuncia ("El diagrama de tu curso:"). Justo después, una línea 👀 Qué mirar: …

Toma la primera fuente que exista, en este orden. Nunca modifiques un archivo original: trabaja sobre una copia.

A. Un diagrama de las páginas de estudio del usuario, copiado tal cual (mejor opción). Ya está bien y es familiar: no lo redibujes.

• Para una página HTML con diagramas SVG, usa scripts/figure_to_chat.py: python3 figure_to_chat.py page.html lista las figuras, python3 figure_to_chat.py page.html <n> fig.svg escribe una como SVG independiente con sus colores incrustados (normalmente de 3 a 10 KB).
• Muéstralo con show_widget, en modo HTML, dentro de una tarjeta blanca (fue hecha para un fondo claro): <div style="background:#fff;border-radius:12px;padding:8px 4px">, el SVG copiado exactamente, luego </div>.
• Solo figuras SVG. Una foto o figura escaneada no se puede mostrar en su lugar: usa B, C o D.

B. Una figura de sus diapositivas o libro de texto, redibujada y anotada.

1. Encuentra la diapositiva o página correcta por su texto (python-pptx o pdftotext), conviértela a PDF (soffice --headless --convert-to pdf), renderízala (pdftoppm -r 110) y mírala.
2. Redibújala como un SVG simplificado con show_widget (mismos elementos, mismo diseño), luego anótala: marcos redondeados de color alrededor de los elementos importantes, etiquetas numeradas, la leyenda de los números justo debajo, y una línea de fuente: "Redibujado de la diapositiva <n.º> de tu curso".
3. Por qué redibujar: un archivo de imagen solo se puede mostrar como adjunto, por lo tanto no en su lugar. El dibujo aparece exactamente donde lo llamas.

C. Una imagen web (herramienta de búsqueda de imágenes, que se muestra en su lugar), solo si A y B no existen, o como extra.

• Elige la más simple, en el idioma del usuario si es posible.
• Debajo, escribe 👀 Qué mirar: …, y traduce cualquier etiqueta extranjera.

D. Un diagrama dibujado con la herramienta de dibujo del chat (el Visualizer: show_widget, después de su read_me, módulo "diagrama"). Úsalo para un mecanismo que ninguna figura muestra, o para la imagen de comparación (tira y afloja, puerta, balanza).

• Muestra el mecanismo a través de formas, no una lista de recuadros.
• Usa 2 o 3 colores, los mismos que los puntos.
• Muestra la fuerza o cantidad a través del grosor o tamaño.
• Máximo 6 etiquetas de 5 palabras, más un pie de foto de una línea.

Cuántos:

• Modo hoja: un visual (A si existe, si no D). No más de 3 llamadas a herramientas para obtenerlo.
• Modo lección: al menos un visual por parte.

Nunca:

• un diagrama en un bloque de código, en ASCII o con caracteres alineados a mano;
• un archivo de imagen adjunto dentro de una explicación;
• todos los visuales agrupados al final.

5. Cuestionario

Modo hoja: el bloque "Compruébalo tú mismo".

Modo lección: un cuestionario interactivo de 5 preguntas de opción múltiple con la herramienta de cuestionario del chat si existe (si no, 5 preguntas en texto, respuestas al final).

• Una respuesta correcta por pregunta.
• Al menos 2 preguntas de razonamiento ("¿qué pasa si…"), no solo definiciones.
• Trampas plausibles: conceptos erróneos clásicos y las líneas de "Cuidado" de la respuesta.
• Para cada pregunta: una pista y una explicación breve.
• Solo sobre lo que explicó la respuesta.

6. Palabras

• Verbos simples (entrar, salir, empujar, tirar, abrir, cerrar) en lugar de sustantivos abstractos.
• Sin acrónimo ni notación sin traducirlo la primera vez.
• Control de jerga: toda palabra que un niño de 14 años no conocería se traduce en su primer uso o se elimina.
• Concreto antes que abstracto.
• Control de simplificación: si alguien creyera esta versión al 100 %, ¿se equivocaría en una pregunta de examen? Si es así, añade la excepción en una línea.
• Como máximo un matiz, nunca advertencias apiladas.
• Nunca: "simplemente", "obviamente", "solo", "la respuesta es simple", "gran pregunta".
• Responde en el idioma del usuario, con un tono tranquilo.

7. Revisión antes de enviar (bloqueante)

1. El modo está elegido y respetado.
2. Encabezados: # para partes de lección, ## para bloques de hoja, cada uno con su emoji, y un --- entre líneas en blanco antes de cada uno.
3. Una frase por línea, separada por una línea en blanco.
4. Cada visual se muestra en medio del texto, justo debajo de lo que ilustra, mediante la herramienta de dibujo o la búsqueda de imágenes. Sin archivo adjunto, sin visual agrupado al final, sin diagrama en un bloque de código. Las fuentes siguen el orden A → B → C → D.
5. Ambos casos están cubiertos siempre que haya un exceso o una escasez.
6. Cada palabra técnica y acrónimo está traducido.
7. En modo lección: un 📌 por parte, un resumen con flechas, el cuestionario.
8. Como máximo una pregunta al usuario, al final (el cuestionario no cuenta).

8. Si el usuario no entiende (o se equivoca)

• "No lo entiendo": no lo hagas más largo. Pregunta en una línea dónde se rompe ("¿parte 2 o parte 3?"), vuelve a ese punto, cambia la comparación, córtalo más pequeño, luego reconecta.
• Respuesta incorrecta: di qué está bien en su respuesta, nombra el error y por qué parece lógico, muestra lo incorrecto y lo correcto lado a lado en una tabla, luego haz una nueva pregunta del mismo tipo.
• "OK, lo entendí": pídeles que reformulen la idea en una frase, con sus propias palabras.

9. Ejemplo (modo hoja)

Pregunta: "¿Qué es el potencial de membrana en reposo?"

💡 La idea

En reposo, una célula nerviosa es negativa por dentro, principalmente porque el potasio se escapa.

---

🪢 Visualízalo: un tira y afloja

• 🟢 Potasio (K⁺) tira hacia −95 mV, con muchos jugadores.
• 🟠 Sodio (Na⁺) tira hacia +67 mV, con muy pocos jugadores.
• El marcador se detiene cerca del equipo más fuerte: −70 mV.
• La comparación termina aquí: los "jugadores" son los canales abiertos.

(Aquí, un visual: una figura del curso del usuario, o el tira y afloja dibujado con el Visualizer).

---

⚙️ Cómo funciona

1. Cada ion tiene su valor de equilibrio: K⁺ a −95 mV, Na⁺ a +67 mV.
2. En reposo, principalmente los canales de K⁺ están abiertos.
3. Por lo tanto, K⁺ gana → el valor en reposo es cercano a −95.
4. Neurona: −70 mV. Músculo cardíaco: −90 mV.

📌 Conclusión clave: cuanto más fácilmente cruza un ion, más fuerte tira del valor en reposo hacia el suyo.

---

✅ Compruébalo tú mismo

De repente, se abren muchos canales de Na⁺. ¿Se mueve el marcador hacia −95 o +67?

Respuesta: hacia +67, porque el equipo de Na⁺ tiene de repente muchos jugadores. Ese es el inicio de un potencial de acción.