Uma Claude Skill que transforma uma única conta do Gainsight em uma narrativa de QBR mais um outline slide a slide: um título executivo, uma história de uso-e-resultados encadeada às metas do success plan da conta, uma tabela de riscos abertos e um conjunto priorizado de jogadas de expansão. O CSM recebe um rascunho estruturado em Markdown —um bloco por slide, na ordem em que o deck roda— que edita e coloca no template de deck do time, em vez de encarar um outline em branco. O bundle do artifact inclui SKILL.md mais três arquivos de referência que o time de CSM adapta uma vez e reusa em cada conta.

Este é o primo de narrativa-e-outline da skill de preparação de QBR, que puxa Salesforce e Gong também. Se você vive no Gainsight e quer a história do deck direto do registro da conta, do scorecard e do success plan do seu CSP, comece aqui.

Quando usar

Você é um CSM preparando um QBR para uma conta nomeada específica, o Gainsight é seu sistema de registro para health, uso e metas do success plan, e você quer uma narrativa populada e um outline de slides que possa editar em vez de um deck em branco. A Skill foi construída para o caso onde a história do QBR precisa trançar quatro coisas juntas —onde a conta está contra os compromissos do trimestre passado, o que os dados de uso e resultados dizem, quais riscos estão abertos e onde está a expansão crível— e aterrissá-lo em uma ordem de slides que um humano possa refinar.

Produz o output mais útil quando o scorecard do Gainsight está configurado (não só o health pill default), o success plan tem metas com datas-alvo e status, e as medidas de uso estão populadas contra um baseline real. Para contas que atingem essa barra, o rascunho aterrissa perto de pronto-para-deck. Para contas que não, a Skill marca o gap pelo nome em vez de escrever um rascunho confiante sobre dados faltantes.

Quando NÃO usar

Não use esta Skill para auto-enviar um deck de QBR. Ela redige uma narrativa e um outline; não renderiza slides e não substitui a leitura que o CSM faz da relação. Cada deck recebe uma passada humana e um aval do time de conta sobre o framing antes de o cliente vê-lo.

Não a aponte para uma conta com menos de 30 dias de dados de uso no Gainsight, um scorecard vazio ou nunca configurado, ou um success plan sem metas registradas. A Skill foi construída para marcar e recusar em vez de encher de generalidades —mas só se você honrar a recusa. Sobrescrever o flag INSUFFICIENT_DATA produz um rascunho que se lê bem e engana o cliente.

Não a use como modelo de probabilidade de renewal ou de churn. A tabela de riscos é framing de QBR —do que falar na sala— não um score de retenção calibrado. Se você precisa de um número de health defensável com uma explicação de o-que-mudou, construa o score de health composto no n8n em vez disso e leia a tabela de riscos desta Skill como comentário, não como sinal.

Não a use para reviews internos ou de board. As passadas de narrativa e tom assumem uma audiência externa de cliente e um frame de renewal-ou-expansão.

Setup

Aproximadamente 45 a 90 minutos na primeira vez, quase tudo gasto mapeando a ordem de slides do seu deck ao vocabulário de outline da Skill e colocando amostras de voz reais. Depois da primeira conta, as rodadas são alguns minutos.

Instale a Skill. Coloque o bundle de apps/web/public/artifacts/qbr-deck-builder-skill/ em ~/.claude/skills/qbr-deck-builder/. Ela expõe um único comando, build_qbr_deck(account_id, quarter), mais helpers internos para os pulls do Gainsight, parsing do success plan e o pipeline de duas passadas do Claude.
Conecte a credencial do Gainsight. Configure GAINSIGHT_API_KEY e GAINSIGHT_DOMAIN com acesso de leitura a Company, Scorecard, Success Plan / CTA, e os objetos de uso/adoção que sua org popula. A Skill só lê; nunca escreve de volta no Gainsight. Se seus dados de uso vivem em um objeto de adoção separado, configure GAINSIGHT_USAGE_OBJECT com o nome de API dele —a Skill valida os nomes dos campos contra references/1-deck-outline-map.md e recusa preencher o slide de uso se eles derivarem.
Mapeie o outline do seu deck. Abra references/1-deck-outline-map.md e substitua o manifesto de slides pela ordem e títulos de slides reais do seu time. O outline default é título-executivo, onde-estávamos, uso-e-resultados, riscos-abertos, jogadas-de-expansão, pedidos-e-próximos-passos —reordene ou renomeie para coincidir com o deck que você de fato apresenta.
Fixe a forma do success-plan. Abra references/2-success-plan-format.md e ou adote o schema verbatim ou descreva como seu time registra metas no Gainsight (tipo de CTA, o campo que guarda a data-alvo, o picklist que guarda o status). A Skill precisa de uma forma estável para fazer parse meta a meta; uma forma desajustada é a causa mais comum de uma história de resultados vazia.
Coloque amostras de voz. Substitua o placeholder em references/3-sample-deck.md por três a cinco narrativas de QBR anteriores anonimizadas do seu time de CSM para que a passada de tom tenha material real para imitar. Sem amostras, a Skill escreve em registro neutro e marca TONE_REVIEW_NEEDED.
Rode para uma conta. build_qbr_deck(account_id="1P01...XYZ", quarter="Q2-2026", last_deck_path="..."). A Skill escreve um arquivo Markdown com um bloco fenced por slide, mais um resumo executivo de um parágrafo como arquivo separado. Leia de cima a baixo, edite e cole no deck.

