Genera un deck de QBR desde datos de cuenta con Claude

Una Claude Skill que convierte una sola cuenta de Gainsight en una narrativa de QBR más un outline slide por slide: un titular ejecutivo, una historia de uso-y-resultados encadenada a las metas del success plan de la cuenta, una tabla de riesgos abiertos y un conjunto priorizado de jugadas de expansión. El CSM obtiene un borrador estructurado en Markdown —un bloque por slide, en el orden en que corre el deck— que edita y coloca en la plantilla de deck del equipo, en vez de mirar fijamente un outline en blanco. El bundle del artifact incluye SKILL.md más tres archivos de referencia que el equipo de CSM adapta una vez y reusa en cada cuenta.

Este es el primo de narrativa-y-outline de la skill de preparación de QBR, que jala Salesforce y Gong también. Si vives en Gainsight y quieres la historia del deck directamente desde el registro de cuenta, el scorecard y el success plan de tu CSP, empieza aquí.

Cuándo usarla

Eres un CSM preparando un QBR para una cuenta nombrada específica, Gainsight es tu sistema de registro para health, uso y metas del success plan, y quieres una narrativa poblada y un outline de slides que puedas editar en vez de un deck en blanco. La Skill está construida para el caso donde la historia del QBR tiene que trenzar cuatro cosas juntas —dónde está la cuenta contra los compromisos del trimestre pasado, qué dicen los datos de uso y resultados, qué riesgos están abiertos y dónde está la expansión creíble— y aterrizarlo en un orden de slides que un humano pueda refinar.

Produce el output más útil cuando el scorecard de Gainsight está configurado (no solo el health pill por default), el success plan tiene metas con fechas objetivo y estado, y las medidas de uso están pobladas contra un baseline real. Para cuentas que cumplen esa barra, el borrador aterriza cerca de listo-para-deck. Para cuentas que no, la Skill marca el gap por nombre en vez de escribir un borrador confiado sobre datos faltantes.

Cuándo NO usarla

No uses esta Skill para auto-enviar un deck de QBR. Redacta una narrativa y un outline; no renderiza slides y no reemplaza la lectura que el CSM hace de la relación. Cada deck recibe una pasada humana y un visto bueno del equipo de cuenta sobre el framing antes de que el cliente lo vea.

No la apuntes a una cuenta con menos de 30 días de datos de uso en Gainsight, un scorecard vacío o nunca configurado, o un success plan sin metas registradas. La Skill está construida para marcar y rehusar en vez de rellenar con generalidades —pero solo si respetas la negativa. Sobrescribir el flag INSUFFICIENT_DATA produce un borrador que se lee bien y engaña al cliente.

No la uses como modelo de probabilidad de renewal o de churn. La tabla de riesgos es framing de QBR —de qué hablar en la sala— no un score de retención calibrado. Si necesitas un número de health defendible con una explicación de qué-cambió, construye el score de health compuesto en n8n en su lugar y lee la tabla de riesgos de esta Skill como comentario, no como señal.

No la uses para reviews internos o de board. Las pasadas de narrativa y tono asumen una audiencia externa de cliente y un marco de renewal-o-expansión.

Setup

Aproximadamente 45 a 90 minutos la primera vez, casi todo gastado mapeando el orden de slides de tu deck al vocabulario de outline de la Skill y colocando muestras de voz reales. Después de la primera cuenta, las corridas son un par de minutos.

1. Instala la Skill. Coloca el bundle de apps/web/public/artifacts/qbr-deck-builder-skill/ en ~/.claude/skills/qbr-deck-builder/. Expone un solo comando, build_qbr_deck(account_id, quarter), más helpers internos para los pulls de Gainsight, parseo del success plan y el pipeline de dos pasadas de Claude.
2. Conecta la credencial de Gainsight. Configura GAINSIGHT_API_KEY y GAINSIGHT_DOMAIN con acceso de lectura a Company, Scorecard, Success Plan / CTA, y los objetos de uso/adopción que tu org puebla. La Skill solo lee; nunca escribe de vuelta a Gainsight. Si tus datos de uso viven en un objeto de adopción separado, configura GAINSIGHT_USAGE_OBJECT a su nombre de API —la Skill valida los nombres de campos contra references/1-deck-outline-map.md y rehúsa llenar la slide de uso si derivan.
3. Mapea el outline de tu deck. Abre references/1-deck-outline-map.md y reemplaza el manifesto de slides con el orden y títulos de slides reales de tu equipo. El outline por default es titular-ejecutivo, dónde-estábamos, uso-y-resultados, riesgos-abiertos, jugadas-de-expansión, pedidos-y-próximos-pasos —reordena o renombra para coincidir con el deck que realmente presentas.
4. Fija la forma del success-plan. Abre references/2-success-plan-format.md y o bien adopta el schema verbatim o describe cómo tu equipo registra metas en Gainsight (tipo de CTA, el campo que sostiene la fecha objetivo, el picklist que sostiene el estado). La Skill necesita una forma estable para parsear meta por meta; una forma desajustada es la causa más común de una historia de resultados vacía.
5. Coloca muestras de voz. Reemplaza el placeholder en references/3-sample-deck.md con tres a cinco narrativas de QBR previas anonimizadas de tu equipo de CSM para que la pasada de tono tenga material real que imitar. Sin muestras, la Skill escribe en registro neutral y marca TONE_REVIEW_NEEDED.
6. Corre para una cuenta. build_qbr_deck(account_id="1P01...XYZ", quarter="Q2-2026", last_deck_path="..."). La Skill escribe un archivo Markdown con un bloque fenced por slide, más un resumen ejecutivo de un párrafo como archivo separado. Léelo de arriba a abajo, edita y pega en el deck.

