Communitygithub.com

Clasificación de Gravedad SEV

Clasifica la gravedad de incidentes (SEV1-4) usando señales de impacto, alcance y urgencia, y decide a quién notificar. Úsalo cuando una alerta se active o llegue un informe y se deba tomar una decisión rápida de gravedad.

¿Qué es Clasificación de Gravedad SEV?

Esta habilidad permite a agentes de IA (como Claude Code, Cursor, Codex) clasificar automáticamente la gravedad de incidentes en niveles SEV1 a SEV4 basándose en señales concretas de impacto, alcance y urgencia. Es útil para equipos de operaciones y SRE que necesitan tomar decisiones rápidas de notificación (paging) cuando se activa una alerta o se recibe un informe de incidencia. La habilidad evalúa señales como flujos de pago, autenticación o integridad de datos rotos, tasas de error por encima del umbral SLO, múltiples regiones afectadas, y riesgos de exfiltración de datos. También considera multiplicadores de alcance como el radio de explosión, la tasa de crecimiento del impacto y la latencia de detección. Define quién debe ser notificado en cada nivel (desde el comandante de incidentes y el equipo de ingeniería para SEV1 hasta solo un ticket para SEV4) y exige un registro de clasificación con justificación basada en la lista de verificación, el radio de explosión estimado, los notificados y un tiempo de reclasificación programado cada 30 minutos. El objetivo es evitar la clasificación por corazonada o retrasar la notificación mientras se investiga la causa raíz, priorizando el impacto actual sobre la causa.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/sev-triage

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Clasificación SEV

La gravedad es una decisión de notificación, no un medidor de emociones. Asigna el SEV más alto que justifique cualquier señal individual, luego reduce solo con evidencia.

Definiciones de Gravedad

  • SEV1 – Impacto en ingresos o pérdida total del servicio. Más del 5% de los usuarios no pueden completar un flujo crítico. Posible pérdida de datos o violación de seguridad. Notifica inmediatamente al IC (comandante de incidentes), líder de ingeniería y ejecutivo de guardia.
  • SEV2 – Degradación significativa. Función principal rota para un subconjunto, tasa de error elevada por encima del umbral de incumplimiento de SLO, o existe una solución alternativa pero inaceptable a largo plazo. Notifica al IC y al equipo de guardia en un plazo de 5 minutos.
  • SEV3 – Degradación parcial o menor. Función no crítica afectada, SLO aún dentro del presupuesto, sin escalaciones de clientes aún. Se crea un ticket, se notifica al equipo de forma asíncrona, solución antes del siguiente día hábil.
  • SEV4 – Cosmético o caso borde. Sin impacto para el usuario, detectado de forma proactiva. Solo ticket.

Lista de Verificación de Señales

Responde estas preguntas para determinar un SEV. El primer 'sí' que coincida gana.

  1. ¿Está roto un flujo de pago, autenticación o integridad de datos para algún usuario? -> Candidato a SEV1.
  2. ¿La tasa de error supera el umbral de SLO en los últimos 10 minutos? -> Mínimo SEV2.
  3. ¿Están afectadas múltiples regiones o zonas de disponibilidad? -> Escalar un nivel.
  4. ¿Existe riesgo activo de exfiltración o corrupción de datos? -> SEV1 independientemente del número de usuarios.
  5. ¿Un único endpoint no crítico es lento pero el resto funciona bien? -> SEV3.

Multiplicadores de Alcance

  • Radio de explosión: estima el porcentaje de usuarios afectados. Por debajo del 1% rara vez justifica SEV1 a menos que ese 1% sean clientes de pago o el riesgo de datos sea grave.
  • Tasa de crecimiento: ¿el impacto se está extendiendo? Un SEV3 que se duplica cada 10 minutos es un SEV2.
  • Retraso en la detección: si el problema comenzó hace más de 30 minutos sin ser detectado, asume que el radio de explosión es mayor de lo que muestran las señales actuales.

A Quién Notificar

  • SEV1: IC (comandante de incidentes), propietario del servicio, SRE de guardia y líder de ingeniería. Abre una sala de guerra de inmediato.
  • SEV2: IC y propietario del servicio de guardia. Invita a otros según sea necesario.
  • SEV3: Equipo de servicio de guardia de forma asíncrona. Sin sala de guerra.
  • SEV4: Ticket, sin notificación.

Ejemplo Práctico: Cómo Tomar la Decisión

Malo: "El pago parece estar roto para algunos usuarios. Se siente como un SEV3 – investigaré la causa primero y notificaré a alguien si resulta grave."