O que a Skill faz de fato

A Skill puxa quatro coisas do Gainsight em um batch: o registro Company (ARR, data de renewal, segmento, estágio de lifecycle), o scorecard atual (cada medida, seu score e sua tendência versus o período passado), o success plan ativo (cada meta com data-alvo e status) e o rollup de uso contra o baseline da conta. Se qualquer pull retorna vazio, a Skill registra unavailable para aquele input e o encadeia a um flag INSUFFICIENT_DATA no slide afetado em vez de inventar conteúdo. O Gainsight é a única fonte aqui de propósito —uma credencial, um registro de conta, uma definição de scorecard— para que o rascunho seja reproduzível e a linhagem de dados seja óbvia para o CSM que o edita.

Depois roda duas passadas do Claude, não uma. A passada um é síntese: o Claude lê os quatro inputs mais o deck de QBR anterior e constrói um scratchpad interno —os wins encadeados às metas do success plan, os gaps, a história de uso-e-resultados contra o baseline, os riscos abertos priorizados vermelho/amarelo/verde, e as jogadas de expansão priorizadas por sinal (tendência de uso, força do scorecard, folga de contrato) e confiança (alta, média, baixa). A síntese é a própria passada porque a próxima passada precisa de uma imagem coerente; dobrar síntese e escrita de slides em uma só passada faz os slides sobreponderarem o input que o Claude leu por último, e a priorização de expansão degrada para uma lista em vez de uma priorização.

A passada dois é narrativa-e-outline. O Claude lê as amostras de voz de references/3-sample-deck.md e reescreve o scratchpad na voz do time —neutra, baseada em dados, sem superlativos— e depois o mapeia para a ordem de slides de references/1-deck-outline-map.md, um bloco fenced por slide. Manter o mapeamento do outline na segunda passada significa que reordenar ou renomear slides só re-roda esta passada; o scratchpad de síntese é reusado. O resumo executivo é gerado por último a partir da narrativa terminada para que nunca contradiga os slides abaixo dele.

O output é um único arquivo Markdown —um bloco fenced por slide, em ordem de deck, cada bloco encabeçado com o título de slide do seu mapa— mais um resumo executivo separado de um parágrafo. O CSM sempre edita antes de o deck ser construído. A Skill é um motor de rascunho, não um publicador.

Realidade de custos

Uma rodada completa custa aproximadamente 12.000 a 22.000 tokens de input e 3.000 a 6.000 tokens de output no Claude Sonnet —chame de 5 a 12 centavos por QBR a preços atuais do Sonnet. É mais barata que a skill de prep com Salesforce-mais-Gong porque não há transcrições de chamadas no input; os pulls do Gainsight são registros estruturados, não transcrições de 60 minutos. O tempo de relógio é um a três minutos por conta, dominado pelo batch da API do Gainsight na passada zero; as duas passadas do Claude adicionam 30 a 60 segundos.

Um CSM construindo uma narrativa de QBR do zero tipicamente gasta 60 a 120 minutos por conta puxando o scorecard, reconstruindo os compromissos do trimestre passado e redigindo o texto de slide. A Skill leva isso a 20 a 40 minutos de edição, então a economia é aproximadamente uma hora por QBR. Um book de 25 contas a um QBR por trimestre são cerca de 25 horas economizadas por trimestre por CSM —contra um gasto em Anthropic abaixo de $3 por trimestre para esse book.

Métrica de sucesso

Rastreie o tempo desde “outline gerado” até “deck enviado para revisão interna” por QBR; a Skill deve puxar a mediana abaixo de 45 minutos dentro do primeiro trimestre de uso. Observe a taxa de rascunhos carregando flags INSUFFICIENT_DATA, SUCCESS_PLAN_STALE ou TONE_REVIEW_NEEDED —esses são indicadores líderes de problemas de higiene upstream (scorecards deixados nos defaults, success plans não mantidos, sem amostras de voz) que a Skill traz à superfície por design; um trimestre saudável os leva para baixo. Rastreie também a proporção de narrativa gerada que sobrevive à passada de edição do CSM: mire em 70% ou mais. Abaixo disso e os dados do Gainsight precisam de trabalho; acima de 90% e o CSM provavelmente está sub-editando um rascunho que nunca deveria sair sem edição.

