ooligo
claude-skill

Ein QBR-Deck aus Account-Daten mit Claude generieren

Difficulty
Fortgeschritten
Setup time
45-90 min
For
csm
Customer Success

Stack

Eine Claude Skill, die einen einzelnen Gainsight-Account in eine QBR-Narrative plus ein Outline Slide für Slide verwandelt: eine Executive-Headline, eine Usage-und-Outcomes-Story, die an die Success-Plan-Ziele des Accounts geknüpft ist, eine Tabelle offener Risiken und ein priorisiertes Set an Expansion-Plays. Der CSM erhält einen strukturierten Markdown-Entwurf — ein Block pro Slide, in der Reihenfolge, in der das Deck läuft — den er bearbeitet und in das Deck-Template des Teams einfügt, statt auf ein leeres Outline zu starren. Das Artifact-Bundle liefert SKILL.md plus drei Referenzdateien, die das CSM-Team einmal anpasst und über jeden Account hinweg wiederverwendet.

Dies ist der Narrative-und-Outline-Cousin der QBR-Prep-Skill, die auch Salesforce und Gong zieht. Wenn Sie in Gainsight leben und die Deck-Story direkt aus dem Account-Record, dem Scorecard und dem Success Plan Ihres CSP wollen, beginnen Sie hier.

Wann Sie sie einsetzen

Sie sind ein CSM, der einen QBR für einen bestimmten benannten Account vorbereitet, Gainsight ist Ihr System of Record für Health, Usage und Success-Plan-Ziele, und Sie wollen eine befüllte Narrative und ein Slide-Outline, das Sie bearbeiten können, statt ein leeres Deck. Die Skill ist für den Fall gebaut, in dem die QBR-Story vier Dinge zusammenflechten muss — wo der Account gegenüber den Commitments des letzten Quartals steht, was die Usage- und Outcome-Daten sagen, welche Risiken offen sind und wo die glaubwürdige Expansion liegt — und es in einer Slide-Reihenfolge landet, die ein Mensch verfeinern kann.

Sie produziert den nützlichsten Output, wenn der Gainsight-Scorecard konfiguriert ist (nicht nur das Default-Health-Pill), der Success Plan Ziele mit Zieldaten und Status hat und die Usage-Measures gegen ein echtes Baseline befüllt sind. Für Accounts, die diese Latte erreichen, landet der Entwurf nahe an deck-fertig. Für die, die es nicht tun, kennzeichnet die Skill die Lücke beim Namen, statt einen selbstsicheren Entwurf über fehlenden Daten zu schreiben.

Wann Sie sie NICHT einsetzen

Setzen Sie diese Skill nicht ein, um ein QBR-Deck automatisch zu versenden. Sie entwirft eine Narrative und ein Outline; sie rendert keine Slides und ersetzt nicht die Einschätzung der Beziehung durch den CSM. Jedes Deck erhält einen menschlichen Durchgang und eine Freigabe des Account-Teams zum Framing, bevor der Kunde es sieht.

Richten Sie sie nicht auf einen Account mit weniger als 30 Tagen Usage-Daten in Gainsight, einem leeren oder nie konfigurierten Scorecard oder einem Success Plan ohne erfasste Ziele. Die Skill ist gebaut, um zu kennzeichnen und zu verweigern, statt mit Allgemeinplätzen aufzufüllen — aber nur, wenn Sie die Verweigerung respektieren. Das Überschreiben des INSUFFICIENT_DATA-Flags produziert einen Entwurf, der sich gut liest und den Kunden in die Irre führt.

Setzen Sie sie nicht als Renewal-Wahrscheinlichkeits- oder Churn-Modell ein. Die Risikotabelle ist QBR-Framing — worüber im Raum gesprochen wird — kein kalibrierter Retention-Score. Wenn Sie eine verteidigbare Health-Zahl mit einer Why-Changed-Erklärung brauchen, bauen Sie stattdessen den zusammengesetzten Health-Score in n8n und lesen Sie die Risikotabelle dieser Skill als Kommentar, nicht als Signal.

Setzen Sie sie nicht für interne oder Board-Reviews ein. Die Narrative- und Tone-Pässe setzen ein externes Kundenpublikum und einen Renewal-oder-Expansion-Rahmen voraus.

Setup

