ooligo
claude-skill

Claude でアカウントデータから QBR デッキを生成する

Difficulty
中級
Setup time
45-90 min
For
csm
Customer Success

Stack

単一の Gainsight アカウントを QBR のナラティブとスライド単位のアウトラインに変換する Claude Skill です。エグゼクティブ向けの見出し、アカウントの success plan のゴールに紐づいた利用状況-と-成果のストーリー、オープンなリスクのテーブル、そして優先順位付けされた拡大プレイのセットを生成します。CSM は空白のアウトラインを見つめる代わりに、構造化された Markdown のドラフト(スライド 1 枚につき 1 ブロック、デッキが進む順序で並ぶ)を受け取り、それを編集してチームのデッキテンプレートに落とし込みます。artifact のバンドルには SKILL.md に加えて、CSM チームが一度適応させてすべてのアカウントで再利用する 3 つの参照ファイルが含まれます。

これは Salesforce と Gong も引いてくる QBR 準備スキル の、ナラティブ-と-アウトライン版のいとこです。Gainsight 中心に働いていて、CSP のアカウントレコード、scorecard、success plan から直接デッキのストーリーが欲しいなら、ここから始めてください。

いつ使うか

あなたは特定の named アカウント向けに QBR を準備している CSM で、Gainsight が health、利用状況、success plan のゴールの system of record であり、空白のデッキではなく編集できる populated なナラティブとスライドアウトラインが欲しい場合です。この Skill は、QBR のストーリーが 4 つのことを編み合わせなければならないケース向けに作られています。前四半期のコミットメントに対してアカウントがどこにいるか、利用状況と成果のデータが何を語っているか、どのリスクがオープンか、そしてどこに信頼できる拡大があるか。そしてそれを人間が refine できるスライド順序に落とし込みます。

Gainsight の scorecard が設定済みで(default の health pill だけでなく)、success plan にターゲット日付とステータス付きのゴールがあり、利用状況の measure が実際の baseline に対して populated されているとき、最も有用な output を生成します。そのバーを満たすアカウントについては、ドラフトはデッキにほぼ準備完了の状態で着地します。満たさないアカウントについては、欠落したデータの上に自信ありげなドラフトを書く代わりに、Skill はギャップを名指しでフラグします。

いつ使わないか

この Skill を QBR デッキの自動送信に使わないでください。ナラティブとアウトラインを起草するもので、スライドをレンダリングしませんし、CSM の関係性の読みを置き換えません。すべてのデッキは、顧客が見る前に人間のパスとアカウントチームによる framing の承認を受けます。

Gainsight に 30 日未満の利用状況データしかないアカウント、空または一度も設定されていない scorecard、ゴールが記録されていない success plan に向けないでください。Skill は一般論で埋める代わりにフラグして拒否するように作られていますが、それはあなたが拒否を尊重する場合に限ります。INSUFFICIENT_DATA フラグを上書きすると、よく読めるが顧客を誤解させるドラフトが生成されます。

renewal の確率や churn のモデルとして使わないでください。リスクテーブルは QBR の framing であり(部屋で何を話すか)、キャリブレーションされた retention スコアではありません。why-changed の説明付きの defensible な health の数値が必要なら、代わりに n8n での複合 health スコア を構築し、この Skill のリスクテーブルはシグナルではなくコメンタリーとして読んでください。

内部レビューや board レビューには使わないでください。ナラティブとトーンのパスは、外部の顧客オーディエンスと renewal-または-拡大のフレームを前提としています。

セットアップ

