Communitygithub.com

amplitude/builder-skills

AI Visibilityデータを基に、公開可能なコンテンツ(記事、ランディングページ、FAQなど)を生成し、CMSに直接ドラフトとしてプッシュするスキルです。

builder-skills とは?

このスキルは、AmplitudeのAI Visibilityデータを活用し、コンテンツギャップを特定して公開可能な記事ドラフトを生成します。マーケティングやコンテンツチームが、AIモデルの回答における自社ブランドの可視性(表示率、平均順位、引用回数)を分析し、競合に劣るトピックを特定します。その後、最適なコンテンツタイプ(ブログ記事、ランディングページ、FAQなど)を提案し、実際にAIモデルに引用されやすい形式でフルドラフトを作成します。さらに、WordPress、Contentful、HubSpot CMS、Sanity、Ghost、WebflowなどのCMSにMCP経由でドラフトを直接プッシュできるため、コピー&ペーストの手間を省きます。このスキルはClaude Code、Cursor、CodexなどのAIエージェントツール上で動作し、AmplitudeのAI Visibilityデータ(トピック、プロンプト、可視性スコア、引用、競合データ、LLMの回答とソース)に直接アクセスします。ユーザーが「コンテンツギャップを見つけて」「何を書くべき?」「AIモデルに引用されるには?」「ブログ記事を作成して」などと曖昧に依頼した場合でも、AI Visibilityのコンテキストであれば自動的にトリガーされます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/prompt-gap-to-publish

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

プロンプトギャップから公開へ

マーケティングまたはコンテンツチームが、AI Visibilityのギャップを実際に公開するコンテンツに変えるお手伝いをします。 核となる洞察:AIモデルがプロダクトカテゴリに関する質問に答えるとき、ブランドの存在は測定可能です — 可視性%、平均順位、引用回数。弱いところが、書くべきところです。このスキルはそれらのギャップを見つけ、公開可能な記事ドラフトを生成し、ユーザーのCMSにドラフトとして直接プッシュします。


ステップ0 — CMS検出(セッション開始時に一度だけ実行)

データを取得する前に、コンテンツの公開先を特定します。これにより、ユーザーが最後にコピー&ペーストで行き詰まるのを防ぎます。

既に接続されているCMSツールを確認

現在のコンテキストで利用可能なツールを確認します。既知のCMS MCPパターンは以下の通りです:

CMS確認するMCPツール名パターン
Sanitysanity、create_documents_from_markdown、publish_documents
Contentfulcontentful、create_entry、publish_entry
HubSpot CMShubspot、create_blog_post、update_blog_post
WordPresswordpress、wp_create_post
Ghostghost、create_post
Webflowwebflow、create_cms_item

CMS MCPが既に接続されている場合: 問題ありません — 次のように一文でユーザーに確認します: 「[CMS]が接続されているのを確認しました — 記事ができたらドラフトとしてプッシュします。よろしいですか?」 その後、ステップ1に進みます。

CMS MCPが検出されなかった場合: ユーザーに直接尋ねます。簡潔かつ丁寧に — これは一度だけのセットアップです:

「本題に入る前に — 公開先のCMSはどちらですか? 教えていただければ、記事をドラフトとして自動的にプッシュできます。Markdownブロックを渡すだけではありません。」

以下の選択肢を提示するか、ユーザーが自由に入力できるようにします:

  • Sanity
  • Contentful
  • HubSpot CMS
  • WordPress
  • Webflow
  • Ghost / Shopify / その他
  • 「今はMarkdownだけでいい」

回答に基づいて統合を推奨

CMSがわかったら、短く具体的なセットアップの推奨事項を伝え、その間に続行するオプションを提供します:

Sanity:

「Sanity MCPコネクタはCoworkマーケットプレイスで利用可能です。設定 → プラグイン → 'Sanity' を検索し、プロジェクトIDとトークンで接続してください。約2分で完了します。その間にコンテンツギャップを見つけましょうか? 接続が完了したらドラフトをプッシュできるように準備しておきます。」

Contentful:

「Contentful MCPコネクタが利用可能です。設定 → プラグイン → 'Contentful' を検索し、Space IDとContent Management APIトークンを追加してください。今すぐギャップを見つけますか?」

HubSpot CMS:

「HubSpotは既にGlean経由で接続されている可能性があります。接続されていない場合は、設定 → プラグインで 'HubSpot' を検索してください。完了したらブログ記事のドラフトを作成します。」

WordPress:

「WordPressはMCP経由で接続できます(設定 → プラグインで 'WordPress' を検索、サイトURLとWordPress管理画面からのアプリケーションパスワードが必要です)。または、Chromeを使用してWordPress管理画面に直接ドラフトを作成することもできます。どちらが良いですか?」

Webflow:

「WebflowのCMS APIが最も簡単な方法です — 設定 → プラグインで 'Webflow' を検索し、APIキーとコレクションIDで接続してください。プラグインを設定しない場合は、Chrome経由で自動化することもできます。」

Ghost:

「Ghostは十分に文書化されたAdmin APIを備えています。設定 → プラグインで 'Ghost' を検索し、Admin APIキーとサイトURLを追加してください。すぐに設定できます。」

「今はMarkdownだけでいい」:

「問題ありません — 最後にクリーンなMarkdownファイルをお渡しします。任意のCMSにそのまま貼り付けられる形式です。後でCMSを接続すれば、直接プッシュすることもできます。」

推奨事項を伝えた後、ユーザーが設定を完了するのを待たずに、次のように言います: 「これからコンテンツギャップの取得を開始します。記事が準備できる頃には、設定が完了しているはずです。」 その後、ステップ1に進みます。

どのCMSが指定されたか、接続済みかどうかを保存します — ステップ6で使用します。


ステップ1 — ブランドの特定

list_ai_visibility_org_brands を使用して利用可能なブランドを取得します。その後:

  • ユーザーが特定のブランド名を指定した場合は、それに一致させます。
  • リストにブランドが1つしかない場合は、尋ねずに使用します。
  • それ以外の場合は、リストを表示してユーザーに選択してもらいます。

orgBrandId をメモします — 全体を通して必要になります。


ステップ2 — 最新レポートのトピックデータを取得

選択した orgBrandId で get_ai_visibility_topics を使用します(reportId を省略して最新を取得)。各トピックについて以下を取得:topicId、topicName、visibilityPercentage、averageRank、relevancyScore、および引用回数。

機会ヒューリスティック: 関連性スコアが60%を超え、可視性が40%未満のトピックは金鉱です — AIモデルはそれらをブランドのカテゴリの中核とみなしているが、ブランドにはほとんど言及していません。また、競合が20ポイント以上リードしているトピックもフラグします。


ステップ3 — プロンプトの詳細調査

上位3〜5の機会トピックについて、get_ai_visibility_prompts を topicId で使用します。以下のプロンプトを探します:

  • ブランドの可視性が0%または非常に低いプロンプト
  • 競合が回答を支配しているプロンプト
  • 応答数が多いプロンプト(AIの回答が多い = 引用の機会が多い)

利用可能な場合は、get_ai_visibility_prompt_responses を使用して、最も弱いプロンプトに対する実際のLLM生成回答を読み取ります — これにより、AIモデルが現在何と言っているかが正確にわかります。より良い回答を書くための最良のブリーフィングです。


ステップ4 — 機会をランク付けして提示

3〜5のコンテンツ機会のランク付けされたショートリストを提示します:

#トピック代表的なプロンプトAmplitude可視性主要競合コンテンツタイプ
1..."..."X%競合Y%ランディングページ

コンテンツタイプガイド:

  • ブログ記事 — 情報提供/比較クエリ(「Xとは?」「X vs Y」「Xはどう機能するか?」)
  • ランディングページ — 意図の高いクエリ(「最適なXツール」「[ユースケース]向けX」)
  • FAQページ — 1つのトピックに関連する質問のクラスター
  • 製品説明 — ブランドが確定的な情報源となるべき機能固有のクエリ

「これらのうち、どれを最初に書きたいですか?」 と尋ねます。選択を待ちます。