Etwa 45 bis 90 Minuten beim ersten Mal, fast vollständig damit verbracht, die Slide-Reihenfolge Ihres Decks auf das Outline-Vokabular der Skill zu mappen und echte Voice-Samples einzuspielen. Nach dem ersten Account dauern Läufe ein paar Minuten.

  1. Installieren Sie die Skill. Legen Sie das Bundle aus apps/web/public/artifacts/qbr-deck-builder-skill/ in ~/.claude/skills/qbr-deck-builder/. Sie stellt einen einzigen Befehl bereit, build_qbr_deck(account_id, quarter), plus interne Helper für die Gainsight-Pulls, das Parsen des Success Plans und die Claude-Pipeline mit zwei Pässen.
  2. Verdrahten Sie die Gainsight-Credential. Setzen Sie GAINSIGHT_API_KEY und GAINSIGHT_DOMAIN mit Lesezugriff auf Company, Scorecard, Success Plan / CTA und die Usage-/Adoption-Objekte, die Ihre Org befüllt. Die Skill liest nur; sie schreibt nie nach Gainsight zurück. Wenn Ihre Usage-Daten in einem separaten Adoption-Objekt liegen, setzen Sie GAINSIGHT_USAGE_OBJECT auf dessen API-Namen — die Skill validiert die Feldnamen gegen references/1-deck-outline-map.md und verweigert das Befüllen der Usage-Slide, wenn sie driften.
  3. Mappen Sie Ihr Deck-Outline. Öffnen Sie references/1-deck-outline-map.md und ersetzen Sie das Slide-Manifest durch die tatsächliche Slide-Reihenfolge und die Titel Ihres Teams. Das Default-Outline ist Executive-Headline, Wo-wir-standen, Usage-und-Outcomes, Offene-Risiken, Expansion-Plays, Asks-und-nächste-Schritte — ordnen Sie um oder benennen Sie um, damit es zu dem Deck passt, das Sie tatsächlich präsentieren.
  4. Fixieren Sie die Success-Plan-Form. Öffnen Sie references/2-success-plan-format.md und übernehmen Sie entweder das Schema verbatim oder beschreiben Sie, wie Ihr Team Ziele in Gainsight erfasst (CTA-Typ, das Feld, das das Zieldatum hält, die Picklist, die den Status hält). Die Skill braucht eine stabile Form, um Ziel für Ziel zu parsen; eine nicht passende Form ist die häufigste Ursache für eine leere Outcome-Story.
  5. Spielen Sie Voice-Samples ein. Ersetzen Sie den Placeholder in references/3-sample-deck.md durch drei bis fünf anonymisierte frühere QBR-Narratives Ihres CSM-Teams, damit der Tone-Pass echtes Material zum Nachahmen hat. Ohne Samples schreibt die Skill in neutralem Register und kennzeichnet TONE_REVIEW_NEEDED.
  6. Führen Sie sie für einen Account aus. build_qbr_deck(account_id="1P01...XYZ", quarter="Q2-2026", last_deck_path="..."). Die Skill schreibt eine Markdown-Datei mit einem Fenced-Block pro Slide, plus eine einseitige Executive Summary von einem Absatz als separate Datei. Lesen Sie sie von oben nach unten, bearbeiten Sie und fügen Sie sie ins Deck ein.

Was die Skill tatsächlich tut

Die Skill zieht vier Dinge in einem Batch aus Gainsight: den Company-Record (ARR, Renewal-Datum, Segment, Lifecycle-Stage), den aktuellen Scorecard (jede Measure, ihren Score und ihren Trend gegenüber der Vorperiode), den aktiven Success Plan (jedes Ziel mit Zieldatum und Status) und das Usage-Rollup gegen das Baseline des Accounts. Wenn ein Pull leer zurückkommt, erfasst die Skill unavailable für diesen Input und fädelt ihn zu einem INSUFFICIENT_DATA-Flag auf der betroffenen Slide durch, statt Inhalt zu erfinden. Gainsight ist hier mit Absicht die einzige Quelle — eine Credential, ein Account-Record, eine Scorecard-Definition — damit der Entwurf reproduzierbar ist und die Datenherkunft für den bearbeitenden CSM offensichtlich ist.

Dann führt sie zwei Claude-Pässe aus, nicht einen. Pass eins ist die Synthese: Claude liest alle vier Inputs plus das vorherige QBR-Deck und baut ein internes Scratchpad — die an Success-Plan-Ziele geknüpften Wins, die Gaps, die Usage-und-Outcomes-Story gegen das Baseline, die offenen Risiken priorisiert nach Rot/Gelb/Grün und die Expansion-Plays priorisiert nach Signal (Usage-Trend, Scorecard-Stärke, Contract-Spielraum) und Confidence (hoch, mittel, niedrig). Die Synthese ist ihr eigener Pass, weil der nächste Pass ein kohärentes Bild braucht; Synthese und Slide-Schreiben in einen einzigen Pass zu falten, lässt die Slides den Input überbewerten, den Claude zuletzt gelesen hat, und die Expansion-Priorisierung degeneriert zu einer Liste statt einer Priorisierung.