初回はおよそ 45 分から 90 分で、そのほとんどはデッキのスライド順序を Skill のアウトライン語彙にマッピングし、実際の voice サンプルを投入することに費やされます。最初のアカウントの後は、実行は数分です。

  1. Skill をインストールする。 apps/web/public/artifacts/qbr-deck-builder-skill/ のバンドルを ~/.claude/skills/qbr-deck-builder/ に置きます。build_qbr_deck(account_id, quarter) という単一のコマンドに加えて、Gainsight の pull、success plan のパース、Claude の 2 パスパイプライン用の内部ヘルパーを公開します。
  2. Gainsight の credential を接続する。 Company、Scorecard、Success Plan / CTA、そしてあなたの org が populate する利用/採用オブジェクトへの読み取りアクセス付きで GAINSIGHT_API_KEYGAINSIGHT_DOMAIN を設定します。Skill は読み取りのみで、Gainsight に書き戻すことは決してありません。利用データが別の採用オブジェクトにあるなら、その API 名を GAINSIGHT_USAGE_OBJECT に設定します。Skill はフィールド名を references/1-deck-outline-map.md に対して検証し、それらがドリフトすると利用スライドの記入を拒否します。
  3. デッキのアウトラインをマッピングする。 references/1-deck-outline-map.md を開き、スライドのマニフェストをあなたのチームの実際のスライド順序とタイトルに置き換えます。default のアウトラインは、エグゼクティブ見出し、私たちはどこにいたか、利用状況-と-成果、オープンなリスク、拡大プレイ、依頼-と-次のステップ、です。実際にプレゼンするデッキに合わせて並べ替えるか名前を変えてください。
  4. success-plan の形を固定する。 references/2-success-plan-format.md を開き、schema をそのまま採用するか、あなたのチームが Gainsight でゴールをどう記録するか(CTA のタイプ、ターゲット日付を保持するフィールド、ステータスを保持する picklist)を記述します。Skill はゴールごとにパースするために安定した形を必要とします。形のミスマッチは、空の成果ストーリーの最も一般的な原因です。
  5. voice サンプルを投入する。 references/3-sample-deck.md の placeholder を、あなたの CSM チームの匿名化された過去の QBR ナラティブ 3 つから 5 つに置き換え、トーンのパスが模倣する実際の素材を持てるようにします。サンプルがないと、Skill は中立的なレジスターで書き、TONE_REVIEW_NEEDED をフラグします。
  6. 1 アカウントで実行する。 build_qbr_deck(account_id="1P01...XYZ", quarter="Q2-2026", last_deck_path="...")。Skill はスライドごとに 1 つの fenced ブロックを持つ Markdown ファイルを 1 つ書き出し、加えて 1 段落のエグゼクティブサマリーを別ファイルとして書き出します。上から下まで読み、編集し、デッキに貼り付けます。

Skill が実際に行うこと

Skill は 1 つのバッチで Gainsight から 4 つのものを引きます。Company レコード(ARR、renewal 日付、セグメント、lifecycle ステージ)、現在の scorecard(各 measure、そのスコア、前期に対するトレンド)、アクティブな success plan(ターゲット日付とステータス付きの各ゴール)、そしてアカウントの baseline に対する利用状況の rollup です。いずれかの pull が空を返した場合、Skill はコンテンツを発明する代わりに、その input に unavailable を記録し、それを影響を受けるスライドの INSUFFICIENT_DATA フラグにスレッドします。ここで Gainsight が単一のソースなのは意図的です。1 つの credential、1 つのアカウントレコード、1 つの scorecard 定義であり、ドラフトが再現可能で、データの lineage がそれを編集する CSM にとって明白になるようにするためです。

次に Claude のパスを 1 つではなく 2 つ実行します。パス 1 は合成です。Claude は 4 つの input に加えて前回の QBR デッキを読み、内部の scratchpad を構築します。success plan のゴールに紐づいた wins、ギャップ、baseline に対する利用状況-と-成果のストーリー、赤/黄/緑で優先順位付けされたオープンなリスク、そしてシグナル(利用トレンド、scorecard の強さ、契約の余地)と確信度(高、中、低)で優先順位付けされた拡大プレイです。合成が独自のパスなのは、次のパスが 1 つの一貫した絵を必要とするからです。合成とスライド書きを 1 つのパスに折りたたむと、スライドは Claude が最後に読んだ input を過大に重み付けし、拡大の優先順位付けは優先順位付けではなくリストに degrade します。

