ES
Idioma · la misma página NLNederlands/ai-en-automatisatie/ai-5-waarom-analist-skill-voor-claude/ ENEnglish (UK)/en/ai-and-automation/ai-5-whys-analyst-skills-for-claude/ ESEspañol/es/ia-y-automatizacion/analisis-de-5-porques-habilidad-para-claude/ No recordamos tu elección y nunca te redirigimos automáticamente.
~/skills/ai-5-waarom-analist[ok] cargado
INS.SKILL · GRATIS PARA CLAUDE, TAMBIÉN PARA CODEX Y CURSOR

El Analista de los 5 Porqués skill para Claude

Describes un problema que sigue volviendo, y Claude excava con el método de los 5 porqués hasta la causa donde alguien puede cambiar algo de verdad. Cada capa recibe una etiqueta: confirmada por datos, plausible o hipótesis. La causa raíz se formula como sistema o proceso, nunca como persona. Y obtienes dos medidas separadas: el parche para esta semana y la intervención que elimina la causa. El mismo método se conoce también como five whys, 5 whys o los 5 por qués; el archivo responde a todos esos nombres.

Descarga la skill Ver todas las skills NL 5,7 KB · zip con SKILL.md · licencia MIT · sin cuenta
$ instalación, línea por líneaFIG.00
~/.claude/skills
theseo ~ %
  inflating: ai-5-waarom-analist/SKILL.md
theseo ~ %
  ---
  name: ai-5-waarom-analist
  description: 'Voert een gestructureerde Five Whys analyse uit op elk…
theseo ~ %
[ok] skill activa · 2.243 palabras de instrucciones cargadas

las líneas de arriba vienen del zip de esta página · SKILL.md pesa 14.085 bytes

~/skills/ai-5-waarom-analist/01-de-ketting[run]
Sección 01 · La demostración

La cadena se despliega capa por capa

reg. W.001

Este es el caso que aparece literalmente en el SKILL.md, aquí resumido. Fijate en las etiquetas de la derecha. Son la diferencia entre un análisis de causas y una historia que por casualidad suena lógica: la skill dice, por cada capa, si la respuesta está confirmada, es plausible o sigue siendo solo una hipótesis.