Pass zwei ist Narrative-und-Outline. Claude liest die Voice-Samples aus references/3-sample-deck.md und schreibt das Scratchpad in die Stimme des Teams um — neutral, datengeführt, ohne Superlative — und mappt es dann auf die Slide-Reihenfolge aus references/1-deck-outline-map.md, ein Fenced-Block pro Slide. Das Outline-Mapping im zweiten Pass zu halten, bedeutet, dass das Umordnen oder Umbenennen von Slides nur diesen Pass neu ausführt; das Synthese-Scratchpad wird wiederverwendet. Die Executive Summary wird zuletzt aus der fertigen Narrative generiert, damit sie nie den Slides darunter widerspricht.

Der Output ist eine einzige Markdown-Datei — ein Fenced-Block pro Slide, in Deck-Reihenfolge, jeder Block mit dem Slide-Titel aus Ihrer Map als Überschrift — plus eine separate einseitige Executive Summary von einem Absatz. Der CSM bearbeitet immer, bevor das Deck gebaut wird. Die Skill ist eine Draft-Engine, kein Publisher.

Kostenrealität

Ein vollständiger Lauf kostet etwa 12.000 bis 22.000 Input-Tokens und 3.000 bis 6.000 Output-Tokens auf Claude Sonnet — sagen wir 5 bis 12 Cent pro QBR zu aktuellen Sonnet-Preisen. Sie ist billiger als die Prep-Skill mit Salesforce-plus-Gong, weil keine Call-Transkripte im Input sind; die Gainsight-Pulls sind strukturierte Records, keine 60-Minuten-Transkripte. Die Wall-Clock-Zeit beträgt eine bis drei Minuten pro Account, dominiert vom Gainsight-API-Batch in Pass null; die zwei Claude-Pässe fügen 30 bis 60 Sekunden hinzu.

Ein CSM, der eine QBR-Narrative von Grund auf baut, verbringt typischerweise 60 bis 120 Minuten pro Account damit, den Scorecard zu ziehen, die Commitments des letzten Quartals zu rekonstruieren und den Slide-Text zu entwerfen. Die Skill bringt das auf 20 bis 40 Minuten Bearbeitung, die Ersparnis ist also etwa eine Stunde pro QBR. Ein Book von 25 Accounts mit einem QBR pro Quartal sind etwa 25 eingesparte Stunden pro Quartal pro CSM — gegen eine Anthropic-Ausgabe unter 3 $ pro Quartal für dieses Book.

Wie Erfolg aussieht

Verfolgen Sie die Zeit von „Outline generiert” bis „Deck zur internen Review verschickt” pro QBR; die Skill sollte den Median innerhalb des ersten Nutzungsquartals unter 45 Minuten ziehen. Beobachten Sie die Rate der Entwürfe, die INSUFFICIENT_DATA-, SUCCESS_PLAN_STALE- oder TONE_REVIEW_NEEDED-Flags tragen — das sind Frühindikatoren für Upstream-Hygieneprobleme (Scorecards auf Defaults belassen, nicht gepflegte Success Plans, keine Voice-Samples), die die Skill per Design an die Oberfläche bringt; ein gesundes Quartal lässt sie sinken. Verfolgen Sie auch den Anteil der generierten Narrative, der den Edit-Pass des CSM überlebt: zielen Sie auf 70 % oder höher. Darunter brauchen die Gainsight-Daten Arbeit; über 90 % unter-bearbeitet der CSM wahrscheinlich einen Entwurf, der nie unbearbeitet rausgehen sollte.

Versus die Alternativen

Versus das Gainsight-native QBR / Success Snapshot. Gainsight liefert templatisierte QBR- und Success-Snapshot-Exporte, die Scorecard-Measures, Usage-Charts und NPS automatisch in ein Slide-Layout befüllen. Wenn Sie Felder in ein Deck gerendert haben wollen, ist das weniger Setup und das offensichtliche Default — es ist das Produkt, für das Sie bereits zahlen. Die Lücke, die es lässt, ist Narrative: es bringt Measures an die Oberfläche, es schreibt nicht die Story, die die Usage dieses Quartals mit den Commitments des letzten Quartals verbindet, und es priorisiert keine Expansion-Plays in Prosa. Diese Skill schreibt diese Story aus denselben Gainsight-Daten. Nutzen Sie den nativen Export für die Chart-Slides und diese Skill für die Narrative-Slides; sie sind komplementär, nicht konkurrierend.

