Técnica de Feynman

La IA te dio la solución. Funcionó. Sigues sin saber por qué.

Esto es para el porqué.

English · 中文 · हिन्दी · Español · Français · العربية · বাংলা · Português · Русский · اردو

El mismo modelo. La misma pregunta. Una línea de instalación.

"¿Por qué me sale Cannot read properties of undefined (reading 'map')?"

Las dos respuestas son ciertas. Solo una de ellas explicaba algo.

De dónde sale esto

El padre de Feynman le enseñó un pájaro y le dijo que puedes aprenderte su nombre en todos los idiomas de la Tierra y seguir sin saber absolutamente nada del pájaro. Sabrías cómo lo llama la gente, y nada más. Para conocer al pájaro hay que mirar lo que hace.

"There is a difference between the name of the thing and what goes on." — Richard Feynman, What Is Science?, 1966

"Hay una diferencia entre el nombre de la cosa y lo que ocurre."

Ahí está la idea entera, y casi todas las IA fallan en eso por defecto. Preguntas qué es algo y recibes su nombre dicho con palabras más finas. "Es una race condition." "Usa connection pooling." Asientes con la cabeza. No se ha transmitido nada. Este skill hace que el modelo entregue primero el mecanismo y el nombre al final, como hacía Feynman.

Está hecho a partir de fuentes primarias, no de artículos de blog sobre Feynman. Para sacar de ahí tanto el método como el estilo de la prosa se analizaron unas 88.000 palabras escritas por él: Six Easy Pieces, la Conferencia Nobel de 1965, Cargo Cult Science, What Is Science?, There's Plenty of Room at the Bottom y el capítulo brasileño de Surely You're Joking, Mr. Feynman!

El repositorio está en inglés. Las respuestas no — el skill contesta en el idioma en que le escribas.

Las cuatro pruebas que aplica

Nada del manido "explícaselo a un niño de 12 años". Son las pruebas del propio Feynman, y todas se pueden rastrear hasta una fuente primaria.

Instalación

Una sola carpeta. Funciona en cualquier herramienta que implemente el estándar abierto Agent Skills.

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.claude/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.claude/skills/

Eso es Claude Code. A partir de ahí, basta con pedírselo:

/feynman-technique explica cómo funcionan los índices de base de datos

mkdir -p .claude/skills
cp -r /tmp/feynman-technique/skills/feynman-technique .claude/skills/

./install.sh              # personal, Claude Code
./install.sh --project    # en este repositorio, para el equipo
./install.sh --all        # todos los directorios de herramientas de esta máquina
./install.sh --check      # dice qué copias se han quedado atrás, sin tocar nada

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.agents/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.agents/skills/

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.cursor/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.cursor/skills/

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.copilot/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.copilot/skills/

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.gemini/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.gemini/skills/

~/.agents/skills/        # la convención que se está imponiendo entre herramientas
~/.claude/skills/        # ampliamente soportada como alternativa
<específico-de-la-herramienta>/skills/  # p. ej. ~/.gemini/skills/, ~/.cursor/skills/

Comprueba que funciona

Pregúntale por algo que ya entiendas bien:

/feynman-technique ¿qué es una función hash?

Una respuesta correcta empieza con una tesis de una sola frase, sigue con un nivel 0 sin una sola palabra técnica y termina con un apartado de "dónde se rompe la imagen". Si empieza por "Una función hash es una función que mapea datos de tamaño arbitrario…", el skill no se ha cargado.

Qué te devuelve

**En una frase:** ...              ← para que un experto pueda dejar de leer aquí

**La imagen que hay que sostener:** ...  ← la analogía maestra

0 · La sobremesa     ningún conocimiento del campo. Cero términos técnicos.
1 · Recién llegado   los nombres reales, atados a la imagen del nivel 0
2 · Profesional      cómo encajan las piezas, y el primer trade-off real
3 · Mantenedor       modos de fallo, qué se rompe, qué se descartó y por qué
4 · Especialista     bordes, escala y los límites del propio modelo

Dónde se rompe la imagen     ← los límites de toda analogía, declarados
Palabras nuevas de aquí      ← una línea por término nuevo
Qué he dejado fuera          ← nombrado, no omitido en silencio

Los niveles se comprimen, pero nunca desaparecen. Una pregunta acotada recibe forma compacta: tesis, imagen y el único nivel que importa. Hacer desfilar a un experto por los cinco niveles no es rigor; le degrada la comprensión, y de forma medible (el efecto de reversión de la pericia).

Hay un ejemplo completo resuelto: "¿qué es un índice de base de datos?", respondido entero y luego anotado para enseñar qué hace cada parte.

Modo entrenador — el que de verdad te enseña