FIG.01: La cadena de porqués, capa por capa[#----] hoja 1/5
~/analyses · claude + ai-5-waarom-analist
tú > nuestros presupuestos tardan 9 días laborables cuando prometemos 2, esto lleva meses así
planteamientoprimero medible, luego el porqué De las aproximadamente 40 solicitudes de presupuesto al mes, el plazo medio de entrega es de 9 días laborables, mientras que se prometen 2 días laborables, y ese patrón se mantiene desde hace varios meses.
# conocido: número de solicitudes, plazo medio, promesa al cliente
# desconocido: dispersión por gestor de cuentas, en qué punto de la cadena se pierde el tiempo
claude · cinco capas de preguntas, cada capa contrastada con pruebas...
[1/5] ¿por qué un presupuesto tarda 9 días en vez de 2? PLAUSIBLE Porque el presupuesto llega, en promedio, al escritorio del gestor de cuentas recien el día 6. Aún no se ha medido por paso.
[2/5] ¿por qué la solicitud no llega a ese escritorio hasta el día 6? CONFIRMADO Porque las solicitudes llegan a un correo general que se clasifica una vez por semana. Confirmado por el usuario.
[3/5] ¿por qué ese correo solo se clasifica una vez por semana? PLAUSIBLE Porque clasificarlo es una tarea sin dueño fijo, que se hace aparte del trabajo habitual.
[4/5] ¿por qué esa tarea no tiene dueño fijo? HIPÓTESIS Porque el correo se creó en su momento como solución temporal para una campaña y nunca se incorporó a ningún proceso. Por comprobar con quien creó la dirección.
[5/5] ¿por qué esa solución temporal nunca se incorporó a un proceso? HIPÓTESIS Porque no hay ningún momento en el que se evalúen y asignen los nuevos canales de entrada.
CAUSA RAÍZNo existe un procedimiento fijo que determine quién gestiona un nuevo canal de entrada, por lo que las solicitudes caen en una cola que nadie vacía a diario.
ARREGLO DIRECTOA partir del lunes, revisión diaria del correo general por una persona designada por nombre, con suplente en caso de ausencia. Responsable: jefe de ventas. Esto detiene el síntoma, no resuelve la causa.
ESTRUCTURALHacer que las solicitudes pasen automáticamente a una cola compartida con asignación y un contador visible, y añadir al procedimiento que cada nuevo canal tenga dueño en un plazo de dos semanas. Responsable: gerente de operaciones. Plazo: seis semanas.
VERIFICACIÓNMedir durante ocho semanas el plazo por solicitud, dividido en tiempo hasta la asignación y tiempo hasta el envío. Funciona si la asignación baja de un día laborable y el plazo total de tres. Si solo baja la asignación, había un segundo cuello de botella en la redacción misma.
[#####] 5/5 listo · dos capas quedan a propósito en hipótesis: eso todavía lo tienes que averiguar
7W.01 · pasos fijos por análisis
7W.02 · bloques en el resultado
7W.03 · cosas que la skill rechaza
0W.04 · euros, licencia MIT, sin cuenta
W.01 a W.04 · propiedades del archivo de la skill, no resultados ni cifras de uso.
$ cat 01-wat-de-5-waarom-methode-is.md
DOC.01

Qué es el método de los 5 porqués

El método de los 5 porqués es una manera de pasar de un problema visible a la causa que hay debajo, preguntando una y otra vez por qué sobre la respuesta que acabas de recibir. Empiezas por el síntoma, preguntas por qué ocurre, y sobre esa respuesta vuelves a preguntar por qué, hasta llegar a una capa donde alguien puede cambiar algo de verdad. En inglés el mismo método se llama five whys o 5 whys, y en el mundo de la calidad cae bajo el término más amplio de análisis de causa raíz o root cause analysis. Es la misma herramienta con distintos nombres.

El método se atribuye en general a Sakichi Toyoda, el fundador de Toyota Industries. Taiichi Ohno lo hizo conocido como parte fija del Sistema de Producción Toyota y lo describió en su libro sobre ese sistema de 1978. El razonamiento detrás es simple: todo problema visible es consecuencia de algo más profundo, y esa causa más profunda solo se alcanza bajando varias capas. Cinco no es un número sagrado. Es una regla práctica que dice que, en la primera explicación plausible, probablemente todavía no has llegado.

El Analista de los 5 Porqués traduce ese método a una forma de trabajo fija para Claude. Una skill es un archivo de instrucciones, SKILL.md, que le da a un asistente de IA una forma fija de abordar una tarea. No es software que instalas, no hay suscripción ni conexión con tus sistemas: un archivo de texto de 2.189 palabras que le dice a Claude cómo debe montarse un análisis de causas, qué debe preguntar primero, cómo marca la certeza de cada capa y qué no puede inventar bajo ningún concepto. Descargas el zip al principio de esta página, lo colocas en tu entorno de Claude, y desde ese momento cada pregunta de causa pasa por esta lógica.

Lo que hace diferente a la skill de simplemente preguntar cinco veces por qué está en tres cosas. Primero, te obliga a hacer el problema medible antes de nada. Antes de que caiga el primer porqué, reescribe tu queja como una frase objetiva con lugar, momento y magnitud. Segundo, etiqueta cada capa según la prueba que la respalda, para que al final veas qué parte de tu análisis se apoya en datos y qué parte en una historia que por casualidad cuadra. Tercero, separa el parche de la intervención: el arreglo directo que detiene el síntoma esta semana queda aparte de la medida estructural que elimina la causa, cada una con su responsable y su plazo.

El archivo forma parte de la biblioteca de skills NL de TheSEO, donde hay 100 skills gratis para descargar, y nace del servicio IA y automatización. Si es la primera vez que usas este tipo de archivos, empieza por qué son las skills de Claude NL: ahí se explica en lenguaje sencillo qué es y qué no es una skill.

$ cat 02-waar-kettingen-sneuvelen.md
DOC.02

Por qué la mayoría de cadenas de porqués se rompen

Casi cualquiera sabe preguntar cinco veces por qué. Ese no es el problema. El problema es que una cadena puede descarrilar de cuatro maneras sin que te des cuenta, y entonces tienes un análisis que parece un análisis pero no resuelve nada. El SKILL.md tiene una regla explícita para cada una de esas cuatro.

La cadena apunta a personas. Es la trampa más conocida, y Eric Ries le puso nombre en The Lean Startup, de 2011: Five Blames. Cada capa acaba en alguien que olvidó algo, no lo comunicó o no prestó atención. Resulta satisfactorio, porque hay un culpable. Pero puedes reparar un sistema y no puedes reparar a una persona, así que ese análisis siempre termina en una conversación y nunca en una medida. Señalar a una persona como causa raíz lo rechaza sin rodeos, y las causas las escribe precisamente en voz pasiva para quitar de en medio la pregunta de la culpa. No fue Juan quien olvidó el control, sino que el control se saltó porque no había un campo obligatorio.

La cadena reformula en lugar de explicar. La capa tres dice con otras palabras lo mismo que la capa dos. Los presupuestos tardan porque el plazo es alto: parece un paso más profundo, pero sigues en el mismo sitio. En el modo de evaluación de la skill este es el primer punto de control, y el archivo llama a las reformulaciones literalmente el error más frecuente.

La cadena se detiene en la capa técnica. El SKILL.md distingue tres tipos de capa que sueles encontrar: la capa técnica, donde algo falló en una acción, un ajuste o un fragmento de código; la capa de proceso, donde el proceso permitió ese fallo o incluso lo provocó; y la capa de sistema, donde nadie era responsable, los incentivos estaban mal orientados o una decisión anterior causó esto sin querer. Un buen análisis rara vez termina en la capa técnica. Ahí está el arreglo rápido, no la solución estructural.

O la cadena aparenta que todo es seguro. Cinco respuestas seguidas se leen como cinco hechos, aunque tres de ellas sean una apuesta. Por eso cada capa del resultado lleva una línea de Certeza, con uno de tres valores: confirmado por datos, plausible pero no probado, o pura hipótesis. En la FIG.01 hay dos capas en hipótesis, y esas dos vuelven al final en un bloque aparte con lo que todavía hay que averiguar. Ese bloque es la sección más honesta de todo el resultado.

En forma de diff, con una cadena que se razona hacia una persona frente a la misma cadena que sigue hasta el sistema:

~/skills/ai-5-waarom-analist/02-ontsporing[ok]
Sección 02 · El descarrilamiento

Culpar a una persona o al proceso

reg. W.002

Dos cadenas que empiezan exactamente en el mismo punto y luego se separan. A la izquierda, la versión que todo el mundo conoce de la sala de reuniones: cada capa se acerca más a un nombre. A la derecha, la misma pregunta, llevada hasta el proceso. El medidor de abajo muestra a dónde llegas, porque eso determina si tu medida sigue funcionando mañana.

FIG.02: Dónde descarrila la cadena[##---] hoja 2/5
descarrilamiento.diffmismo problema, dos rutas
Capa 2 (compartida): la solicitud de presupuesto estuvo parada seis días antes de que alguien la retomara. # desde aquí la cadena se divide
[mal] hacia la personafive blames
[3]¿Por qué estuvo parada? Porque el compañero no la había reenviado.
[4]¿Por qué no? Porque se le olvidó.
[5]¿Por qué se le olvidó? Porque tenía mucho trabajo y se volvió descuidado.
resultado: se habla con alguien · dos semanas mejor · luego vuelta a empezar
[bien] hacia el procesocapa de sistema
[3]¿Por qué estuvo parada? Porque estaba en una bandeja que se clasifica una vez por semana.
[4]¿Por qué una vez por semana? Porque clasificarla no tiene dueño fijo.
[5]¿Por qué no tiene dueño? Porque no hay ningún momento en el que se asigne un nuevo canal.
resultado: cambia un procedimiento · el fallo ya no puede repetirse de la misma manera
[capa 1] TÉCNICAAlgo falló en una acción, un ajuste o un fragmento de código. Aquí está el arreglo rápido.
[capa 2] DE PROCESOEl proceso permitió ese fallo o incluso lo provocó. Aquí empieza la medida estructural.
[capa 3] SISTEMANadie era responsable, los incentivos estaban mal orientados, o una decisión anterior causó esto sin querer. Aquí termina un buen análisis.
# la ruta de la izquierda termina en la capa técnica y se presenta como terminada. La skill lo marca en el modo de evaluación como error de profundidad y pide ella misma seguir tres o cuatro capas más.
$ less ai-5-waarom-analist/SKILL.md # 2.189 palabras de instrucciones
DOC.03

Lo que realmente hay en el SKILL.md

Una skill es tan buena como sus instrucciones, así que aquí las describimos sin más. El archivo abre con un frontmatter que indica cuándo Claude debe activar la skill. No solo con los términos obvios como 5 porqués, five whys, cinco veces por qué, causa raíz, root cause, RCA, análisis de causas, análisis del problema, diagrama de espina de pescado, Ishikawa, análisis kaizen, post mortem, análisis de incidentes y análisis de quejas, sino también con quejas del tipo: ya hemos resuelto esto tres veces y siempre vuelve, solo apagamos fuegos, todos se señalan entre sí, el cliente vuelve a quejarse de lo mismo, no cumplimos el plazo de forma estructural, el arreglo duró una semana. Quien le dice algo así a Claude con la skill cargada, la recibe automáticamente.

Después viene un capítulo de teoría: Toyoda y Ohno, las tres capas técnica, de proceso y de sistema, y cuatro variantes que la skill puede usar cuando el contexto lo pide. La cadena ramificada, para cuando una capa tiene varias causas válidas. La combinación con el diagrama de Ishikawa, para cuando todavía nadie sabe dónde está el problema. Five whys plus how, en la que después de la causa raíz se recorre la cadena hacia arriba preguntando cómo se protege cada capa. Y la variante lean startup de Eric Ries, en la que por cada capa se hace una inversión proporcional a la gravedad del problema.

El núcleo es una lista de siete cosas que la skill hace siempre. Reformula el problema en una frase objetiva y medible, con lugar, momento y magnitud, antes de que caiga un porqué. Plantea las cinco preguntas una por una y las responde según lo que tú le has dado, no según una suposición. Marca en cada capa la certeza de la respuesta. Divide la cadena visiblemente en ramas en cuanto una capa tiene varias causas válidas, y sigue la rama de mayor impacto.

Formula la causa raíz en una frase, planteada como sistema o proceso. Entrega el arreglo directo y la medida estructural por separado, cada una con responsable y plazo. Y cierra con un paso de verificación.

Antes de analizar nada, la skill repasa una lista de comprobación obligatoria de seis puntos: el problema en tus propias palabras, cuándo ocurre y con qué frecuencia, a quién o a qué afecta, qué se ha intentado ya y por qué no funcionó, qué datos o cifras hay disponibles, y qué puedes y qué no puedes cambiar en presupuesto, mandato e influencia sobre otros departamentos. Solo pregunta lo que falta y después deja de preguntar. Si no sabes algo, sigue adelante y marca esa capa como no probada. Es decir, no recibes un formulario, como mucho dos o tres preguntas concretas.

Sorprendentemente muchas reglas hablan de lenguaje. Neerlandés claro (el archivo está escrito en neerlandés), trato de tú, sin guiones en el texto corrido, AI en mayúsculas, sin listas de exactamente tres elementos, lo concreto por encima de lo abstracto, la cifra por encima del adjetivo, y frases cortas alternadas con largas. Incluso hay una lista de palabras y giros prohibidos porque huelen a IA. Y hay una regla de redacción que es de contenido y no cosmética: escribe las causas en voz pasiva cuando eso quita de en medio la pregunta de la culpa. Si quieres entender cómo llegan reglas así a un archivo de skill, escribir un SKILL.md NL explica la estructura paso a paso.

El resultado está fijado en siete bloques en orden fijo: planteamiento, la cadena de porqués, causa raíz, arreglo directo, medida estructural, verificación, y lo que todavía hay que averiguar. Además, el archivo tiene un modo de evaluación aparte para análisis existentes, una lista de siete cosas que la skill nunca hace, y una lista de cinco fuentes. Estas dos últimas tienen su propia sección más adelante en esta página.

~/skills/ai-5-waarom-analist/03-vertakking[ok]
Sección 03 · La ramificación

Cuando una capa tiene más de una causa

reg. W.003

Una cadena recta funciona mientras cada capa tenga una única respuesta válida. En cuanto eso deja de ser así, la cadena se convierte en un árbol. Entonces divide la cadena de forma visible, sigue la rama de mayor impacto y deja las demás ramas abiertas en vez de esconderlas. Si nadie sabe todavía dónde está el problema, usa primero las categorías de Ishikawa como antesala para decidir qué rama merece la pena.

FIG.03: La cadena ramificada y la antesala de Ishikawa[###--] hoja 3/5
MANO DE OBRA
MÉTODO
MÁQUINA
MATERIAL
MEDICIÓN
$por qué "el informe semanal no cuadra de forma estructural" # capa 1
├─porque contiene cifras que vienen de dos fuentes distintas # capa 2
# la capa 3 tiene dos causas válidas, así que la cadena se divide
├──rama A la exportación se ejecuta en un momento distinto a la importación # mayor impacto, se sigue
│  └─¿por qué? porque nunca se fijó el momento cuando se construyó la conexión
│    └─¿por qué? porque no hay dueño para la conexión misma # capa de sistema alcanzada
└──rama B dos departamentos cuentan una devolución de forma distinta # queda abierta, se menciona
 # ejemplo esquemático de la ramificación, no viene del caso del SKILL.md
Por qué a veces hace falta la antesala. Kaoru Ishikawa describió en 1968 el diagrama de causa y efecto, también llamado diagrama de espina de pescado, en el que primero divides las posibles causas en categorías como mano de obra, método, máquina, material y medición. La skill lo usa cuando todavía no sabes por dónde empezar a excavar: primero categorizar, luego elegir la rama más probable, y solo después seguir preguntando. Si empiezas directamente con el porqué sin tener ni idea, acabas excavando cinco capas de profundidad en el lugar equivocado.
$ cat 04-bronnen-en-theorie.md # Ohno, Ishikawa, Ries, Rother, Dekker
DOC.04

La teoría sobre la que se apoya la skill

En el archivo se citan cinco fuentes por nombre. Es a propósito: así puedes consultarlas y decidir tú mismo si estás de acuerdo. Cada fuente explica una decisión de la forma de trabajo.

El método en sí viene de Toyoda y Ohno. Taiichi Ohno describió el Sistema de Producción Toyota en 1978, con la edición en inglés en 1988, y en ella atribuye las cinco preguntas de porqué a Sakichi Toyoda. Lo que a menudo se pasa por alto es el contexto: en Toyota, preguntar una y otra vez no era una técnica de reunión sino un hábito en el taller, cerca de la máquina, con las personas que hacían el trabajo. Eso explica por qué la skill insiste tanto en los hechos y en lo que tú mismo puedes observar.

La antesala viene de Kaoru Ishikawa. Su Guide to Quality Control, de 1968, contiene el diagrama de causa y efecto que en la práctica casi siempre se usa junto con el método de los 5 porqués. El reparto de papeles es claro: el diagrama de espina de pescado amplía, la cadena de porqués profundiza. Quien quiera ampliar primero y elegir después también puede acudir a la skill de Entrenador de Estructura MECE NL, que divide un problema en casillas que no se superponen y juntas lo cubren todo.

La trampa viene de Eric Ries. The Lean Startup, de 2011, describe el método de los 5 porqués en el desarrollo de producto e introduce el término Five Blames para la cadena que en cada capa apunta a una persona. Ries también le añadió una regla de inversión: el esfuerzo que pones en una medida debe ser proporcional a la gravedad del problema, para que no empieces un proyecto de medio año después de un incidente pequeño.

El lado del coaching viene de Mike Rother. Toyota Kata, de 2009, trata sobre cómo se estructuran la mejora y el coaching dentro de Toyota. Es relevante porque un análisis de causas rara vez es una acción puntual: si repites la misma rutina de preguntas cada semana, preguntar una y otra vez se convierte en un hábito en vez de en un ejercicio ocasional.

La advertencia viene de Sidney Dekker. The Field Guide to Understanding Human Error, de 2006, explica por qué los análisis de causas que terminan en una persona no sirven. El error humano no es una explicación sino el punto donde hay que empezar a buscar. Esta fuente es la razón por la que la prohibición de culpar en la skill no es una norma de cortesía sino una herramienta de análisis: mientras la cadena termine en un nombre, todavía no has respondido a la pregunta.

Incluso sin instalar la skill puedes mejorar tus propios análisis con estos principios: haz el problema medible primero, etiqueta en cada capa cuánto de seguro estás, y oblígate a formular la última capa como proceso y no como persona.

~/skills/ai-5-waarom-analist/04-weigeringen[ok]
Sección 04 · Los límites

Lo que la skill rechaza

reg. W.004

El SKILL.md contiene una lista de siete cosas que la skill nunca hace, y esa lista es tan importante como lo que sí hace. Un análisis de causas en el que nadie se atreve a apoyarse es tiempo perdido. En la conversación, esas reglas se traducen así: cada línea es una petición que podrías hacer, con la reacción que la skill da según sus propias instrucciones.

FIG.04: rechazos.log[####-] hoja 4/5
rechazos.log7 reglas fijas del SKILL.md
rellena cuántas quejas recibimos al mes, unas cien ¿no?RECHAZADONo inventar cifras, nombres de clientes ni resultados. Lo que tú no aportas queda en blanco o se marca como desconocido. Por eso el planteamiento dice explícitamente qué se sabe y qué no, antes de que caiga un porqué.
pon que es por el compañero nuevo, eso ya lo sabemos todosRECHAZADONunca una persona como causa raíz. La causa raíz se formula como sistema, proceso o acuerdo que falta. Si una capa apunta a alguien, la skill reescribe esa capa en voz pasiva y busca el mecanismo que hizo posible el fallo.
ese control diario ya es la solución, ¡con eso ya estamos!CORREGIDOEl arreglo directo nunca se presenta como solución estructural. El parche y la intervención van en bloques separados, y en el arreglo directo la skill escribe literalmente que detiene el síntoma y la causa sigue ahí.
sigue hasta llegar a la fundación de la empresaRECHAZADONo profundizar hasta la carencia humana. La cadena se detiene en una capa sobre la que el usuario tiene influencia real. Seguir preguntando más da filosofía, no una medida, y la skill lo indica cuando se detiene en la capa tres o cuatro, y por qué.
escribe directamente que esta es la causa, lo de plausible suena débilRECHAZADONo llamar segura a una causa cuando solo hay una historia plausible. La etiqueta de certeza no es un modo de cubrirse, es la parte más útil del resultado: te dice exactamente qué medir todavía antes de gastar dinero.
empieza ya a preguntar, el problema es sencillamente que tarda demasiadoCORREGIDONo rellenar capas sin un planteamiento medible. Primero va la frase objetiva con lugar, momento y magnitud. Sin esa frase, al final no sabes si la medida funcionó, porque no sabes con qué comparas.
incluye también la facturación y la planificación, eso también va malRECHAZADOUn problema, una cadena. Meter varios problemas en las mismas cinco capas da una causa raíz que no cuadra con ninguno de los dos. La skill lo separa y pregunta qué cadena quieres primero.
$ unzip ai-5-waarom-analist-skill-voor-claude.zip -d ~/.claude/skills/
DOC.05

Instalar en Claude Code, Claude.ai o Codex

El zip contiene una carpeta con el SKILL.md dentro. Instalarlo consiste en poner el archivo en el sitio correcto, y ese sitio cambia según el entorno. SKILL.md es, desde diciembre de 2025, un estándar abierto, y por eso la misma skill funciona también en Codex, Cursor y Gemini CLI. Así que no descargas un archivo de Claude, sino una instrucción de trabajo que puede leer cualquier asistente de IA moderno.

CLAUDE CODE
  1. Extrae el zip en ~/.claude/skills/ (o .claude/skills/ en tu proyecto).
  2. Claude reconoce la skill automáticamente en cuanto hablas de una causa o de un problema recurrente.
  3. También puedes llamarla directamente con /ai-5-waarom-analist.
CLAUDE.AI
  1. Ve a Customize y luego a Skills.
  2. Sube ahí el zip como skill.
  3. O pega el contenido de SKILL.md en las instrucciones del proyecto de un Project.
CODEX
  1. Abre AGENTS.md en tu repositorio.
  2. Pega ahí el contenido de SKILL.md, o coloca SKILL.md como archivo aparte al lado y reférencialo desde AGENTS.md.
  3. Codex lo lee en cada sesión.

Después, el uso es sencillo: describe el problema tal como lo vives, con las cifras o registros que tengas. Cuanto más en bruto, mejor, siempre que sea información real. La skill pregunta por su cuenta lo que falta y sigue con lo que ya tiene. Si la instalación se atasca en algún punto, la explicación completa por entorno está en instalar skills de Claude NL, incluidos los errores más frecuentes con carpetas y permisos. Y si quieres aprender a trabajar con IA de forma más amplia, en la base de conocimiento NL encuentras los artículos de fondo.

$ cat 06-wanneer-wel-en-niet.md
DOC.06

Cuándo usártelo y cuándo no

Está en su mejor forma con un problema acotado que se repite y que puedes expresar en cifras: plazos que no se cumplen, quejas que siempre van sobre lo mismo, una avería que vuelve tras cada arreglo, un funnel que pierde en el mismo punto. Ahi la cadena recta de cinco capas rinde al máximo. Si una capa tiene varias causas válidas que no se excluyen entre sí, pasa a la variante ramificada y sigue la rama de mayor impacto, dejando las demás ramas explícitamente como abiertas. Si nadie sabe todavía dónde está el problema, usa primero la antesala de Ishikawa.

Dos ajustes que el propio archivo menciona, y que mucha gente pasa por alto. Puedes parar antes de cinco capas si ya has llegado a una causa sobre la que tienes influencia, siempre que digas que paras y por qué. Y puedes seguir más allá de cinco capas si la quinta sigue siendo un síntoma. En incidentes con impacto en seguridad o en lo financiero, la skill añade además una capa extra que no trata sobre la causa sino sobre la detección: por qué no se notó antes. Esa pregunta suele dar una segunda medida, independiente de la primera.

También hay situaciones en las que es mejor dejarla de lado, y la skill lo dice ella misma en su frontmatter. No durante un incidente en curso: primero se apaga el fuego y después se analiza, porque analizar durante una avería consume atención que necesitas para detenerla. En sesiones de brainstorming donde precisamente quieres abrir opciones funciona al revés, porque este método reduce en vez de expandir. Tampoco escribe textos. Y no para varios problemas a la vez.

Otro límite honesto que no está en el archivo pero cuenta en la práctica: la skill mejora tu análisis, no tu organización. Si la causa raíz está en una decisión que tomó alguien por encima de ti y no quiere revertir, tienes un análisis muy claro y sigues teniendo el mismo problema. Lo que la skill sí hace entonces es poner eso claro por escrito, con un paso de verificación debajo, para que la conversación vaya sobre hechos y no sobre impresiones. Si quieres pasar de una causa a una prioridad, la skill de Analista de Pareto NL es el siguiente paso lógico: determina qué causas explican la mayor parte del problema.

~/skills/ai-5-waarom-analist/05-upgrade-pad[ok]
Sección 05 · De skill a empleado

Hacerlo tú mismo o dejarlo en otras manos

reg. W.005

Esta skill es la versión gratuita para hacerlo tú mismo de un trabajo que también ofrecemos como servicio. Sigue siendo completa y sin trucos, pero ten claro qué es una skill: le enseña a tu IA cómo hacer algo, mientras que cada sesión nueva empieza vacía. Así que no es el motor ni tampoco la memoria. Tú escribes el prompt, tú aportas otra vez el contexto cada vez, tú controlas. Quien quiera algo distinto tiene dos pasos siguientes: entregar el motor a otras manos, o resolver la memoria.

$ cat de-skill-a-empleado.mdtres escalones, el mismo trabajo
ruta-de-mejora.shgratis · empleado · cerebro
ESCALÓN 1 · GRATIS
donde estás ahora
La skill: tú eres el motor Tu mismo ejecutas el Analista de los 5 Porqués en Claude, Codex o Cursor. No cuesta nada, funciona hoy mismo, y lo mantienes por completo en tus manos: sin periodo de prueba, sin partes bloqueadas. El límite es tu propio tiempo: el análisis solo ocurre cuando tu lo inicias, y el contexto de la semana pasada tienes que volver a aportarlo. $ claude --skill ai-5-waarom-analist · 0 euros · tú escribes el prompt, tú controlas
ESCALÓN 2 · SERVICIO
rol a medida
Un rol a medida: el expediente de incidentes al día Un solo análisis de causas no se externaliza. Una empresa donde cada semana algo sale mal y nadie apunta qué sí tiene un proceso recurrente entre manos. Los tres roles que montamos ya hechos son el Empleado de Presupuestos (clasificar solicitudes entrantes y preparar borradores de presupuesto), el Empleado de Ventas (investigación de prospectos y borradores de contacto) y el Empleado de Informes (resúmenes e informes semanales y mensuales a partir de tus propios datos). Este trabajo no está entre ellos, así que se convierte en un rol a medida a través de Mansotti, la empresa de la que TheSEO es el nombre comercial. Lo que ese rol sí puede hacer es recopilar los avisos, rellenar como borrador las cinco capas por cada aviso y mostrar cada mes qué causas raíz siguen repitiéndose. Eso solo funciona si los avisos se registran en algún sitio y hay alguien que valora el resultado. El control sigue siendo tuyo, porque el resultado sigue siendo borrador hasta que una persona da su visto bueno. Lee qué es y qué hace un empleado de IA NL. rol a medida, desde 950 euros al mes · una persona da el visto bueno, siempre
ESCALÓN 3 · CEREBRO
todo desde una fuente
Jarvis: todas tus IA trabajan desde el mismo conocimiento de empresa La skill le enseña a la IA, el cerebro es donde vive la memoria. ¿Quieres que todas tus IA trabajen desde el mismo conocimiento de empresa? Eso es Jarvis, el cerebro de la organización. Conecta ChatGPT, Claude, Codex y a tu equipo con los mismos proyectos, el mismo conocimiento clave y las mismas decisiones, para que tu próxima sesión de IA no empiece de cero. Para el análisis de causas eso se nota especialmente: el análisis del mes pasado, la medida que salió de él y la verificación que lo acompañaba siguen ahí, así que puedes ver si un problema es realmente nuevo o si ya ha vuelto. El conocimiento de cada cliente se mantiene aislado y cada paso deja un rastro comprobable. Lo que eso da en la práctica, desde los planes hasta tu primera semana, lo lees en el propio Jarvis. entrada Brain Start: 9 euros al mes con IVA incl. · pagas por tu cerebro, no por pregunta a la IA
# no es un truco publicitario: el escalón 1 sigue siendo gratis y completo. Los siguientes escalones están ahí para quien quiera dejar este trabajo en otras manos.
~/skills/ai-5-waarom-analist/06-jarvis[ok]
Sección 06 · El cerebro

Lo que Jarvis da en concreto

reg. W.006

El escalón 3 merece más que un párrafo, porque esta es la diferencia entre un chat inteligente y un sistema sobre el que puedes construir. Jarvis es el cerebro de la organización: recuerda lo que tus IA deben saber, reparte el trabajo y registra lo que pasó. Precisamente en el análisis de causas eso cuenta, porque solo puedes responder si un problema vuelve si el análisis anterior sigue ahí. Lo notas ya desde el inicio de una sesión nueva.

FIG.05: Lo que una sesión recupera del cerebro[#####] hoja 5/5
jarvis · cerebro de la organización● sync
$jarvis recall "plazo presupuestos" # ejemplo esquemático
[clave]promesa a los clientes: respuesta en dos días laborables · las causas se formulan como proceso, nunca como persona
[decisión]análisis anterior: la causa raíz era la falta de responsable en los nuevos canales · aprobado por una persona
[tarea]verificación en curso: medir el plazo por paso · borrador de informe listo · espera visto bueno humano
[tarea]dos capas quedaron en hipótesis · sigue abierto: quién creó el correo y con qué intención
[log]sesión anterior: claude construyó la cadena, una persona corrigió la capa 3, resultado guardado
[ok]contexto cargado · esta sesión no empieza vacía
así recorre cada encargo el cerebro: registradocontexto determinadodelegadovisto bueno humanoguardado · el rastro completo está en jarvis/funcionamiento NL
contexto.conservado Tu próxima sesión no empieza de cero Hoy explicas cómo funciona tu proceso y qué cifras tienes, y mañana un chat suelto ya no sabe nada de eso. Con Jarvis, cada sesión empieza con los mismos proyectos, el mismo conocimiento clave y las decisiones anteriores, como en la FIG.05: primero recall, y solo después trabajar.
ia.conectada ChatGPT, Claude y Codex, una sola fuente Cada IA conectada trabaja desde el mismo conocimiento clave y los mismos acuerdos. Lo que registras y aprueba en una herramienta, lo usa también la otra. No explicas nada tres veces y no aparecen tres verdades distintas sobre la misma causa.
tareas.seguidas Tareas planificadas, seguidas, avisadas al terminar Un encargo se registra con objetivo y plazo, lo recoge el agente adecuado y avisa al terminar con el resultado. En el análisis de causas eso es justo lo que necesitas para el paso de verificación: si no, se queda siempre en el olvido.
todo.registrado Todo registrado y consultable Cada paso deja un rastro comprobable: quién preguntó qué, qué fuentes se usaron, qué agente trabajó en ello y quién dio el visto bueno. No porque tenga que ser así, sino porque de otro modo no puedes comprobar qué pasó en tu nombre.
humano.visto bueno Nada sale sin visto bueno La IA prepara, una persona decide. El resultado sigue siendo borrador hasta que alguien lo aprueba, y solo el conocimiento aprobado vuelve al cerebro. Ese límite vale en todo el sistema, también para el trabajo que un agente preparó por completo solo.
cerebro.aislado Cerebro de cliente aislado Si trabajas para varios clientes, el conocimiento de cada uno se mantiene estrictamente separado. Lo que aprendes para uno no se filtra en el trabajo para otro.
# LA PRUEBA HONESTA · SIN DEMO

Nosotros mismos llevamos meses funcionando con este sistema. Cada sesión de agente, cada tarea y cada decisión se registra y se puede volver a leer. Una sesión nueva, por eso, no empieza en blanco: primero recupera las decisiones registradas, los proyectos en curso y los últimos cambios, y sigue desde donde se quedó la anterior. Es decir, no describimos una promesa sino la forma de trabajar en la que nosotros mismos trabajamos a diario.

$ cat precios.mdpagas por tu cerebro, no por pregunta a la IA
Brain Start 9 € /mes con IVA 1 cerebro de organización · 1 usuario · 1 empleado de IA
Brain Solo 29 € /mes con IVA 1 cerebro de organización · 1 usuario · 3 empleados de IA
Brain Team 99 € /mes con IVA 1 cerebro de organización · 5 usuarios · 10 empleados de IA
Brain Business 249 € /mes con IVA 3 cerebros de organización · 20 usuarios · 50 empleados de IA

Consulta los cuatro planes en jarvis/precios NL. A través de la lista de espera NL solo indicas, sin compromiso, tu plan preferido. Eso todavía no crea ninguna cuenta, pedido ni obligación de pago. El trabajo a medida para empresas lo hablamos primero.

~/skills/ai-5-waarom-analist/07-analysekaart[ok]
Sección 07 · El mapa de análisis

Las skills que rodean esta

reg. W.007

Un análisis de causas rara vez va solo. Antes hay una elección sobre qué problema abordar, y después viene una decisión sobre qué hacer con él. Estas skills de la misma biblioteca cubren cada una un tramo distinto de esa cadena.

$ claude --interactief # siete preguntas, siete respuestas
DOC.07 · FAQ

Preguntas frecuentes

¿Cuánto cuesta la skill del Analista de los 5 Porqués?

Nada. La skill es gratis, cae bajo la licencia MIT y no necesitas crear ninguna cuenta ni dejar tu correo. Descargas un zip de 5,7 KB con una carpeta y un único archivo, SKILL.md, y eso es la skill completa. No hay versión de pago ni llega después ningún correo comercial.

¿El método de los 5 porqués es lo mismo que five whys o root cause analysis?

5 porqués, 5 whys, five whys y los cinco por qué son todos nombres de un mismo método. Root cause analysis es el término más amplio para análisis de causa raíz, y el método de los 5 porqués es una de sus formas más conocidas. El archivo responde a todos esos términos, además de causa raíz, RCA, análisis de causas, diagrama de espina de pescado, Ishikawa, análisis de incidentes y post mortem. Así que no necesitas saber cómo se llama el marco para que la skill se active.

¿Esta skill funciona también en Codex, Cursor o Gemini CLI?

Sí. SKILL.md es, desde diciembre de 2025, un estándar abierto, y por eso el mismo archivo funciona también en Codex, Cursor, Gemini CLI y otras herramientas que siguen ese estándar. En Codex, extraes el zip en .agents/skills/ dentro de tu proyecto, o en ~/.agents/skills/ para todos tus proyectos; Codex admite SKILL.md directamente desde el estándar abierto de diciembre de 2025. También puedes seguir poniendo el contenido de SKILL.md en tu AGENTS.md. Las instrucciones son simplemente texto legible, así que cualquier asistente de IA que acepte archivos de instrucciones puede usarlas.

¿Tiene que ser siempre exactamente cinco veces por qué?

No, y eso lo dice literalmente el archivo: cinco es una regla práctica, no un límite. La skill se detiene antes si ya has llegado a una causa sobre la que tienes influencia real y seguir preguntando solo da filosofía, y entonces indica que se detiene en la capa tres o cuatro, y por qué. Si la quinta capa sigue siendo un síntoma, continúa. En incidentes con impacto en seguridad o en lo financiero añade una capa extra sobre detección: por qué no se notó antes.

¿Qué pasa si la cadena de porqués acaba en una persona?

Entonces, según la skill, el análisis todavía no está terminado. Señalar a una persona como causa raíz está en la lista de cosas que la skill nunca hace. Las causas las escribe precisamente en voz pasiva para quitar de en medio la pregunta de la culpa: no fue Juan quien olvidó el control, sino que el control se saltó porque no había un campo obligatorio. Eric Ries llamó a esa trampa, en la que cada capa apunta a una persona, Five Blames, y la skill tiene un control aparte para eso.

¿Puede la skill evaluar un análisis de causas existente?

Sí. Si le pasas un análisis existente, recibes cinco cosas: un juicio por cada capa sobre si es una causa real o solo una reformulación de la capa anterior, una comprobación de culpa que marca cada capa que termina en una persona, una comprobación de pruebas que indica por cada capa qué datos la confirmarían, una comprobación de profundidad sobre si el análisis termina en la capa técnica, de proceso o de sistema, y una cadena reescrita con el arreglo directo y la medida estructural por separado.

¿Cuándo es mejor no usar el método de los 5 porqués?

No durante un incidente en curso: primero se apaga el fuego y después se analiza, y eso lo dice la skill misma. No en sesiones de brainstorming en las que precisamente quieres abrir opciones en vez de reducirlas a una causa. Tampoco para escribir textos. Y no para varios problemas a la vez, porque una de las reglas fijas es: un problema, una cadena.

$ cat 08-en-nu.md
DOC.08

De la causa a la medida

Un análisis afinado es la mitad. La otra mitad es que alguien se pone a trabajar en ello, y que en ocho semanas de verdad se comprueba si funcionó. Ahi es donde caen la mayoría de los análisis de causas: no en la lógica, sino en el seguimiento. Así que pon el paso de verificación en la misma agenda donde está el resto de tu trabajo, y acuerda de antemano qué resultado demuestra que tu análisis era erróneo. Esto último resulta incomodo, y justo por eso es útil.

Si el problema que investigas está en la entrada, en muy pocas solicitudes en vez de en el plazo posterior, el trabajo empieza en otro sitio: en que te encuentren las personas que te buscan. El análisis SEO gratis muestra en pocos segundos dónde está tu web. Y si quieres hablar sobre lo que la IA puede hacer más por tu empresa, desde skills sueltas hasta automatización completa, lo hacemos simplemente en una conversación.

Sección 08 · Siguiente pasodisponible 24/7
Programa una llamada NL
$ whoami
Gianluca, fundador
Escrito por GianlucaFundador. Construye desde 2017 visibilidad para empresas neerlandesas, en Google y en las respuestas de IA. Más sobre el instituto.