Versus die QBR-Prep-Skill mit Salesforce-plus-Gong. Diese Skill fügt Salesforce-Account-Historie und Gong-Call-Themen zum Mix hinzu und ist die richtige Wahl, wenn aus Calls abgeleitete Farbe (Executive-Zitate, Wettbewerber-Erwähnungen) in Ihren QBRs tragend ist und Sie die Gong-Coverage haben, um sie zu stützen. Sie kostet mehr pro Lauf und braucht drei Credentials. Diese Skill ist die richtige Wahl, wenn Gainsight Ihre Source of Truth ist, Sie Gong nicht haben oder nicht verdrahten wollen und der Scorecard plus der Success Plan die Story tragen. Führen Sie die Gong-gestützte für strategische Accounts mit reicher Call-Historie aus; führen Sie diese für die Long Tail aus, die Sie aus dem CSP steuern.

Versus das Schreiben von Hand. Die manuelle Vorbereitung produziert das beste QBR für einen Top-Tier-Account, weil der CSM Kontext trägt, den kein Record hält — das Off-Record-Budgetgespräch, der Champion, der still geht. Die Kosten sind die Stunde-und-mehr pro Account, die über ein Book von 25 Accounts nicht skaliert. Nutzen Sie die manuelle Vorbereitung für die Handvoll Accounts, bei denen der Beziehungskontext das Deck ist; nutzen Sie die Skill für den Rest, und beginnen Sie selbst bei den Top-Tier-Accounts mit dem Entwurf der Skill und bearbeiten Sie härter.

Worauf zu achten ist

  • Default-Scorecard, selbstsichere Story. Ein Account, dessen Scorecard nie über das Default-Health-Pill hinaus konfiguriert wurde, produziert Measures, die nichts bedeuten, und eine darauf gebaute Narrative liest sich plausibel und sagt nichts. Guard: die Skill prüft, ob der Scorecard mehr als die einzelne Default-Measure befüllt hat; wenn nicht, schreibt sie die Usage-und-Outcomes-Slide als INSUFFICIENT_DATA: scorecard not configured, statt Rauschen zu narrieren.
  • Veralteter Success Plan. Ein Success Plan, der seit mehr als 60 Tagen nicht angefasst wurde, ergibt eine Fortschritts-Story, die selbstsicher klingt, aber veraltet ist. Guard: die Skill liest das Datum der letzten Änderung jedes Ziels; wenn die jüngste Bearbeitung des Plans älter als 60 Tage ist, stellt sie SUCCESS_PLAN_STALE der Wo-wir-standen-Slide voran, damit der CSM bestätigen muss, dass die Ziele noch gelten, bevor er sie präsentiert.
  • Falsches vorheriges Deck. Wenn last_deck_path auf das Deck eines anderen Accounts oder Quartals zeigt, bricht das Framing „Commitments damals versus Realität jetzt” still und die Narrative berichtet gegen die falschen Versprechen. Guard: der Synthese-Pass extrahiert den Account-Namen und das Quartal aus der ersten Slide des vorherigen Decks und hält mit einem Mismatch-Fehler an, wenn eines von beiden mit den Inputs nicht übereinstimmt.
  • Tone-Mismatch mit dem Kunden. Die Default-Stimme ist die des CSM-Teams, die möglicherweise nicht dazu passt, wie ein Enterprise-Käufer im Gegensatz zu einem Startup angesprochen werden möchte. Guard: wenn die Voice-Samples in references/3-sample-deck.md Decks enthalten, die der Kunde tatsächlich erhalten hat, gewichtet der Tone-Pass sie über interne Docs; ohne Samples schreibt sie in neutralem Register und kennzeichnet TONE_REVIEW_NEEDED auf der Executive Summary.
  • Expansion-Plays, die den Daten vorauseilen. Aufgefordert, Expansion zu priorisieren, fabriziert ein Modell einen plausiblen Upsell, selbst wenn kein Usage- oder Contract-Signal ihn stützt. Guard: die Expansion-Priorisierung ist auf Plays beschränkt, die durch ein benanntes Signal gestützt sind (eine aufwärts trendende Usage-Measure, Scorecard-Spielraum, Contract-Seats unter dem Entitlement); ein Play ohne Signal wird verworfen, nicht herabgestuft, und wenn keiner qualifiziert, sagt die Slide das, statt aufzufüllen.

Stack

  • Gainsight — Company-Record, Scorecard, Success Plan und Usage-Rollup; Read-Only-Quelle für den gesamten Entwurf
  • Claude — Pipeline mit zwei Pässen: Synthese (Wins, Risiken, Expansion, Usage-Story), dann Narrative plus Slide-Outline-Mapping (Sonnet für die Kosten empfohlen; Opus nur, wenn der Voice Match mehr zählt als das Budget)
  • Ihr Deck-Tool — Google Slides oder PowerPoint; der CSM fügt das Slide-für-Slide-Markdown nach dem Bearbeiten in das Team-Template ein