cs-health-scorecard · diff
git:20260702.b8fb11d to git:20261011.3fb211c
84 added, 59 removed. Audit A to A.
---
# machine-translated to es from skills/cs-health-scorecard/SKILL.md — review: pending. Native fixes welcome via PR.
name: cs-health-scorecard
- description: "Construir un cuadro de mando de salud del cliente para una cuenta específica. Úsalo cuando se te pida puntuar la salud de la cuenta, evaluar el riesgo de renovación, construir un panel de salud, o valorar la probabilidad de que una cuenta se renueve o expanda. Produce un cuadro de mando de salud estructurado con estado RAG, puntuaciones por dimensión, riesgos clave y acciones recomendadas."
+ description: "Construir un cuadro de mando de salud del cliente para una cuenta específica. Úsalo cuando te pidan calificar la salud de la cuenta, evaluar el riesgo de renovación, construir un panel de salud o evaluar la probabilidad de que una cuenta se renueve o expanda. Produce un cuadro de mando de salud estructurado con estado RAG, puntuaciones de dimensiones, riesgos clave y acciones recomendadas."
---
# Skill de Cuadro de Mando de Salud del Cliente
- Produce un cuadro de mando de salud estructurado y basado en datos para una cuenta de cliente — proporcionando al CSM y a la dirección una visión clara del riesgo de renovación, potencial de expansión, y las acciones necesarias para mover la cuenta en la dirección correcta.
+ Produce un cuadro de mando de salud estructurado e impulsado por datos para una cuenta de cliente, dando al CSM y la dirección una vista clara del riesgo de renovación, potencial de expansión y las acciones necesarias para mover la cuenta en la dirección correcta.
## Lee desde / Escribe en el Brain
- Si existe un [`professional-brain`](../professional-brain/SKILL.md) (`brain/`), utiliza la información en lugar de volver a preguntar lo que ya sabes:
+ Si existe un [`professional-brain`](../professional-brain/SKILL.md) (`brain/`), usa la información disponible en lugar de volver a preguntar lo que ya sabes:
- - **Lee primero:** el archivo `entities/` de la cuenta, sus `stakeholders/` (campeón, comprador económico, detractores) y `knowledge/`. Ejecuta `python3 ../professional-brain/scripts/brain_query.py ./brain "<nombre de cuenta>"` y mantén la etiqueta de procedencia de cada hecho.
- - **📥 Propón al Brain:** después de producir, propón registrar el veredicto de salud + riesgos clave en el archivo `entities/` de la cuenta, y una entrada de riesgo de renovación en `decisions/` si se toma una decisión, cada una con etiqueta de procedencia. Muéstralas, obtén un sí, y luego escribe con `../professional-brain/scripts/brain_write.py … --commit` (solo append, dry-run por defecto).
+ - **Lee primero:** el archivo `entities/` de la cuenta, sus `stakeholders/` (campeón, comprador económico, detractores) y `knowledge/`. Ejecuta `python3 ../professional-brain/scripts/brain_query.py ./brain "<nombre de la cuenta>"` y transmite cada etiqueta de procedencia del hecho.
+ - **📥 Propón al Brain:** después de producir, propón registrar el veredicto de salud + riesgos clave en el archivo `entities/` de la cuenta, y una entrada de riesgo de renovación en `decisions/` si se toma una decisión, cada una etiquetada con procedencia. Muéstrales, obtén un sí, luego escribe con `../professional-brain/scripts/brain_write.py … --commit` (solo adjuntar, seco por defecto).
## Entradas Requeridas
- Pregunta por estas si no se proporcionan ya:
- - **Nombre de la cuenta** y tier (enterprise / mid-market / SMB)
+ Pide estas si no se proporcionan ya:
+ - **Nombre de la cuenta** y nivel (enterprise / mid-market / SMB)
- **Valor del contrato** (ARR) y **fecha de renovación**
- - **Datos de uso del producto** — logins, ratio DAU/MAU, adopción de funcionalidades clave
- - **Datos de soporte** — tickets abiertos, puntuación CSAT o NPS, escalaciones recientes
+ - **Datos de uso del producto** — inicios de sesión, ratio DAU/MAU, adopción de características clave
+ - **Datos de soporte** — tickets abiertos, puntuación CSAT o NPS, escaladas recientes
- **Datos de engagement** — fecha del último QBR, estado del patrocinador ejecutivo, nombre del campeón
- - **Datos comerciales** — historial de pagos, conversaciones de expansión, puestos utilizados vs. licenciados
+ - **Datos comerciales** — historial de pagos, conversaciones de expansión, asientos usados vs. licenciados
- **Cualquier riesgo conocido o cambio reciente** en la cuenta
## Marco de Puntuación
- Puntúa cada dimensión de 1 a 5. Pondera según se muestra. Calcula el total ponderado sobre 100.
+ Puntúa cada dimensión del 1 al 5. Pondera como se muestra. Calcula el total ponderado sobre 100.
- | Dimensión | Ponderación | Qué Puntuar |
+ | Dimensión | Peso | Qué Puntuar |
|---|---|---|
- | **Adopción del Producto** | 30% | Ratio DAU/MAU, amplitud de funcionalidades utilizadas, usuarios avanzados identificados |
+ | **Adopción de Producto** | 30% | Ratio DAU/MAU, amplitud de características utilizadas, usuarios avanzados identificados |
| **Engagement** | 20% | Cadencia de QBR, patrocinador ejecutivo activo, fortaleza del campeón |
| **Resultados** | 20% | Cliente logrando sus objetivos declarados / métricas de éxito |
- | **Salud del Soporte** | 15% | Tendencia en volumen de tickets, escalaciones sin resolver, CSAT |
- | **Comercial** | 15% | Pagos a tiempo, puestos utilizados, señales de expansión |
+ | **Salud del Soporte** | 15% | Tendencia de volumen de tickets, escaladas sin resolver, CSAT |
+ | **Comercial** | 15% | Pagos puntuales, asientos utilizados, señales de expansión |
**Conversión Puntuación → RAG:**
- 80–100: Verde (saludable, renovación probable)
- - 60–79: Ámbar (en riesgo, requiere atención)
- - 0–59: Rojo (alto riesgo de churn, escalar)
+ - 60–79: Ámbar (en riesgo, necesita atención)
+ - 0–59: Rojo (riesgo alto de churn, escalar)
- ## Helper Programático
+ ## Ayudante Programático
- Este skill incluye un script Python que solo utiliza stdlib y aplica las ponderaciones anteriores y convierte el total ponderado a estado RAG — para que la puntuación titular se calcule idénticamente cada vez y las ponderaciones siempre sumen 100%.
+ Este skill incluye un script de Python que usa solo la biblioteca estándar y aplica los pesos anteriores, convirtiendo el total ponderado a un estado RAG, de modo que la puntuación principal se calcula de manera idéntica cada vez y los pesos siempre suman el 100%.
```bash
# Cinco puntuaciones 1-5 en orden: adopción engagement resultados soporte comercial
python3 scripts/health_score.py --scores 4 3 4 2 5 --account "Acme Corp"
- # O desde JSON (te permite sobrescribir las ponderaciones por defecto por cuenta/segmento)
+ # O desde JSON (te permite sobrescribir los pesos predeterminados por cuenta/segmento)
python3 scripts/health_score.py --input account.json
```
- Devuelve los puntos ponderados por dimensión, el **total sobre 100**, y la **banda RAG** (Verde ≥80, Ámbar 60–79, Rojo <60) con un siguiente paso de una línea. Ejecútalo para establecer el número titular, luego escribe el detalle de la dimensión y las acciones debajo. Añade `--json` para tooling aguas abajo.
+ Devuelve los puntos ponderados por dimensión, el **total sobre 100** y la **banda RAG** (Verde ≥80, Ámbar 60–79, Rojo <60) con un siguiente paso de una línea. Ejecútalo para establecer el número principal, luego escribe el detalle de la dimensión y las acciones debajo de él. Añade `--json` para herramientas posteriores.
## Formato de Salida
---
- # Cuadro de Mando de Salud del Cliente: [Nombre de Cuenta]
+ # Cuadro de Mando de Salud del Cliente: [Nombre de la Cuenta]
- **CSM:** [Nombre] | **Tier:** [Enterprise / Mid-Market / SMB]
+ **CSM:** [Nombre] | **Nivel:** [Enterprise / Mid-Market / SMB]
**ARR:** £/$/€[X] | **Fecha de renovación:** [Fecha] | **Días hasta renovación:** [N]
**Salud general:** [Verde / Ámbar / Rojo] — [Puntuación]/100
**Última actualización:** [Fecha]
---
## Resumen de Puntuación de Salud
- | Dimensión | Puntuación (1–5) | Ponderación | Puntuación Ponderada | Tendencia |
+ | Dimensión | Puntuación (1–5) | Peso | Puntuación Ponderada | Tendencia |
|---|---|---|---|---|
- | Adopción del Producto | [1–5] | 30% | [X] | ↑ / → / ↓ |
+ | Adopción de Producto | [1–5] | 30% | [X] | ↑ / → / ↓ |
| Engagement | [1–5] | 20% | [X] | ↑ / → / ↓ |
| Resultados | [1–5] | 20% | [X] | ↑ / → / ↓ |
| Salud del Soporte | [1–5] | 15% | [X] | ↑ / → / ↓ |
| Comercial | [1–5] | 15% | [X] | ↑ / → / ↓ |
| **Total** | — | 100% | **[X]/100** | |
---
- ## Detalle de Dimensión
+ ## Detalle de Dimensiones
- ### Adopción del Producto — [Puntuación]/5
- - **Ratio DAU/MAU:** [X]% (benchmark: >25% = saludable)
- - **Funcionalidades clave adoptadas:** [Lista funcionalidades en uso]
- - **Funcionalidades no adoptadas:** [Lista funcionalidades de alto valor no utilizadas]
+ ### Adopción de Producto — [Puntuación]/5
+ - **Ratio DAU/MAU:** [X]% (referencia: >25% = saludable)
+ - **Características clave adoptadas:** [Listar características en uso]
+ - **Características no adoptadas:** [Listar características de alto valor sin usar]
- **Usuarios avanzados identificados:** [Sí / No — cuántos]
- - **Evaluación:** [1–2 frases sobre salud de adopción]
+ - **Evaluación:** [1–2 oraciones sobre salud de adopción]
### Engagement — [Puntuación]/5
- **Último QBR:** [Fecha] — [Resumen de resultado]
- **Próximo QBR:** [Programado / Vencido]
- **Patrocinador ejecutivo:** [Activo / Pasivo / Vacante]
- - **Campeón:** [Nombre, cargo, fortaleza: fuerte / moderada / débil]
- - **Evaluación:** [1–2 frases]
+ - **Campeón:** [Nombre, rol, fortaleza: fuerte / moderada / débil]
+ - **Evaluación:** [1–2 oraciones]
### Resultados — [Puntuación]/5
- - **Objetivos declarados del cliente:** [Lista 2–3 objetivos de la incorporación o último QBR]
- - **Progreso contra objetivos:** [En camino / Parcial / Desviado]
+ - **Objetivos declarados del cliente:** [Listar 2–3 objetivos del onboarding o último QBR]
+ - **Progreso contra objetivos:** [En camino / Parcial / Fuera de camino]
- **Evidencia de valor:** [Métrica o cita que demuestre ROI]
- - **Evaluación:** [1–2 frases]
+ - **Evaluación:** [1–2 oraciones]
### Salud del Soporte — [Puntuación]/5
- - **Tickets abiertos:** [N] (desglose por prioridad: P1: X, P2: X, P3: X)
- - **CSAT / NPS:** [Puntuación] (benchmark: >8 CSAT / >30 NPS = saludable)
- - **Escalaciones sin resolver:** [Sí / No — detalles si aplica]
+ - **Tickets abiertos:** [N] (desglose de prioridad: P1: X, P2: X, P3: X)
+ - **CSAT / NPS:** [Puntuación] (referencia: >8 CSAT / >30 NPS = saludable)
+ - **Escaladas sin resolver:** [Sí / No — detalles si sí]
- **Tendencia de tickets (últimos 90 días):** Aumentando / Estable / Disminuyendo
- - **Evaluación:** [1–2 frases]
+ - **Evaluación:** [1–2 oraciones]
### Comercial — [Puntuación]/5
- - **Puestos licenciados:** [N] | **Puestos activos:** [N] ([X]% utilización)
- - **Historial de pagos:** [A tiempo / Retraso — detalles]
+ - **Asientos licenciados:** [N] | **Asientos activos:** [N] ([X]% utilización)
+ - **Historial de pagos:** [Puntual / Retrasado — detalles]
- **Señales de expansión:** [Sí — describe / No]
- **Señales de degradación o cancelación:** [Sí — describe / No]
- - **Evaluación:** [1–2 frases]
+ - **Evaluación:** [1–2 oraciones]
---
## Riesgos Principales
| Riesgo | Severidad | Mitigación |
|---|---|---|
| [Descripción del riesgo] | Alta / Media / Baja | [Acción específica para mitigar] |
---
## Acciones Recomendadas
- **Inmediatas (esta semana):**
- 1. [Acción — propietario — fecha límite]
+ **Inmediato (esta semana):**
+ 1. [Acción — responsable — fecha límite]
**Este mes:**
- 1. [Acción — propietario — fecha límite]
+ 1. [Acción — responsable — fecha límite]
- **Antes de renovación:**
- 1. [Acción — propietario — fecha límite]
+ **Antes de la renovación:**
+ 1. [Acción — responsable — fecha límite]
---
## Pronóstico de Renovación
- | Escenario | Probabilidad | ARR en riesgo |
+ | Escenario | Probabilidad | ARR en Riesgo |
|---|---|---|
- | Renovación completa en ARR actual | [X]% | £/$/€0 |
+ | Renovación completa a ARR actual | [X]% | £/$/€0 |
| Renovación con contracción | [X]% | £/$/€[X] |
| Churn | [X]% | £/$/€[ARR completo] |
- **Jugada de renovación recomendada:** [Expandir / Mantener / Salvar / Gestionar salida]
+ **Estrategia de renovación recomendada:** [Expandir / Mantener / Salvar / Gestionar salida]
---
- ## Controles de Calidad
+ ## Materiales Más Profundos
+ Este skill incluye archivos de soporte — úsalos cuando estén disponibles:
+
+ - **`references/leading-signals.md`** — Señales de Salud que Lideran (En lugar de Elogiar). Aplícalo mientras produces la salida; contiene la calibración y los juicios que el resumen del método anterior comprime.
+ - **`templates/account-scorecard.md`** — una versión rellenable del entregable con las puertas de calidad inline. Ofrécela cuando el usuario quiera trabajar el documento ellos mismos en lugar de tenerlo generado.
+
+ ## Rúbrica de Puntuación (0–40)
+
+ Puntúa cualquier salida de este skill antes de entregar; 32+ es calidad de envío.
+
+ | Dimensión | 0 | 5 | 10 |
+ |---|---|---|---|
+ | Integridad de puntuación | El total ponderado no se calcula a partir de las puntuaciones de dimensión y los pesos declarados, o la banda RAG contradice el total | La aritmética es correcta pero los pesos se ajustaron silenciosamente, o el RAG principal suaviza una dimensión que cuenta una historia diferente | El total se calcula exactamente (puntuación × peso en la escala 1–5, sobre 100), RAG coincide con las bandas 80/60, y cualquier dimensión que contradiga el estado general se señala en lugar de promediar |
+ | Evidencia por dimensión | Puntuaciones de dimensión aseveradas sin datos de apoyo ("el engagement se siente débil") | La mayoría de dimensiones citan datos, pero al menos una puntuación se apoya en intuición o un punto de datos antiguo presentado como actual | Cada puntuación de dimensión está anclada a evidencia nombrada y fechada (figuras de uso, conteos de tickets, fechas de QBR, utilización de asientos) y los puntos de referencia se aplican donde el formato los proporciona |
+ | Especificidad de riesgo | Los riesgos son etiquetas ("bajo engagement", "riesgo de churn") sin personas, fechas o montos en dólares | Los riesgos son reales pero parcialmente vagos — severidad asignada sin una mitigación, o mitigaciones sin responsables | Cada riesgo nombra la persona/evento/monto involucrado ("campeón se va 25 de julio, sin sucesor"), lleva una severidad y tiene una mitigación que alguien podría comenzar esta semana |
+ | Calibración de renovación | Pronóstico faltante, probabilidades no suman 100%, o la estrategia recomendada ignora la puntuación | Pronóstico presente y suma correctamente, pero las figuras de ARR en riesgo no se reconcilian con elementos de línea de contrato, o la estrategia es genérica | Las probabilidades suman 100%, ARR en riesgo se asigna a componentes reales del contrato, la estrategia (Expandir/Mantener/Salvar/Gestionar salida) sigue de la puntuación y riesgos, y las acciones tienen responsables, fechas y secuencia contra la fecha de renovación |
+
+ ## Comprobaciones de Calidad
+
- [ ] La puntuación se basa en datos, no en intuición — cada dimensión tiene evidencia
- - [ ] Los riesgos son específicos (no "bajo engagement" — algo como "el patrocinador ejecutivo se fue en marzo, sin reemplazo identificado")
- - [ ] Las acciones tienen propietarios y fechas límite
+ - [ ] Los riesgos son específicos (no "bajo engagement" — algo como "el patrocinador ejecutivo se fue en marzo, no se identificó reemplazo")
+ - [ ] Las acciones tienen responsables y fechas límite
- [ ] La probabilidad de renovación está calibrada contra la realidad del pipeline
- - [ ] Las flechas de tendencia reflejan la dirección del cambio versus el último cuadro de mando, no solo el estado actual
+ - [ ] Las flechas de tendencia reflejan la dirección del cambio vs. el último cuadro de mando, no solo el estado actual
- ## Anti-patrones
+ ## Anti-Patrones
- - [ ] No puntúes dimensiones de salud basándote en intuición — cada puntuación necesita evidencia de apoyo específica
- - [ ] No des estado Verde a cuentas con problemas P1 sin resolver o hitos incumplidos
+ - [ ] No puntúes dimensiones de salud por intuición — cada puntuación necesita evidencia específica de apoyo
+ - [ ] No des un estado Verde a cuentas con problemas P1 sin resolver o hitos perdidos
- [ ] No listes riesgos vagamente — "bajo engagement" sin especificidades no es accionable
- - [ ] No dejes acciones recomendadas sin propietarios nombrados y fechas límite
+ - [ ] No dejes acciones recomendadas sin responsables nombrados y fechas límite
- [ ] No confundas frecuencia de uso del producto con entrega de valor del producto
+
+ ## Frases Desencadenantes de Ejemplo
+
+ - "Califica la salud de la cuenta."
+ - "Evalúa el riesgo de renovación."
+ - "Construye un panel de salud."
+ - "Evalúa la probabilidad de que una cuenta se renueve."