Versus as alternativas

Versus o QBR / Success Snapshot nativo do Gainsight. O Gainsight vem com exports templados de QBR e Success Snapshot que auto-populam medidas do scorecard, charts de uso e NPS em um layout de slides. Se você quer campos renderizados em um deck, isso é menos setup e o default óbvio —é o produto pelo qual você já paga. O gap que ele deixa é narrativa: traz medidas à superfície, não escreve a história que conecta o uso deste trimestre aos compromissos do trimestre passado, e não prioriza jogadas de expansão em prosa. Esta Skill escreve essa história a partir dos mesmos dados do Gainsight. Use o export nativo para os slides com charts e esta Skill para os slides de narrativa; são complementares, não competidoras.

Versus a skill de prep de QBR com Salesforce-mais-Gong. Essa skill adiciona histórico de conta do Salesforce e temas de chamadas do Gong à mistura e é a escolha certa quando o color derivado de chamadas (citações de executivos, menções de competidores) carrega peso nos seus QBRs e você tem a cobertura de Gong para sustentá-lo. Custa mais por rodada e precisa de três credenciais. Esta Skill é a escolha certa quando o Gainsight é sua fonte de verdade, você não tem ou não quer conectar o Gong, e o scorecard mais o success plan carregam a história. Rode a respaldada por Gong para contas estratégicas com histórico rico de chamadas; rode esta para a long tail que você dirige a partir do CSP.

Versus escrever à mão. A preparação manual produz o melhor QBR para uma conta de top-tier porque o CSM carrega contexto que nenhum registro guarda —a conversa de orçamento fora de registro, o champion que está saindo em silêncio. O custo é a hora-e-pico por conta, que não escala através de um book de 25 contas. Use preparação manual para o punhado de contas onde o contexto da relação é o deck; use a Skill para o resto, e mesmo nas contas top-tier comece a partir do rascunho da Skill e edite mais forte.

A vigiar

Scorecard default, história confiante. Uma conta cujo scorecard nunca foi configurado além do health pill default produz medidas que não significam nada, e uma narrativa construída sobre elas se lê plausível e não diz nada. Guarda: a Skill checa se o scorecard tem mais que a única medida default populada; se não, escreve o slide de uso-e-resultados como INSUFFICIENT_DATA: scorecard não configurado em vez de narrar ruído.
Success plan obsoleto. Um success plan não tocado por mais de 60 dias rende uma história de progresso que soa confiante mas está desatualizada. Guarda: a Skill lê a data de última modificação de cada meta; se a edição mais recente do plano é mais velha que 60 dias, antepõe SUCCESS_PLAN_STALE ao slide de onde-estávamos para que o CSM tenha que confirmar que as metas ainda valem antes de apresentá-las.
Deck anterior errado. Se last_deck_path aponta para o deck de outra conta ou outro trimestre, o framing “compromissos então versus realidade agora” quebra silenciosamente e a narrativa reporta contra as promessas erradas. Guarda: a passada de síntese extrai o nome da conta e o trimestre do primeiro slide do deck anterior e para com um erro de desajuste se qualquer um discordar dos inputs.
Desajuste de tom com o cliente. A voz default é a do time de CSM, que pode não coincidir com como um comprador enterprise espera ser tratado versus um startup. Guarda: quando as amostras de voz em references/3-sample-deck.md incluem decks que o cliente de fato recebeu, a passada de tom as pondera acima de docs internos; sem amostras escreve registro neutro e marca TONE_REVIEW_NEEDED no resumo executivo.
Jogadas de expansão que ultrapassam os dados. Pedido a priorizar expansão, um modelo vai fabricar um upsell plausível mesmo quando nenhum sinal de uso ou contrato o sustenta. Guarda: a priorização de expansão é restrita a jogadas respaldadas por um sinal nomeado (uma medida de uso com tendência de alta, folga do scorecard, assentos de contrato abaixo do entitlement); uma jogada sem sinal é descartada, não rebaixada, e se nenhuma se qualifica o slide diz isso em vez de encher.

Stack

Gainsight —registro Company, scorecard, success plan e rollup de uso; fonte de somente-leitura para todo o rascunho
Claude —pipeline de duas passadas: síntese (wins, riscos, expansão, história de uso) depois narrativa mais mapeamento de outline de slides (Sonnet recomendado por custo; Opus só se o voice match importa mais que o orçamento)
Sua ferramenta de deck —Google Slides ou PowerPoint; o CSM cola o Markdown slide a slide no template do time depois de editar

Editar esta página no GitHub