cs-health-scorecard
GitHub为特定客户账户构建结构化健康看板，评估续约风险与扩张潜力。通过多维度加权评分（1-5分）计算总分并映射RAG状态，整合产品使用、参与度、支持及商业数据，提供关键风险识别与行动建议，辅助CSM和管理层决策。
触发场景
安装
npx skills add mohitagw15856/pm-claude-skills --skill cs-health-scorecard -g -y
SKILL.md
Frontmatter
{
"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."
}
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.
Lee desde / Escribe en el Brain
Si existe un professional-brain (brain/), utiliza la información en lugar de volver a preguntar lo que ya sabes:
- Lee primero: el archivo
entities/de la cuenta, susstakeholders/(campeón, comprador económico, detractores) yknowledge/. Ejecutapython3 ../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 endecisions/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).
Entradas Requeridas
Pregunta por estas si no se proporcionan ya:
- Nombre de la cuenta y tier (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 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
- 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.
| Dimensión | Ponderación | Qué Puntuar |
|---|---|---|
| Adopción del Producto | 30% | Ratio DAU/MAU, amplitud de funcionalidades 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 |
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)
Helper 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%.
# 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)
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.
Formato de Salida
Cuadro de Mando de Salud del Cliente: [Nombre de Cuenta]
CSM: [Nombre] | Tier: [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 |
|---|---|---|---|---|
| Adopción del 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
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]
- Usuarios avanzados identificados: [Sí / No — cuántos]
- Evaluación: [1–2 frases 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]
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]
- Evidencia de valor: [Métrica o cita que demuestre ROI]
- Evaluación: [1–2 frases]
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]
- Tendencia de tickets (últimos 90 días): Aumentando / Estable / Disminuyendo
- Evaluación: [1–2 frases]
Comercial — [Puntuación]/5
- Puestos licenciados: [N] | Puestos activos: [N] ([X]% utilización)
- Historial de pagos: [A tiempo / Retraso — 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]
Riesgos Principales
| Riesgo | Severidad | Mitigación |
|---|---|---|
| [Descripción del riesgo] | Alta / Media / Baja | [Acción específica para mitigar] |
Acciones Recomendadas
Inmediatas (esta semana):
- [Acción — propietario — fecha límite]
Este mes:
- [Acción — propietario — fecha límite]
Antes de renovación:
- [Acción — propietario — fecha límite]
Pronóstico de Renovación
| Escenario | Probabilidad | ARR en riesgo |
|---|---|---|
| Renovación completa en 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]
Controles 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
- 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
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 listes riesgos vagamente — "bajo engagement" sin especificidades no es accionable
- No dejes acciones recomendadas sin propietarios nombrados y fechas límite
- No confundas frecuencia de uso del producto con entrega de valor del producto
版本历史
- a38bc30 当前 2026-07-05 11:07
