Recurso de la casa · Skill
Diagnóstico estructural: deja de parchear el mismo fallo
Una skill para Claude Code que te obliga a buscar el patrón detrás de un fallo repetido en vez de tapar el caso de turno.
Un archivo de texto, SKILL.md, dentro de un ZIP. Sin registro, instaladores ni código ejecutable.
- claude code
- skills
- arquitectura
- productividad
Para qué lo uso
La uso cuando un problema técnico o de arquitectura vuelve a aparecer después de haberlo «arreglado» antes: un bug que reaparece con otra cara, una auditoría de código, un post-mortem, o una decisión de diseño con muchas partes moviéndose. Cambia el modo de trabajo del parche rápido a entender primero qué está pasando de fondo.
El patrón, no el caso
La mayoría de los fallos de un sistema mediano no son incidentes sueltos: son familias que comparten causa. Cada parche tapa el caso y deja la fuente intacta, así que el fallo vuelve con otra cara la semana siguiente.
Esta skill cambia el orden de trabajo: primero qué clase de fallo es, después cómo se arregla.
- Patrón sobre parche: antes de proponer un arreglo, decidir si el caso es único o representante de una familia.
- Lo que el código obliga frente a lo que el documento aspira: solo lo primero sostiene un contrato.
- Los contratos implícitos entre subsistemas son bugs estructurales esperando a ocurrir.
- Fijar la fuente de verdad antes de diagnosticar, o el diagnóstico se apoya en aire.
Qué esperar de la respuesta
La skill pide evidencia antes de diagnosticar —archivos, registros, fechas, el arreglo anterior— y cita en concreto en vez de generalizar.
Separa lo que observa de lo que infiere y de lo que recomienda, dice qué se queda fuera del alcance y cierra con preguntas que desbloquean, no con un recetario cerrado. Si no hace eso, no la está aplicando.
Cómo se usa
- Descarga el ZIP y descomprímelo: dentro va un único archivo, SKILL.md.
- Colócalo en la carpeta de skills de tu herramienta: en Claude Code suele ser ~/.claude/skills/diagnostico-estructural/SKILL.md, o la carpeta de skills del proyecto si prefieres que solo aplique ahí.
- Actívala escribiendo /diagnostico-estructural, o deja que Claude Code la sugiera cuando detecte un fallo recurrente o una auditoría: el propio archivo describe cuándo entra y cuándo no.
- Dale al agente la evidencia que pida: archivos, registros, fechas, el arreglo anterior. Sin evidencia no hay diagnóstico, solo intuición con buena redacción.
Llévatelo
Un archivo de texto, SKILL.md, dentro de un ZIP. Sin registro, instaladores ni código ejecutable.