ステップ5 — コンテンツドラフトの生成

選択された機会に対して、完全で公開可能なドラフトを書きます。骨組みではなく、実際の文章、実際のコンテンツ。ユーザーが今日CMSに貼り付けられるものでなければなりません。

常に含めるもの

コンテンツブリーフ(冒頭):

  • ターゲットプロンプト/質問
  • 検索意図:情報提供/ナビゲーション/取引
  • 主なオーディエンス
  • 競合ギャップ:競合が言っていることでブランドが言っていないこと
  • LLMインサイト:AIモデルが現在このトピックについて言っていることの引用または言い換え

記事フィールド:

  • slug — URLフレンドリー、キーワードリッチ
  • metaTitle — 50〜60文字、主要キーワードを含む
  • metaDescription — 140〜160文字、記事を要約しCTAを含む

記事本文:

  • H1 — ターゲットプロンプトに近い
  • 導入部(2〜3段落) — フック、ブランドの権威、記事のプレビュー
  • 本文(3〜6のH2セクション) — 包括的な回答;具体的な詳細を含む製品機能を引用;データや例を含める;各セクションはそれ自体で有益であること
  • FAQブロック(3〜5のQ&A) — ステップ3から密接に関連するプロンプトを取得;各回答2〜4文;これらはAIモデルが最も確実に引用する形式です
  • 内部リンク(3〜5の提案) — 可能性のあるページ名やURLパターンを参照
  • CTA — 明確な次のステップ

AIモデルに引用されるコンテンツのヒント

  • 最初の2文で正確な質問に答える。AIモデルは直接答えるソースを引用します。
  • 製品機能について具体的に述べる。「AmplitudeはXを追跡します」は「私たちは企業の成長を支援します」よりも優れています。
  • 競合を公平に扱う。競合を認める記事は、存在しないふりをする記事よりもランクが高くなります。
  • AIモデルが使用する正確なフレーズを使用する。H1と最初の段落でプロンプトの言語を反映させる。
  • FAQブロックは最も強力な引用磁石です — 流れるような散文ではなく、直接的なQ&Aとしてフォーマットします。

ステップ6 — CMSに公開

ステップ0で得た情報を使用します。

CMS MCPが接続されている場合

直接ドラフトを作成します。以下の順序に従います:

  1. ユーザーにスラッグ、タイトル、最初の100語を表示し、「これを[CMS]にドラフトとしてプッシュしてもよろしいですか?」 と尋ねます。
  2. 確認が取れたら、ステータス draft でドラフトを作成します(明示的な指示がない限り published にしない)。
  3. ユーザーがすぐに見つけられるように、ドラフトURLまたはドキュメントIDを報告します。

Sanity — create_documents_from_markdown を記事コンテンツで使用します。_type をユーザーのブログ投稿スキーマに合わせて設定します(不明な場合は尋ねる:「Sanityスキーマのブログ投稿のドキュメントタイプは何ですか?」)。publish_documents は、ユーザーが明示的に公開を要求した場合のみ使用します。

Contentful — create_entry を contentType がブログまたは記事タイプに一致するように使用します。fields.title、fields.slug、fields.body を設定します。published: false のままにします。

HubSpot — state: DRAFT でブログ投稿作成ツールを使用します。API呼び出しにメタ説明とスラッグを含めます。

WordPress — wp_create_post を status: draft で使用します。H1を title に、記事本文を content にマッピングします。

Ghost — create_post を status: draft で使用します。slug、title、html または lexical、meta_description を含めます。

Webflow — create_cms_item をブログコレクションを対象として使用します。フィールドをコレクションのスキーマにマッピングします(スキーマがコンテキストから明らかでない場合は、ユーザーにフィールド名を尋ねます)。

CMSがまだ接続されていない場合

ユーザーが「Markdownだけでいい」と言った場合、またはCMSがまだ接続されていない場合:

「こちらが完全な記事のMarkdownです — [CMS]に貼り付ける準備ができています。後で[CMS]を接続する準備ができたら、今後の記事を自動的にプッシュできます。」

完全な記事をクリーンで構造化されたMarkdownブロックとして出力します。