Qué hace la Skill en realidad

La Skill jala cuatro cosas de Gainsight en un batch: el registro Company (ARR, fecha de renewal, segmento, etapa de lifecycle), el scorecard actual (cada medida, su score y su tendencia versus el periodo pasado), el success plan activo (cada meta con fecha objetivo y estado) y el rollup de uso contra el baseline de la cuenta. Si cualquier pull devuelve vacío, la Skill registra unavailable para ese input y lo encadena a un flag INSUFFICIENT_DATA en la slide afectada en vez de inventar contenido. Gainsight es la única fuente aquí a propósito —una credencial, un registro de cuenta, una definición de scorecard— para que el borrador sea reproducible y el linaje de datos sea obvio para el CSM que lo edita.

Después corre dos pasadas de Claude, no una. La pasada uno es síntesis: Claude lee los cuatro inputs más el deck de QBR previo y construye un scratchpad interno —los wins encadenados a metas del success plan, los gaps, la historia de uso-y-resultados contra baseline, los riesgos abiertos priorizados rojo/amarillo/verde, y las jugadas de expansión priorizadas por señal (tendencia de uso, fortaleza del scorecard, margen de contrato) y confianza (alta, media, baja). La síntesis es su propia pasada porque la siguiente pasada necesita una imagen coherente; doblar síntesis y escritura de slides en una sola pasada hace que las slides sobreponderen el input que Claude leyó al último, y la priorización de expansión degrada a una lista en vez de una priorización.

La pasada dos es narrativa-y-outline. Claude lee las muestras de voz de references/3-sample-deck.md y reescribe el scratchpad en la voz del equipo —neutral, basada en datos, sin superlativos— y después lo mapea al orden de slides de references/1-deck-outline-map.md, un bloque fenced por slide. Mantener el mapeo del outline en la segunda pasada significa que reordenar o renombrar slides solo re-corre esta pasada; el scratchpad de síntesis se reusa. El resumen ejecutivo se genera al último a partir de la narrativa terminada para que nunca contradiga las slides debajo de él.

El output es un solo archivo Markdown —un bloque fenced por slide, en orden de deck, cada bloque encabezado con el título de slide de tu mapa— más un resumen ejecutivo separado de un párrafo. El CSM siempre edita antes de que se construya el deck. La Skill es un motor de borrador, no un publicador.

Realidad de costos

Una corrida completa cuesta aproximadamente 12,000 a 22,000 tokens de input y 3,000 a 6,000 tokens de output con Claude Sonnet —llámalo 5 a 12 centavos por QBR a precios actuales de Sonnet. Es más barata que la skill de prep con Salesforce-más-Gong porque no hay transcripciones de llamadas en el input; los pulls de Gainsight son registros estructurados, no transcripciones de 60 minutos. El tiempo de reloj es uno a tres minutos por cuenta, dominado por el batch de la API de Gainsight en la pasada cero; las dos pasadas de Claude agregan 30 a 60 segundos.

Un CSM construyendo una narrativa de QBR desde cero típicamente gasta 60 a 120 minutos por cuenta jalando el scorecard, reconstruyendo los compromisos del trimestre pasado y redactando el texto de slide. La Skill lleva eso a 20 a 40 minutos de edición, así que el ahorro es aproximadamente una hora por QBR. Un book de 25 cuentas a un QBR por trimestre son cerca de 25 horas ahorradas por trimestre por CSM —contra un gasto en Anthropic bajo $3 por trimestre para ese book.

Métrica de éxito

Rastrea el tiempo desde “outline generado” hasta “deck enviado a revisión interna” por QBR; la Skill debe jalar la mediana bajo 45 minutos dentro del primer trimestre de uso. Observa la tasa de borradores cargando flags INSUFFICIENT_DATA, SUCCESS_PLAN_STALE o TONE_REVIEW_NEEDED —esos son indicadores líderes de problemas de higiene upstream (scorecards dejados en defaults, success plans no mantenidos, sin muestras de voz) que la Skill saca a la superficie por diseño; un trimestre saludable los lleva a la baja. También rastrea la proporción de narrativa generada que sobrevive la pasada de edición del CSM: apunta a 70% o más. Más bajo y los datos de Gainsight necesitan trabajo; por encima de 90% y el CSM probablemente está sub-editando un borrador que nunca debería salir sin editar.