/feynman-technique pregúntame sobre cómo TCP maneja la congestión
/feynman-technique quiero comprobar si entiendo de verdad event sourcing

Aquí el skill se niega a explicar. Explicas tú; él escucha en busca de vaguedades, de palabras técnicas usadas como punto final, de pasos que afirmas sin mecanismo — y te señala una sola laguna cada vez, sin darte la respuesta.

Es el modo que tiene la investigación más sólida detrás. Quien se prepara para enseñar rinde más que quien se prepara para un examen, incluso cuando la clase no llega a darse nunca (Nestojko et al., 2014). Construir tu propia explicación funciona mejor que leer la de otro (Chi et al., 1989).

Las reglas que sigue

Regla cero: ser claro nunca es excusa para estar equivocado. Si simplificar deformara el asunto, lo dice, da los límites y entrega la versión exacta un nivel más arriba.

Por dentro

Los archivos del skill están en inglés, para que el frontmatter siga siendo el canónico.

Una muestra del análisis forense de estilo

De voice.md, todo medido sobre el corpus de 88.000 palabras:

• La irregularidad es la firma. Mediana de frase ≈ 20 palabras — pero ~1 de cada 8 baja de las ocho palabras y ~1 de cada 6 pasa de treinta y cinco. Construye largo y aterriza corto. "Shake this one, that one shakes later."
• Los pronombres cambian según la función. "We" al enseñar (19,95 por cada 1.000 palabras en Six Easy Pieces, diez veces su "I"), "I" al admitir que está confundido (26,7/1k en la Conferencia Nobel), "you" al instruir (20,6/1k en Cargo Cult Science).
• Verbos que el cuerpo siente. jiggle 27, pull 37, push 28, shake 20. Las moléculas se menean; no "exhiben agitación térmica".
• "Basically" aparece cero veces en 88.000 palabras. Trivial aparece una. Por eso el skill las prohíbe — medición, no gusto personal.

Limitaciones honestas

La regla cero vale también para esta página.

• Feynman no inventó la "Técnica de Feynman". Nunca publicó ningún método de cuatro pasos con ese nombre. Los cuatro pasos los armaron divulgadores posteriores, sobre todo Scott H. Young hacia 2011, y son una reconstrucción razonable. Este skill usa en su lugar las pruebas que él sí documentó, y lo dice.
• "Si no puedes explicarlo de forma simple, no lo entiendes" no tiene fuente primaria ni en Feynman ni en Einstein. sources.md recoge lo que dijo de forma verificable y lo que no.
• Hay cosas que no se simplifican. El propio Feynman chocó con ese muro: cuando su padre le preguntó cómo sale un fotón de un átomo sin haber estado dentro, respondió "I'm sorry; I don't know. I can't explain it to you." El skill está hecho para decir eso antes que inventarse una imagen.
• Cuesta tokens y tiempo. Para una consulta rápida, lo que toca es la forma compacta, o directamente ningún skill.
• Sirve de poco para memorizar o para las habilidades motoras. Apunta a la comprensión causal, la de los mecanismos. El vocabulario y los atajos de teclado piden recuperación espaciada, no explicaciones.
• Una buena explicación da la sensación de haber entendido. Esa sensación no es una prueba. Cuando importa, usa el modo entrenador.

Créditos y derechos de autor

Richard P. Feynman (1918–1988) escribió todo lo que vale la pena leer aquí. Este repositorio contiene reglas derivadas y citas breves con atribución, usadas para analizar y enseñar — no redistribuye su obra.

Sus textos siguen bajo derechos de autor: The Feynman Lectures on Physics se puede leer gratis en feynmanlectures.caltech.edu, pero es © de Caltech y no es de dominio público. Si haces un fork, mantenlo así: cita lo justo, atribuye siempre, no pegues capítulos enteros. Toda la procedencia está en sources.md.

Este skill empezó como feynman-reply, un skill en portugués de @guicortei. Se reconstruyó a partir de fuentes primarias, se generalizó más allá del software y se amplió con el análisis de estilo, la base de evidencias y el modo entrenador — y después pasó a llamarse feynman-technique.

Sin relación ni respaldo de los herederos de Feynman, de Caltech ni de Anthropic.

Contribuir

Se agradecen mejoras, sobre todo ejemplos resueltos de otros campos, modos de fallo detectados en uso real y correcciones a cualquier cita. Consulta CONTRIBUTING.md.

Una petición: si añades una afirmación sobre Feynman, cita la fuente primaria. Invocar su nombre para hablar de honestidad intelectual y a la vez ser descuidado con las atribuciones es el único bug imperdonable de este repositorio.

Licencia

MIT. Úsalo, haz un fork, publícalo.