Bueno: "Tasa de error en el pago del 12% en los últimos 15 minutos (umbral SLO: 1%). Flujo de pago roto -> señal 1 -> SEV1. Notifiqué al IC, propietario del servicio y SRE de guardia a las 14:32; sala de guerra abierta. Estimación del radio de explosión: ~12% de los intentos de pago, crecimiento poco claro. Causa desconocida – irrelevante para el SEV. Reclasificación a las 15:00."

La versión mala invierte el orden (causa antes que gravedad), duda sobre un flujo de pago roto y retrasa la notificación. La versión buena cita la señal que estableció el nivel, notifica de inmediato, registra el radio de explosión y programa la reclasificación – todo antes de que alguien sepa por qué se rompió.

Resultado Esperado

Produce un registro de clasificación – publicado en el canal de incidentes o en el ticket – que contenga: el SEV asignado, una justificación de una línea que nombre la señal de la lista de verificación que lo estableció, la estimación del radio de explosión (porcentaje de usuarios o solicitudes), quién fue notificado y cuándo, y la hora programada de reclasificación. El registro permite que el siguiente respondedor confíe en el nivel en lugar de tener que deducirlo de nuevo.

Estándar de Calidad

  • El SEV se asignó a partir de señales de impacto antes de iniciar cualquier investigación de causa raíz.
  • La justificación nombra una señal específica de la lista de verificación, no una corazonada.
  • La notificación ocurrió en el momento de la asignación, no después de la confirmación – un posible SEV1 notifica con un solo dato.
  • Se establece un tiempo de reclasificación (cada 30 minutos) y el nivel se mueve con la evidencia, tanto hacia arriba como hacia abajo.

Hacer / No Hacer

  • Hacer: asignar SEV antes de investigar la causa raíz. La gravedad se trata del impacto actual, no de la causa.
  • Hacer: reclasificar cada 30 minutos. Un SEV2 resuelto es un SEV4; un SEV3 que se expande es un SEV1.
  • No hacer: subestimar el SEV para evitar despertar a personas. Los falsos SEV1 son más baratos que los SEV1 perdidos.
  • No hacer: esperar un segundo dato antes de notificar en un posible SEV1.

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

SkillMedev/skills

Designs REST API surfaces - resource naming, HTTP method and status-code semantics, error shapes, pagination, and filtering - and delivers an endpoint spec a consumer can build against without asking questions. Use when someone asks "how should I name this endpoint", "what status code should this return", "should this be PUT or PATCH", "how do I paginate this list", or is reviewing an API before it ships to external consumers. Do NOT use for planning breaking-change rollouts and deprecation windows - use api-versioning-strategist instead; for GraphQL type and resolver design - use graphql-schema instead; for generating client SDKs from an existing spec - use api-client-generator instead; for designing inbound webhook endpoints - use webhook-receiver-hardener instead.

SkillMedev/skills

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video's audio - transcribing or aligning to the voiceover script, timing cues to speech, and enforcing line-length and reading-speed rules so captions are readable and in sync. Use when someone says "generate captions", "make subtitles from the audio", "transcribe and caption this", "export an SRT or VTT", "the captions are out of sync", or "the subtitles flash by too fast to read". Do NOT use to burn-in, style, reframe, or position an existing caption track for a platform (9:16, brand styling, safe areas) - that is social-video-formatter; do NOT use to animate text word-by-word as a motion graphic - that is kinetic-typography; do NOT use to write the spoken script in the first place - that is narration-script.

SkillMedev/skills

Turns data and charts into a decision-driving narrative structured as headline finding, trend, implication, and recommended action - with finding-led chart titles, context for every number, annotation guidance, and honest flags on any conclusion the data cannot support. Use when someone says "turn these numbers into a story", "what's the takeaway from this data", "help me present these results to leadership", or has charts but no narrative. Do NOT use for compressing a long document into a one-pager - use executive-summary instead - or for running the analysis that produces the findings - use eda-playbook instead.

SkillMedev/skills

Use when a task needs live or historical money data - "convert USD to EUR", "current/past exchange rate", "FX rate on this date / over this range", or "current price of Bitcoin/Ethereum, market cap, 24h change". Frankfurter (ECB reference rates, no key) is the FX default; CoinGecko's free keyless tier covers crypto. Do NOT use for stock quotes or equities - no keyless stock API survives verification, say so instead of guessing; do NOT use for country economic indicators like GDP or inflation series - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Builds a driver-based FP&A operating model linking business inputs to P&L, balance sheet, and cash flow outputs. Use when building an annual plan, preparing investor materials, running scenario analysis, or stress-testing the business.

SkillMedev/skills