Versus las alternativas

Versus el QBR / Success Snapshot nativo de Gainsight. Gainsight viene con exports templados de QBR y Success Snapshot que auto-pueblan medidas del scorecard, charts de uso y NPS en un layout de slides. Si quieres campos renderizados en un deck, eso es menos setup y el default obvio —es el producto por el que ya pagas. El gap que deja es narrativa: saca medidas a la superficie, no escribe la historia que conecta el uso de este trimestre con los compromisos del trimestre pasado, y no prioriza jugadas de expansión en prosa. Esta Skill escribe esa historia desde los mismos datos de Gainsight. Usa el export nativo para las slides con charts y esta Skill para las slides de narrativa; son complementarias, no competidoras.

Versus la skill de prep de QBR con Salesforce-más-Gong. Esa skill agrega historial de cuenta de Salesforce y temas de llamadas de Gong a la mezcla y es la elección correcta cuando el color derivado de llamadas (citas de ejecutivos, menciones de competidores) carga peso en tus QBRs y tienes la cobertura de Gong para soportarlo. Cuesta más por corrida y necesita tres credenciales. Esta Skill es la elección correcta cuando Gainsight es tu fuente de verdad, no tienes o no quieres conectar Gong, y el scorecard más el success plan cargan la historia. Corre la respaldada por Gong para cuentas estratégicas con historial rico de llamadas; corre esta para la long tail que diriges desde el CSP.

Versus escribirlo a mano. La preparación manual produce el mejor QBR para una cuenta de top-tier porque el CSM carga contexto que ningún registro sostiene —la conversación de presupuesto fuera de registro, el champion que se está yendo en silencio. El costo es la hora-y-pico por cuenta, que no escala a través de un book de 25 cuentas. Usa preparación manual para el puñado de cuentas donde el contexto de la relación es el deck; usa la Skill para el resto, e incluso en las cuentas top-tier arranca desde el borrador de la Skill y edita más fuerte.

A vigilar

• Scorecard por default, historia confiada. Una cuenta cuyo scorecard nunca se configuró más allá del health pill por default produce medidas que no significan nada, y una narrativa construida sobre ellas se lee plausible y no dice nada. Guarda: la Skill checa si el scorecard tiene más que la única medida por default poblada; si no, escribe la slide de uso-y-resultados como INSUFFICIENT_DATA: scorecard no configurado en vez de narrar ruido.
• Success plan obsoleto. Un success plan no tocado en más de 60 días produce una historia de progreso que suena confiada pero está desactualizada. Guarda: la Skill lee la fecha de última modificación de cada meta; si la edición más reciente del plan es más vieja que 60 días, antepone SUCCESS_PLAN_STALE a la slide de dónde-estábamos para que el CSM tenga que confirmar que las metas siguen vigentes antes de presentarlas.
• Deck previo equivocado. Si last_deck_path apunta al deck de otra cuenta u otro trimestre, el framing “compromisos entonces versus realidad ahora” se rompe silenciosamente y la narrativa reporta contra las promesas equivocadas. Guarda: la pasada de síntesis extrae el nombre de cuenta y el trimestre de la primera slide del deck previo y se detiene con un error de desajuste si cualquiera no concuerda con los inputs.
• Desajuste de tono con el cliente. La voz por default es la del equipo de CSM, que puede no coincidir con cómo un comprador enterprise espera que se le dirija versus un startup. Guarda: cuando las muestras de voz en references/3-sample-deck.md incluyen decks que el cliente realmente recibió, la pasada de tono las pondera por encima de docs internos; sin muestras escribe registro neutral y marca TONE_REVIEW_NEEDED en el resumen ejecutivo.
• Jugadas de expansión que rebasan los datos. Pedido a priorizar expansión, un modelo fabricará un upsell plausible incluso cuando ninguna señal de uso o contrato lo soporta. Guarda: la priorización de expansión está restringida a jugadas respaldadas por una señal nombrada (una medida de uso con tendencia al alza, margen del scorecard, asientos de contrato por debajo del entitlement); una jugada sin señal se descarta, no se degrada, y si ninguna califica la slide lo dice en vez de rellenar.

Stack

• Gainsight —registro Company, scorecard, success plan y rollup de uso; fuente de solo-lectura para todo el borrador
• Claude —pipeline de dos pasadas: síntesis (wins, riesgos, expansión, historia de uso) luego narrativa más mapeo de outline de slides (Sonnet recomendado por costo; Opus solo si el voice match importa más que el presupuesto)
• Tu herramienta de deck —Google Slides o PowerPoint; el CSM pega el Markdown slide por slide en la plantilla del equipo después de editar