パス 2 はナラティブ-と-アウトラインです。Claude は references/3-sample-deck.md の voice サンプルを読み、scratchpad をチームの voice(中立、データ主導、superlative なし)に書き直し、それを references/1-deck-outline-map.md のスライド順序にマッピングします。スライドごとに 1 つの fenced ブロックです。アウトラインのマッピングを 2 番目のパスに保つということは、スライドの並べ替えや名前変更がこのパスのみを再実行することを意味します。合成の scratchpad は再利用されます。エグゼクティブサマリーは、その下のスライドと決して矛盾しないように、完成したナラティブから最後に生成されます。

output は単一の Markdown ファイル(スライドごとに 1 つの fenced ブロック、デッキ順、各ブロックはあなたのマップのスライドタイトルが見出し)に加えて、別の 1 段落のエグゼクティブサマリーです。CSM はデッキが構築される前に必ず編集します。Skill はドラフトエンジンであり、publisher ではありません。

コストの実態

フル実行は Claude Sonnet で input トークンおよそ 12,000 から 22,000、output トークン 3,000 から 6,000 のコストです。現在の Sonnet 価格で QBR あたり 5 から 12 セントといったところです。Salesforce-と-Gong の準備スキルより安いのは、input に通話の transcript がないからです。Gainsight の pull は構造化されたレコードであって、60 分の transcript ではありません。実時間はアカウントあたり 1 から 3 分で、パス 0 の Gainsight API バッチが支配的です。2 つの Claude パスは 30 から 60 秒を加えます。

CSM が QBR のナラティブをゼロから構築する場合、scorecard を引き、前四半期のコミットメントを再構築し、スライドのテキストを起草するのに、アカウントあたり通常 60 から 120 分かかります。Skill はそれを 20 から 40 分の編集にし、節約はおよそ QBR あたり 1 時間です。四半期に 1 QBR で 25 アカウントの book は、CSM あたり四半期に約 25 時間の節約です。その book に対する Anthropic の支出は四半期に $3 未満です。

成功指標

QBR ごとに「アウトライン生成」から「内部レビューにデッキ送付」までの時間を追跡してください。Skill は使用開始の最初の四半期以内に中央値を 45 分未満に引き下げるはずです。INSUFFICIENT_DATASUCCESS_PLAN_STALETONE_REVIEW_NEEDED のフラグを持つドラフトの率を見てください。それらは upstream の衛生問題(default のまま放置された scorecard、メンテナンスされていない success plan、voice サンプルなし)の先行指標であり、Skill が設計上表面化させるものです。健全な四半期はそれらを下降させます。生成されたナラティブのうち CSM の編集パスを生き残る割合も追跡してください。70% 以上を目指します。それを下回ると Gainsight のデータに作業が必要です。90% を超えると、CSM はおそらく、編集なしで出すべきでないドラフトを過少編集しています。

代替案との比較

Gainsight ネイティブの QBR / Success Snapshot との比較。 Gainsight は、scorecard の measure、利用 chart、NPS をスライドレイアウトに auto-populate するテンプレート化された QBR と Success Snapshot のエクスポートを備えています。デッキにフィールドをレンダリングしたいなら、それはセットアップが少なく明白な default です。あなたがすでに支払っている製品です。それが残すギャップはナラティブです。measure を表面化させますが、今四半期の利用を前四半期のコミットメントに結びつけるストーリーは書かず、拡大プレイを散文で優先順位付けしません。この Skill は同じ Gainsight データからそのストーリーを書きます。chart 付きのスライドにはネイティブのエクスポートを、ナラティブのスライドにはこの Skill を使ってください。競合ではなく補完です。