また、次のように言います:「今すぐ[CMS]接続のセットアップをお手伝いしましょうか? 約2分で完了します。」 「はい」の場合は、ステップ0のプラグインセットアップを案内します。

常にMarkdownフォールバックを出力します — CMS作成が成功した場合でも — ユーザーが所有するローカルコピーを持つためです。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

amplitude/builder-skills

Performs deep analysis of a specific Amplitude chart to explain trends, anomalies, and likely drivers. Use when a metric looks unusual, investigating a spike or drop, or understanding the "why" behind numbers.

amplitude/builder-skills

Deeply analyze Amplitude dashboards by analyzing key charts, surfacing top areas for concern and takeaways, identify anomalies, then explain changes using customer feedback trends.

amplitude/builder-skills

Designs A/B tests with proper metrics and variants, analyzes running or completed experiments, and interprets results with statistical rigor. Use when setting up experiments, checking experiment status, analyzing results, or making ship decisions.

amplitude/builder-skills

Synthesizes customer feedback into actionable themes including feature requests, bugs, pain points, and praise. Use when planning product roadmap, understanding user sentiment, investigating specific issues, or preparing voice-of-customer reports.

amplitude/builder-skills

Analyze MCP server usage instrumented with Amplitude's MCP Analytics SDK: break usage and errors down by tool, read the rationales within each tool to see what callers are trying to do, and produce a prioritized write-up of actionable fixes. Use this skill whenever the user asks to understand how their MCP server is being used, what agents/users are trying to do with it, why tool calls are failing, what to fix or improve in their MCP server, or asks for an "MCP usage report", "tool error analysis", "intent analysis", "rationale clustering", or "MCP insights". Also trigger when the user mentions [MCP]-prefixed events, tool rationale, tool call errors, or just finished instrumenting their MCP server and wants to see what the data says. Requires the Amplitude MCP connector.

amplitude/builder-skills

Read lost deals and churned accounts from your CRM, extract reasons clustered by theme (missing features, pricing, competitors, UX), and write a prioritized weekly analysis with product improvement recommendations. Use before roadmap planning or to build the case for prioritizing retention work.

amplitude/builder-skills

Creates Amplitude charts from natural language descriptions, handling event selection, filters, groupings, and visualization choices. Use when you know what you want to measure but prefer not to build the chart manually.

amplitude/builder-skills

Guide an Amplitude user through building a custom agent by suggesting use cases grounded in their role and data, shaping the idea into a well-formed spec, and generating a ready-to-run Global Agent deeplink that creates it. Use to create, build, or set up a custom agent, automate a recurring analysis, or put a repeated report on a schedule.

amplitude/builder-skills

Builds comprehensive Amplitude dashboards from requirements or goals, organizing charts into logical sections with appropriate layouts. Use when creating a complete dashboard from scratch or assembling existing charts into a cohesive view.

amplitude/builder-skills

Monitors all active and recently completed experiments across Amplitude projects, triages them by importance, then runs deep analysis and reporting on the most impactful ones. Use when the user asks to "check on experiments", "experiment status", "experiment review", "what experiments are running", or wants a periodic experiment health report.

amplitude/builder-skills

Pull Intercom tickets and Slack support messages from the past 7 days, classify each signal, enrich with CRM data (ARR, plan, renewal), score by customer value and churn risk, and output a tiered priority report saved to Drive. Use when you need a fast, data-driven view of what support signals matter most.

amplitude/builder-skills

