postmortem-writing
por wshobsonpostmortem-writing ayuda a los equipos a crear postmortems de incidentes sin culpabilizar, con cronologías, análisis de causa raíz, factores contribuyentes, impacto y acciones de seguimiento para documentar fallos o cuasiincidentes.
Esta skill obtiene 78/100, lo que la convierte en una opción sólida dentro del directorio para quienes buscan ayuda estructurada para elaborar postmortems de incidentes sin culpabilizar. La evidencia del repositorio muestra contenido de flujo de trabajo sustancial, desencadenantes de uso claros y orientación práctica que debería ayudar a un agente a rendir mejor que con un prompt genérico, aunque su adopción se ve moderada por la falta de archivos de apoyo, plantillas o artefactos ejecutables.
- Activación clara: la descripción y la sección "When to Use This Skill" cubren explícitamente revisiones de incidentes, documentos de postmortem, reuniones sin culpabilizar, análisis de causa raíz y acciones de seguimiento.
- Contenido operativo sustancial: el archivo `SKILL.md` es extenso y está bien estructurado, con muchos encabezados y elementos concretos como desencadenantes para el postmortem y una cronología de inicio rápido día por día.
- Buena ventaja para el agente frente a un prompt genérico: incorpora principios específicos de postmortem, como el enfoque sin culpabilizar y las preguntas orientadas a la causa raíz, lo que aporta una estructura de dominio reutilizable.
- Toda la orientación parece concentrarse en un único archivo markdown, sin plantillas, referencias, scripts ni artefactos de ejemplo, por lo que los agentes quizá aún deban inferir detalles del formato de salida.
- La evidencia del repositorio muestra una señalización explícita limitada sobre flujos de trabajo y restricciones en relación con el tamaño del documento, lo que puede hacer que la ejecución sea menos predecible en distintos entornos de incidentes.
Visión general de la skill postmortem-writing
Qué hace postmortem-writing
La skill postmortem-writing ayuda a un agente a producir postmortems de incidentes estructurados y sin culpabilización, incluyendo las partes que los equipos suelen olvidar bajo presión: una cronología clara, análisis de causa raíz, factores contribuyentes, impacto y acciones de seguimiento concretas. Está pensada para redactar informes después de caídas, degradaciones del servicio, cuasiincidentes, problemas de datos u otros incidentes que merecen aprendizaje organizacional, no solo un resumen improvisado.
Quién debería instalar postmortem-writing
Esta skill encaja especialmente bien para:
- equipos de SRE, DevOps, plataforma y respuesta a incidentes
- managers de ingeniería que necesitan informes de incidentes consistentes
- personas encargadas de redactar entregables internos después de una caída
- equipos que quieren pasar de retrospectivas centradas en la culpa a un enfoque de pensamiento sistémico
Si tu trabajo consiste sobre todo en convertir notas desordenadas de un incidente en un postmortem útil, postmortem-writing es más específico y adecuado que un prompt genérico de escritura.
La necesidad real que resuelve
La mayoría de los usuarios no necesita ayuda para “escribir un documento” en abstracto. Necesita ayuda para convertir logs, hilos de chat, alertas y recuerdos parciales en un informe que:
- explique qué pasó en lenguaje claro
- preserve la secuencia cronológica
- separe la causa raíz de los factores contribuyentes
- evite culpar a personas concretas
- termine con acciones que realmente se puedan seguir
Ese es el valor práctico de la skill postmortem-writing.
Qué diferencia a esta skill de un prompt normal
La diferencia principal no es una automatización sofisticada. Es la estructura editorial y la disciplina de revisión de incidentes. El material fuente pone el foco en:
- un enfoque sin culpabilización
- criterios explícitos para decidir cuándo corresponde un postmortem
- un flujo de trabajo que empieza por la cronología
- análisis de causa raíz por encima de los síntomas superficiales
- acciones como producto final, no como idea de último momento
Eso hace que la postmortem-writing skill sea útil cuando buscas consistencia y un lenguaje más seguro, no solo una prosa pulida.
Lo que conviene saber antes de adoptarla
Esta skill está orientada primero a la documentación. La evidencia del repositorio muestra solo SKILL.md, sin scripts auxiliares, esquemas ni archivos de referencia. Eso significa que postmortem-writing install es sencillo, pero la calidad de la salida depende en gran medida de los datos del incidente que proporciones. Si esperas recopilación automática de evidencias o creación de tickets, esta skill no lo hará por sí sola.
Cómo usar la skill postmortem-writing
Contexto de instalación de postmortem-writing
Instálala desde el repositorio principal de skills:
npx skills add https://github.com/wshobson/agents --skill postmortem-writing
Como la skill vive en plugins/incident-response/skills/postmortem-writing, lo que estás instalando es un flujo de trabajo de redacción y una capa de guía, no una plataforma de gestión de incidentes independiente.
Lee primero este archivo
Empieza por:
SKILL.md
No hay resources/, rules/ ni scripts de apoyo visibles para esta skill, así que la forma más rápida de revisar el repositorio es leer SKILL.md de principio a fin. Aquí eso importa porque el valor está en la guía de proceso y en el enfoque, no en el código.
Cuándo conviene invocar postmortem-writing
Usa postmortem-writing usage cuando ya sepas que un incidente merece un informe formal, especialmente en casos como:
- incidentes SEV1 o SEV2
- caídas visibles para clientes que duren más que un simple parpadeo
- pérdida de datos o incidentes de seguridad
- cuasiincidentes con alto potencial de severidad
- fallos novedosos o intervenciones operativas poco habituales
Si el evento fue menor y no hace falta aprendizaje ni remediación, puede bastar con una nota breve del incidente.
Qué entradas necesita la skill
La skill funciona mejor cuando le das material bruto del incidente, no solo “escribe un postmortem”. Entre las entradas útiles están:
- resumen del incidente
- hora de inicio y de fin
- impacto en clientes o sistemas
- cronología de eventos clave
- método de detección
- pasos de mitigación
- causa raíz sospechada
- factores contribuyentes conocidos
- preguntas no resueltas
- acciones de seguimiento ya discutidas
Cuanto más precisa sea tu cronología, mejor será el informe final.
Cómo convertir una petición vaga en un prompt sólido
Prompt débil:
- “Write a postmortem for yesterday’s outage.”
Prompt sólido:
- “Use the postmortem-writing skill to draft a blameless postmortem for a 47-minute API outage on 2025-02-10. Include a minute-by-minute timeline, impact summary, root cause, contributing factors, what detection missed, and action items grouped by prevention, detection, and response. Mark uncertainties clearly instead of inventing details.”
Por qué esto es mejor:
- define el alcance del incidente
- pide explícitamente un enfoque sin culpabilización
- solicita secciones importantes que suelen faltar
- permite expresar incertidumbre en vez de fingir certeza
Una plantilla de prompt práctica
Usa una estructura de prompt como esta:
- Tipo de incidente: outage, degradation, security event, data incident, near-miss
- Severidad: nivel SEV o equivalente
- Ventana temporal: inicio, detección, mitigación, resolución
- Impacto: usuarios, ingresos, requests, datos, operaciones internas
- Evidencia: logs, alerts, notas de chat, extractos de tickets
- Causa sospechada: qué falló y por qué
- Factores contribuyentes: tooling, proceso, carga, config, staffing, dependencias
- Salida deseada: executive summary, timeline, RCA, lessons learned, action items
- Restricción de tono: sin culpabilización, factual, no culpar por nombre a personas
- Desconocidos: enuméralos de forma explícita
Es la forma más rápida de mejorar postmortem-writing for Report Writing.
Flujo de trabajo recomendado para incidentes reales
Un flujo que funciona bien es:
- Reunir los hechos en bruto a partir de notas del incidente y evidencias del sistema.
- Pedir a la skill un primer borrador estructurado.
- Revisar la cronología para detectar errores de secuencia.
- Ajustar mejor la causa raíz frente a los factores contribuyentes.
- Eliminar redacciones orientadas a la culpa.
- Añadir acciones con responsables y fechas fuera del borrador si hace falta.
- Usar el informe final en la reunión de postmortem.
Esta secuencia refleja cómo trabajan los equipos en la práctica tras un incidente: primero los hechos, después la interpretación y por último la remediación.
Cómo conseguir cronologías mejores
La calidad de la cronología suele determinar si el documento transmite confianza. Dale a la skill viñetas con marcas de tiempo como:
09:14 UTC: latency alert fired09:16 UTC: on-call acknowledged09:21 UTC: deploy rollback started09:37 UTC: error rate returned to baseline
Sin esto, incluso una buena postmortem-writing guide no puede reconstruir la causalidad de forma fiable.
Cómo pedir un mejor análisis de causa raíz
No pidas solo “la causa raíz”. Pide:
- causa inmediata
- factores sistémicos más profundos
- por qué fallaron las salvaguardas
- por qué la detección o el escalado llegaron tarde
- qué hizo posible el fallo
Así evitas que la salida se quede en algo como “hubo un mal deploy”, que normalmente es demasiado superficial para resultar útil.
Cómo mantener el informe sin culpabilización
La skill pone de forma explícita el foco en una cultura sin culpa. Refuérzalo en tu prompt:
- pídele que se centre en las condiciones del sistema, no en la culpa individual
- solicita un lenguaje neutral
- pide que separe las acciones humanas del contexto organizativo y técnico
Por ejemplo, es preferible:
- “The deployment process allowed an unsafe config change to reach production”
a: - “An engineer pushed the wrong setting”
Lo que esta skill no ofrece
La postmortem-writing skill no parece incluir:
- recopilación automática de datos
- extracción automática de cronologías desde herramientas
- sincronización con tickets
- lógica de clasificación de severidad más allá de orientación general
- plantillas específicas de la organización listas para usar
Cuenta con aportar tu propio contexto y adaptar la salida a tu programa de gestión de incidentes.
Preguntas frecuentes sobre la skill postmortem-writing
¿postmortem-writing es mejor que un prompt normal de LLM?
Normalmente sí, si tu problema principal es la estructura y la disciplina. Un prompt normal puede generar un postmortem, pero a menudo omite los criterios para abrirlo, el enfoque sin culpabilización o la diferencia entre causa raíz y factores contribuyentes. postmortem-writing le da al agente un patrón de trabajo más claro.
¿Es adecuada para principiantes?
Sí. Es apta para principiantes porque está muy orientada a la guía y no requiere tooling personalizado. Aun así, quien empieza debe aportar el registro factual del incidente. La skill mejora la calidad de la redacción y la estructura de revisión; no sustituye la investigación del incidente.
¿Cuándo no debería usar postmortem-writing?
Mejor omítela cuando:
- el evento no justifica un postmortem completo
- necesitas un incident commander en tiempo real, no una herramienta de redacción
- aún no tienes los hechos básicos y sigues depurando activamente
- tu organización necesita una plantilla propietaria estricta que esta skill no puede reproducir sin una adaptación importante
¿postmortem-writing sirve solo para caídas de ingeniería?
No. Está mejor alineada con incidentes técnicos, pero el marco también encaja con incidentes de seguridad, problemas de datos, fallos operativos y cuasiincidentes serios, siempre que puedas aportar una cronología, impacto y acciones correctivas.
¿Puedo usar postmortem-writing para resúmenes ejecutivos?
Sí, pero no te quedes solo con eso. La dirección suele necesitar un resumen breve, mientras que quienes respondieron al incidente necesitan la cronología completa y el plan de acción. Pide a la skill que genere tanto un resumen conciso como el informe completo.
¿La skill ayuda con las acciones de seguimiento?
Sí, de forma indirecta. La guía fuente enfatiza acciones posteriores que se puedan ejecutar. Obtendrás mejores resultados si pides acciones agrupadas por categoría, como prevención, detección, respuesta y mejora de procesos.
Cómo mejorar la skill postmortem-writing
Dale a postmortem-writing mejor evidencia, no solo mejores instrucciones
La mayor palanca de calidad está en la fidelidad de las entradas. Pega:
- marcas de tiempo
- métricas de impacto al cliente
- nombres de alertas
- pasos de mitigación
- incógnitas conocidas
La evidencia rica vale más que las meta-instrucciones elaboradas.
Separa los hechos de la interpretación
Un fallo común es mezclar suposiciones dentro de la cronología. Proporciona dos bloques:
- hechos confirmados
- hipótesis o preguntas abiertas
Esto ayuda a que postmortem-writing usage se mantenga preciso y, al mismo tiempo, deje visibles las incertidumbres.
Pide explícitamente las secciones que faltan
Si el primer borrador queda demasiado genérico, solicita por nombre las secciones que faltan:
- “Add a ‘What went well’ section”
- “Separate contributing factors from root cause”
- “Rewrite action items so each is specific and testable”
Las peticiones de revisión concretas mejoran los resultados más rápido que un simple “hazlo mejor”.
Evita acciones de seguimiento superficiales
Los postmortems flojos suelen terminar con acciones vagas como “improve monitoring”. Pide a la skill que haga cada acción:
- específica
- asignable
- vinculada a un modo de fallo
- medible o comprobable
Por ejemplo:
- “Add an alert for queue lag over 5 minutes in region us-east-1”
es mejor que: - “Improve alerting”
Vigila que la culpa no vuelva a colarse
Incluso con una skill sin culpabilización, el material fuente de chats o notas puede incluir lenguaje cargado de culpa. Revisa formulaciones que se centren demasiado en una persona en vez de en las condiciones del sistema, los incentivos, el tooling, los huecos de revisión o el contexto operativo.
Itera en dos pasadas para obtener mejor calidad
Un patrón fiable es:
- primera pasada para la estructura factual
- segunda pasada para el análisis y las acciones
Así evitas forzar al modelo a inventar un razonamiento pulido antes de que la cronología sea estable.
Adapta la salida al nivel de madurez de postmortems de tu equipo
Si tu equipo está en una etapa temprana, pide a postmortem-writing un formato sencillo con cronología, impacto, causas y acciones. Si tu equipo tiene más madurez, pide secciones más profundas como brechas de detección, eficacia del escalado, tradeoffs durante la recuperación y aprendizajes sistémicos. La misma skill puede servir para ambos casos, pero solo si fijas la profundidad esperada.
Mejora los resultados de redacción de informes después del primer borrador
Para obtener mejores resultados con postmortem-writing for Report Writing, haz una revisión final con estas cuatro preguntas:
- ¿Una persona nueva en el equipo entendería qué pasó?
- ¿La cronología es lo bastante precisa como para auditarla?
- ¿El análisis explica por qué fallaron las defensas?
- ¿Las acciones son lo bastante concretas como para reducir la recurrencia?
Si alguna respuesta es no, revisa el prompt apuntando a ese hueco en lugar de relanzarlo a ciegas.