Use when a task needs live geographic lookups - "geocode this address", "what's at these coordinates" (reverse geocoding), "lat/lon for this city", "which country/state is this ZIP or postal code in", or "country facts: capital, currency, population, flag". Nominatim (OpenStreetMap) is the geocoding default; Zippopotam for postal codes; APICountries for country facts. All keyless. Do NOT use for weather at a location - use weather-climate instead; do NOT use for country-level statistics over time (GDP, population trends) - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Runs the full Getting Things Done loop - capture, clarify, organize, reflect, engage - building a trusted system of context lists, a projects list with defined next actions, and a weekly review habit. Use when someone says "I'm overwhelmed and things are slipping through the cracks", "set up GTD for me", "help me do a brain dump and organize it", or "my to-do list is a mess". Do NOT use for just running the weekly review ritual itself - use weekly-review instead - or for clearing an email backlog - use inbox-zero.

SkillMedev/skills

Processes any email backlog to zero using the 4Ds - Delete, Delegate, Defer, Do - with a mass-archive strategy for the obvious, a touch-each-email-once discipline, and a keep-it-clear system of batched processing windows, ruthless unsubscribing, filters, and a minimal folder setup. Use when someone says "I have 5,000 unread emails", "help me get to inbox zero", "email is eating my whole day", or treats their inbox as a to-do list. Do NOT use for drafting the reply emails themselves or prioritization rules for an ongoing support queue - use email-triage instead - or for protecting focus time around the email windows - use deep-work-planner instead.

SkillMedev/skills

Write landing-page copy section by section - hero, social proof, features-as-benefits, objections, CTA - leading with one promise and proving it down the page. Use when someone asks "write my landing page", "improve my hero headline", "what should the homepage say", "turn these features into benefits", or is shipping a new page for a launch or campaign. Do NOT use for testing and optimizing an existing page's conversion rate - use landing-page-cro instead; for the one-line claim itself use positioning-statement; for the full message ladder use messaging-hierarchy.

SkillMedev/skills

Improves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer instead.

SkillMedev/skills

Runs structured coaching sessions using values clarification and the GROW model, ending every session with one committed action, a deadline, and an if-then plan for the likely obstacle. Use when someone says "I feel stuck in my life", "help me figure out what I want", "hold me accountable to my goals", or "coach me through this decision". Do NOT use for building a stress toolkit - use stress-management instead - or a journaling practice - use journal-framework; for a standing goal-tracking system, use goals-accountability. Coaching, not therapy: signs of clinical distress route to a licensed professional.

SkillMedev/skills

Adapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.

SkillMedev/skills

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says "build a 20-second product demo video", "animate a feature walkthrough", "write the Remotion code for this marketing clip", or wants a scene-by-scene composition they can scrub in Studio. Do NOT use for rendering, iterating, or batching the finished MP4 - use remotion-render instead - or for installing and scaffolding the project - use remotion-setup instead.

SkillMedev/skills

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just "make product videos with Claude.

SkillMedev/skills

Use the Skill Me catalog from inside any conversation - discover, install, and manage Claude skills through the Skill Me MCP, and load installed skills automatically each session.

SkillMedev/skills

Write one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.

SkillMedev/skills

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says "make this vertical", "crop to 9:16", "format for TikTok/Reels/Shorts", "add captions/subtitles", "why is my video cut off on mobile", "resize for Instagram", or "export for social". Do NOT use when the question is about the storyboard or shot order before any video exists (use video-storyboard); the animation craft of how elements move (use motion-design-principles); animated word-by-word caption styling (use kinetic-typography); palette, contrast, or lighting (use motion-color-and-light); directing the product-demo content and screen choreography (use product-demo-director); or scoring, beat-syncing, or audio (use sound-and-music-sync) - this is the craft layer that decides WHAT to format for the feed, then hands a concrete spec to remotion-compo...

SkillMedev/skills

Writes and tunes PySpark jobs - join strategy and broadcast size limits, shuffle-partition sizing, skew diagnosis and salting, UDF avoidance, caching, and output file layout - with concrete size and skew thresholds. Use when someone asks "why is my Spark job slow", "should I broadcast this join", "one task takes forever while the rest finish", "my job OOMs during a join", or is writing a new PySpark ETL job. Do NOT use for Kafka topic, consumer-group, or streaming-pipeline design - use kafka-pipelines instead; do NOT use for single-machine dataframe work that fits in memory - use pandas-expert instead.

SkillMedev/skills

Builds clean, performant, accessible SwiftUI views with correct state ownership, scoped invalidation, and smooth list scrolling, and reviews existing SwiftUI code against a concrete frame-time and re-render budget. Use when someone asks "why does my SwiftUI list stutter", "should this be @State or @Observable", "my whole screen re-renders when one row changes", "how do I animate this transition", or wants a SwiftUI view built or refactored. Do NOT use for cross-platform React Native apps - use react-native-pro instead; do NOT use for Flutter widget trees - use flutter-widget-architect instead; do NOT use for Android Compose UIs - use jetpack-compose-builder instead.

Skills relacionados