Use this skill whenever a user wants to improve existing pages on their website to get cited more by AI models — whether they say "our pages aren't getting cited", "improve this page for AI visibility", "which of our pages should we update", "make this article more cite-worthy", "our competitors are getting cited instead of us", "update our content for AI search", or any variation where the goal is improving an existing asset rather than creating something new. This skill pulls owned pages from AI Visibility, identifies which ones have citation potential but are underperforming, compares them against the external pages that are winning citations on the same topics, and produces section-level rewrites or a full-page update — then pushes the revision to the CMS as a draft. Trigger even if the user just says "help me get cited more" or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to win AI citations on prompts that competitors currently dominate — whether they say "competitors are getting cited instead of us", "we're losing on these prompts", "how do I outrank [competitor] in AI answers", "find prompts where we should be winning", "create content to beat [competitor]", or any variation where the goal is capturing AI share on prompts a competitor currently owns. This skill pulls competitor visibility data from AI Visibility, identifies the specific prompts where competitors win and Amplitude is absent, clusters them by intent, and produces targeted comparison pages, alternatives content, or rebuttal assets — then pushes drafts to CMS. Trigger on any mention of competitor, prompt hijack, outrank, or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to test content variants before publishing to find which one will get cited most by AI models — whether they say "which version of this content will perform better", "test this article before we publish", "simulate how AI will respond to this content", "which angle should we use", "generate content variants and pick the winner", "run a simulation before publishing", or any variation where the goal is data-driven content selection rather than gut-feel publishing. This skill takes an identified content opportunity, generates 2–3 distinct variants with different angles or structures, scores them against actual AI model responses from AI Visibility, references the Simulate Changes feature for pre-publish validation, and produces a clear recommendation on which variant to publish — then pushes the winner to CMS. Trigger on any mention of "simulate", "test variants", "which performs better", "A/B content", or "before we publish".

amplitude/builder-skills

Use this skill whenever a user wants to understand which external sources are being cited by AI models on topics relevant to their brand, and wants to create content that will outrank those sources — whether they say "what sources are AI models citing", "why is [third-party site] being cited instead of us", "we want to be the definitive source on X", "build something that gets cited more than G2 or TechRadar", "create an authoritative asset", or any variation where the goal is producing a new reference asset (definition page, benchmark, methodology, glossary, comparison hub) designed to beat existing top-cited sources. This skill analyzes AI Visibility source data, reverse-engineers what makes top-cited pages authoritative, and produces a superior source asset — then pushes it to CMS as a draft. Trigger on any mention of "sources", "third-party citations", "authoritative content", "definitional pages", or "outrank".

amplitude/builder-skills

Instrument a Node/TypeScript MCP server with Amplitude's @amplitude/mcp-analytics SDK so tool calls, sessions, and rationale are tracked as Amplitude events. Use this skill whenever the user wants to add Amplitude analytics to their MCP server, mentions "MCP Analytics", "@amplitude/mcp-analytics", "instrument my MCP server", "track MCP tool calls", "add rationale to my MCP tools", or wants agent traffic (Claude, Cursor, ChatGPT) attributed back to Amplitude. Also use for adding UTM tagging to MCP-returned links, or for troubleshooting identity/user_id mismatches between MCP events and web/mobile Amplitude data.

amplitude/builder-skills

Instruments a pull request with Amplitude analytics that conform to the project's existing taxonomy. Reads the tracking plan via the Amplitude MCP server (events, properties, naming conventions), analyzes the PR diff to find the few user actions genuinely worth tracking, detects the codebase's SDK and tracking patterns, and adds instrumentation that matches both. Optionally (opt-in) stages new events and properties on an Amplitude tracking-plan branch for data-governance review. Use when asked to "instrument this PR", "add analytics to this change", "add tracking", "add Amplitude events", "instrument this feature", or "what should I track here".

amplitude/builder-skills

Diagnoses product health by cross-referencing Amplitude analytics (dashboards, charts, funnels, feedback, AI agent analytics), optionally Datadog (errors, latency, stack traces), and optionally Slack (qualitative feedback, bug reports, feature requests). Identifies what's broken, what's working, and what to do about it — with root causes, not just symptoms. Use when asked to "diagnose my product", "what's going on", "product health check", "what's broken", "where are users struggling", "give me a product diagnosis", or "what should I focus on".

amplitude/builder-skills

Turn one or more meeting transcripts, notes, or Slack threads into concise takeaways and clear action items with DRIs. Works with a single meeting or a batch from the whole week.

amplitude/builder-skills

Summarizes B2B account health by analyzing usage patterns, engagement trends, risk signals, and expansion opportunities. Use for customer success reviews, renewal preparation, QBRs, or account prioritization.

関連スキル