Salesforce-と-Gong の QBR 準備スキル との比較。 そのスキルは Salesforce のアカウント履歴と Gong の通話テーマをミックスに加え、通話由来の color(エグゼクティブの引用、競合の言及)があなたの QBR で load-bearing で、それを支える Gong のカバレッジがあるときの正しい選択です。実行あたりのコストが高く、3 つの credential が必要です。この Skill は、Gainsight があなたの source of truth で、Gong を持っていないか接続したくなく、scorecard に success plan を加えたものがストーリーを担うときの正しい選択です。豊富な通話履歴を持つ戦略的アカウントには Gong 裏付けのものを、CSP から舵を取る long tail にはこれを実行してください。

手書きとの比較。 手動の準備は top-tier アカウントに最良の QBR を生み出します。CSM がどのレコードも保持しないコンテキスト(オフレコの予算の会話、静かに去ろうとしている champion)を抱えているからです。コストはアカウントあたり 1 時間超で、25 アカウントの book にはスケールしません。関係性のコンテキストがデッキそのものである一握りのアカウントには手動の準備を使い、残りには Skill を使ってください。top-tier アカウントでも Skill のドラフトから始めて、より強く編集してください。

注意点

  • default の scorecard、自信ありげなストーリー。 scorecard が default の health pill を超えて一度も設定されていないアカウントは、何も意味しない measure を生み、それに基づいて構築されたナラティブはもっともらしく読めて何も言いません。ガード: Skill は scorecard に単一の default measure 以上が populated されているかをチェックします。そうでなければ、ノイズをナレートする代わりに、利用状況-と-成果スライドを INSUFFICIENT_DATA: scorecard not configured として書きます。
  • 古い success plan。 60 日以上触られていない success plan は、自信ありげに聞こえるが時代遅れの進捗ストーリーをもたらします。ガード: Skill は各ゴールの最終更新日を読みます。プランの最新の編集が 60 日より古ければ、私たちはどこにいたかスライドに SUCCESS_PLAN_STALE を前置し、CSM がそれらを提示する前にゴールがまだ有効かを確認しなければならないようにします。
  • 間違った前回のデッキ。 last_deck_path が別のアカウントや別の四半期のデッキを指していると、「あの時のコミットメント vs 今の現実」の framing が静かに壊れ、ナラティブは間違った約束に対して報告します。ガード: 合成パスは前回のデッキの最初のスライドからアカウント名と四半期を抽出し、どちらかが input と食い違えばミスマッチエラーで停止します。
  • 顧客とのトーンのミスマッチ。 default の voice は CSM チームのもので、enterprise の買い手が扱われたいと期待する仕方と startup とでは一致しないかもしれません。ガード: references/3-sample-deck.md の voice サンプルに顧客が実際に受け取ったデッキが含まれている場合、トーンのパスはそれらを内部ドキュメントより重み付けします。サンプルがなければ中立的なレジスターで書き、エグゼクティブサマリーに TONE_REVIEW_NEEDED をフラグします。
  • データを追い越す拡大プレイ。 拡大を優先順位付けするよう求められると、モデルは利用や契約のシグナルが何も支えていなくても、もっともらしいアップセルを作り出します。ガード: 拡大の優先順位付けは、名指しのシグナル(上昇トレンドの利用 measure、scorecard の余地、entitlement を下回る契約 seat)に裏付けられたプレイに制約されます。シグナルのないプレイは降格ではなく drop され、どれも資格を満たさなければスライドは埋める代わりにそう述べます。

スタック

  • Gainsight —Company レコード、scorecard、success plan、利用 rollup。ドラフト全体の読み取り専用ソース
  • Claude —2 パスパイプライン: 合成(wins、リスク、拡大、利用ストーリー)の後にナラティブとスライドアウトラインのマッピング(コストには Sonnet を推奨。voice match が予算より重要な場合のみ Opus)
  • あなたのデッキツール —Google Slides または PowerPoint。CSM は編集後にスライド単位の Markdown をチームのテンプレートに貼り付けます