Stats
Actions
Tags
From np-troubleshooting
Use when the user asks to investigate, diagnose, look at, check, or troubleshoot any nullplatform entity (deployments, scopes, services, applications, builds, releases). Also use when the user mentions problems, errors, failures, or unhealthy states in nullplatform.
How this skill is triggered — by the user, by Claude, or both
Slash command
/np-troubleshooting:np-investigation-diagnosticThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Skill para investigar y diagnosticar problemas en nullplatform.
Skill para investigar y diagnosticar problemas en nullplatform.
Este skill orquesta el uso de dos skills especializados:
| Skill | Propósito | Invocación |
|---|---|---|
np-api | Estado actual de entidades | Skill tool: np-api |
np-audits-read | Historial de cambios (audit trail) | Skill tool: np-audits-read |
SIEMPRE invocar AMBOS skills al inicio de una investigación.
No uses uno sin el otro. La API da el estado actual, la auditoría da el historial. Ambos son necesarios para un diagnóstico completo.
Este skill es SOLO LECTURA - diagnóstico, no fixes.
| Permitido | Prohibido |
|---|---|
| Consultar estado de entidades | Modificar entidades |
| Obtener historial de cambios | Crear/eliminar recursos |
| Generar reportes | Ejecutar acciones |
| Analizar datos | Cambiar configuraciones |
1. INTAKE → 2. CONTEXTO → 3. ESTADO ACTUAL → 4. HISTORIAL → 5. ANÁLISIS → 6. REPORTE
Objetivo: Entender qué se está investigando.
Recopilar del usuario:
| Dato | Pregunta |
|---|---|
| ID de entidad | ¿Cuál es el ID? |
| Tipo de entidad | ¿Es un deployment, scope, service, application? |
| Síntomas | ¿Qué error o problema observas? |
| Timeline | ¿Cuándo empezó? ¿Es intermitente o constante? |
| Impacto | ¿Qué está afectando? ¿Producción? |
Si falta información: Preguntar antes de continuar.
Objetivo: Entender dónde vive la entidad.
Usar: np-api
Obtener:
Preguntas a responder:
Objetivo: Saber cómo está la entidad AHORA.
Usar: np-api
Obtener:
Preguntas a responder por tipo de entidad:
Objetivo: Saber QUÉ PASÓ y QUIÉN lo hizo.
Usar: np-audits-read
Obtener:
Preguntas a responder:
Objetivo: Correlacionar toda la información.
Actividades:
Patrones comunes a buscar:
| Patrón | Indicadores |
|---|---|
| Configuración incorrecta | Parámetros enviados vs esperados |
| Timeout | Mucho tiempo entre creación y fallo |
| Permisos | Errores 403, intentos rechazados |
| Intervención manual | PATCH para marcar como failed |
| Inconsistencia de datos | Diferentes valores en diferentes fuentes |
Objetivo: Documentar los hallazgos.
Usar el template de reporte (ver abajo).
# {Tipo Entidad} {ID}
## {Resumen del problema}
| Campo | Valor |
|-------|-------|
| **Entidad** | {tipo} {id} |
| **Estado** | {status} |
| **Fecha investigación** | {hoy} |
---
## Resumen Ejecutivo
{2-3 oraciones describiendo qué pasó y por qué}
---
## Diagrama de Contexto
{Diagrama ASCII mostrando la jerarquía organizacional y entidades relacionadas}
---
## Timeline de Eventos
| Fecha/Hora | Evento | Usuario | Status |
|------------|--------|---------|--------|
| {timestamp} | {qué pasó} | {quién} | {resultado} |
---
## Hallazgos Clave
1. {Hallazgo principal}
2. {Hallazgo secundario}
3. {Hallazgo adicional}
---
## Causa Raíz
{Explicación de por qué ocurrió el problema}
---
## Usuarios Involucrados
| Usuario | Email | Acciones |
|---------|-------|----------|
| {nombre} | {email} | {qué hizo} |
---
## Recomendaciones
| Prioridad | Acción |
|-----------|--------|
| Alta | {acción inmediata} |
| Media | {acción correctiva} |
| Baja | {mejora preventiva} |
| Icono | Significado |
|---|---|
| ✅ | OK / Correcto |
| ⚠️ | Warning / Revisar |
| ❌ | Error / Fallido |
| 🔄 | En progreso |
| 💥 | Causa raíz |
| 💡 | Insight |
| 👤 | Usuario |
Antes de finalizar, verificar:
np-api?np-audits-read?npx claudepluginhub nullplatform/ai-plugins --plugin np-troubleshootingDiagnoses production incidents by detecting environment, gathering symptoms, reading logs with Grep/Bash, checking metrics, tracing requests to find root causes and propose fixes with rollbacks.
Orchestrates SRE incident response on Google Cloud Platform. Starts outage investigation, maps architecture via gcp-architecture-discovery, and coordinates GKE/Cloud Run mitigation.
Incident response — diagnose production issues, find root cause, propose fix with rollback. Use when asked about "something is broken", "production issue", "why is this down", "incident", or "debug production".