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.