Communitygithub.com

amplitude/builder-skills

このスキルは、ユーザーが既存のウェブページを改善してAIモデルに引用されやすくしたい場合に使用します。「ページが引用されない」「このページをAI向けに可視性向上させたい」「どのページを更新すべきか」「この記事をもっと引用に値するものにしたい」「競合が代わりに引用されている」「AI検索向けにコンテンツを更新したい」など、新しいものを作成するのではなく既存の資産を改善することが目的の場合にトリガーします。このスキルは、AI Visibilityから自社ページを取得し、引用の可能性があるもののパフォーマンスが低いページを特定し、同じトピックで引用を獲得している外部ページと比較し、セクションレベルのリライトまたはページ全体の更新を生成し、そのリビジョンを下書きとしてCMSにプッシュします。ユーザーが単に「もっと引用されるように助けて」や「なぜ[競合]が私たちの代わりに引用されているのか」と言った場合でもトリガーします。

builder-skills とは?

このスキルは、既存のウェブページをAIモデルに引用されやすくするためのワークフローを提供します。新しいコンテンツをゼロから作成するよりも、すでに何らかのシグナルがある既存ページを改善する方が効率的です。AI Visibilityのデータを活用し、自社のどのページがすでに引用されているか、どの競合ページが同じトピックで勝利しているかを特定します。両者のギャップこそがリライトの焦点です。主要なプラットフォーム(Sanity、Contentful、HubSpot CMS、WordPress、Ghost、Webflow)向けのCMS統合をサポートしており、修正内容を下書きとして直接CMSにプッシュできます。ワークフローは7つのステップで構成され、CMSの検出、ブランドの特定と自社ページの取得、競合ページの分析、ページのスコアリングと優先順位付け、診断、リライトの生成、そしてシミュレーションとCMSへのプッシュを含みます。ターゲットを絞ったセクションレベルの修正を優先し、AIモデルに引用されるための具体的なベストプラクティス(迅速な回答、FAQブロック、具体性、比較表、公正な競合カバレッジ)を適用します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/citation-recovery-optimizer

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

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

ドキュメント

引用回復オプティマイザー (Citation Recovery Optimizer)

あなたは、既存のページからより多くのAI引用を引き出せるようコンテンツチームを支援しています。論理はこうです:何らかのシグナルがすでにあるページを改善する方が、ゼロから構築するよりも速い。AI Visibilityは、どの自社ページがすでに引用されているか、そして同じトピックでどの競合ページが勝っているかを示します。その2つのギャップこそ、まさにリライトが入り込む場所です。


ステップ0 — CMSの検出 (各セッションの開始時に1回実行)

他のことをする前に、改訂されたコンテンツがどこに配置されるかを把握します。これにより、ワークフローの最後でのコピーペーストの行き詰まりを回避します。

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

コンテキストで現在利用可能なツールをスキャンします。既知のCMS MCPパターン:

CMS探すべきツール名パターン
Sanitysanity, create_documents_from_markdown, patch_document_from_markdown
Contentfulcontentful, create_entry, update_entry
HubSpot CMShubspot, update_blog_post, create_blog_post
WordPresswordpress, wp_update_post, wp_create_post
Ghostghost, update_post, create_post
Webflowwebflow, update_cms_item, create_cms_item

CMS MCPがすでに接続されている場合: 一言で確認します。 「[CMS]が接続されているのを確認しました。完了次第、改訂されたコンテンツを更新下書きとしてそこにプッシュします。よろしいでしょうか?」 その後、ステップ1に進みます。

何も接続されていない場合: 簡潔に一度だけ尋ねます。

「始める前に — どちらのCMSに公開していますか? 改訂されたコンテンツをテキストのブロックとして渡す代わりに、下書きとして直接そこにプッシュできます。」

選択肢を提示します:Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · その他 · 「リライトをテキストで渡して」

その後、回答に基づいて調整されたセットアップの推奨事項を提供します(prompt-gap-to-publishスキルと同じガイダンスを参照)。セットアップを待たずに分析をすぐに開始し、接続が完了する頃にはプッシュの準備ができていると伝えます。


ステップ1 — ブランドを特定し、自社ページを取得する

list_ai_visibility_org_brands を使用してブランドを特定します(またはユーザーが指定したものを使用します)。

次に、2つの主要な制約を指定して get_ai_visibility_pages を呼び出します。

  • orgBrandId = 選択されたブランド
  • mentionsBrandId = 同じブランドID(これにより、ブランドに言及しているページにフィルタリングされます)
  • sortBy: "citationCount"

結果から、ブランド自身のドメイン上のページにフィルタリングします — 例:amplitude.com(pendo.io や g2.com ではない)。各ページのドメインフィールドでこれが簡単にできます。これらがあなたが改善する自社アセットです。

自社ページごとに以下を収集します。

  • url と title
  • citationCount と responseCount
  • type (landing-page, blog, product-comparison, listicle)
  • brandNames — このページで一緒に言及されている他のブランド(トピックの範囲を示します)

ステップ2 — 同じトピックで勝っている競合ページを見つける

自社ページがカバーする同じトピックについて、最も高い引用数を持つ外部ページを取得します。再度 get_ai_visibility_pages を呼び出しますが、今回はドメインフィルタなしで、単に citationCount でソートし、同じブランドに言及し、トピックが重複している他のドメインのページを探します。

また、citationCount でソートされた get_ai_visibility_sources を呼び出して、全体的に最も多くの引用を獲得しているドメインを確認します。自社サイトよりもはるかに高いランクのドメインは、詳細に調査する価値のある競合です。

構築するのは比較です:各自社ページについて、同じトピックで勝っている外部ページはどれか、そしてその差はどれくらいか?例:

自社ページ自社の引用数トップ競合ページ競合の引用数
amplitude.com/compare/best-session-replay-tools49contentsquare.com/blog/session-replay180

このギャップこそが機会です — そして競合ページの構造は、このトピックでよく引用されるページがどのようなものかという参考になります。


ステップ3 — ページをスコアリングし優先順位付けする

すべてのパフォーマンス不足のページが同じ努力をする価値があるわけではありません。各自社ページを以下でスコアリングします。

引用ギャップ(最優先シグナル):競合の引用数 - 自社の引用数。自社が49の引用数で競合が180の場合、ギャップは131 — これは価値の高いリライトです。

ページタイプのレバレッジ:product-comparisonページとlisticleページは、「ベストX」というプロンプトに直接答えるため、AIモデルに強く引用される傾向があります。概念的なトピックに関するブログ記事も強力です。ランディングページやホームページは特定のクエリで引用されることはめったにありません — これらは優先しないでください。

トピックの関連性:ページのトピックをAI Visibilityのトピックとクロスリファレンスします。ブランドの関連性が高いが可視性が低いトピックをページがカバーしている場合、引用ギャップはさらに活用しやすくなります。

ユーザーに、修正すべき3〜5ページのランク付けされたショートリストを提示し、引用ギャップと各ページの一行診断を示します。

#ページ自社の引用数ギャップ診断
1/compare/best-session-replay-tools49−131競合はレイジクリック、スクロール深度、モバイルリプレイをカバーしているが、このページはカバーしていない
2/compare/best-ab-testing-platforms-for-mobile-apps30−95統計手法の説明とFAQが欠けている;競合には両方ある

尋ねます:「どのページを最初に修正しますか?」 選択を待ちます。


ステップ4 — 選択されたページを診断する

選択された自社ページの実際のコンテンツを web_fetch または利用可能なChromeを使用して取得します。次に、トップ競合ページも同じ方法で取得します。両方を注意深く読みます。

以下の次元で比較します。

回答の直接性 — 自社ページは、最初の2文でコアとなるAIプロンプトに答えていますか?引用される競合ページは通常そうしています。自社ページが回答を埋もれさせている場合、それが最初の修正ポイントです。

FAQカバレッジ — 自社ページに構造化されたFAQブロックはありますか?質問の数を数えてください。引用を独占している競合ページは、多くの場合5〜10の直接的なQ&Aを持っています。自社ページにFAQがない場合、または散文に埋もれている場合、それは価値の高い修正ポイントです。

具体性 — 自社ページは製品について具体的な主張(「レイジクリック、スクロールヒートマップ、セッション記録を同時に追跡」)をしていますか、それとも曖昧なもの(「ユーザー行動の理解を支援」)ですか?AIモデルは具体性を引用し、一般論は引用しません。

欠落しているセクション — 競合ページにあって自社ページにないH2セクションは何ですか?それぞれをリストアップします。これらは埋めるべきギャップです。

競合フレーミング — 自社ページは競合環境を公正に認識していますか?ツールを正直に比較するページは、代替手段が存在しないふりをするページよりも、AIの応答で上位にランクされる傾向があります。

構造的シグナル — スキーママークアップ、見出し階層、目次、比較表。これらはAIモデルによる解析性を向上させます。

何かを書く前に、診断を発見事項の短いリストとして要約します。ユーザーがあなたの発見を確認し、リライトを開始する前に同意できるようにします。


ステップ5 — リライトを生成する

診断に基づいてリビジョンを作成します。ページに根本的な構造的問題がない限り、全ページリライトよりも外科的なセクションレベルのパッチを優先します。ターゲットを絞ったリライトはレビューが速く、承認が容易で、すでに機能している部分を壊す可能性が低くなります。

セクションレベルのパッチの形式

変更された各セクションについて、明確なbefore/afterを示します。

### セクション: [H2見出し]

BEFORE:
[元のテキスト、引用または言い換え]

AFTER:
[改訂されたテキスト — 完全な文、骨組みではない]

WHY: [診断に結びついた1文の根拠]

修正すべき内容(優先順位順)

  1. 冒頭段落 — 最初の2文でコアとなるAIプロンプトに直接答えるように書き換えます。読者が答えを見つけるためにスクロールする必要がないようにします。

  2. 欠落しているセクション — 競合ページにあって自社ページにないH2セクションを追加します。Amplitude固有の機能と具体的な詳細を含めて、完全に記述します。

  3. FAQブロック — 欠落している場合は追加します。弱い場合は拡張します。関連トピックの get_ai_visibility_prompts からの実際のプロンプトを質問ソースとして使用します。各回答は2〜4文で、直接的で、少なくとも1つの製品固有の事実を含める必要があります。

  4. 具体性のアップグレード — 曖昧な文(「チームが行動を理解するのを支援」)をすべて見つけ、具体的なもの(「クリックマップ、スクロール深度、レイジクリック、デッドクリックをファネル離脱とともに表示し、ユーザーがどこでなぜ離脱するかを正確に把握できます」)に置き換えます。

  5. 比較表 — ページがツールを比較していて機能表がない場合は、追加します。AIモデルは構造化された比較データを引用するのが大好きです。

更新するメタフィールド

リライトには常に更新されたメタフィールドを含めます。

  • metaTitle — 50〜60文字、キーワードリッチ
  • metaDescription — 140〜160文字、コアクエリに答えCTAを含む
  • slug — 正しいことを確認し、明らかに最適でない場合のみ変更を提案します

ステップ6 — 公開前にシミュレーションする(推奨、必須ではない)

CMSにプッシュする前に、AI Visibilityの「変更をシミュレーション」機能について言及します。

「AI Visibilityには、公開前に更新されたコンテンツのパフォーマンスを予測できる「変更をシミュレーション」機能があります。最初にそれを実行したい場合は、改訂されたコンテンツをAI Visibilityダッシュボードの「変更をシミュレーション」に貼り付け、予測される引用改善を確認してください。待つことも、今下書きをプッシュして並行してシミュレーションすることもできます。」

ユーザーに決定させます。最初にシミュレーションしたい場合は、ここで一時停止し、何を貼り付けるべきかを伝えます。プッシュの準備ができている場合は、ステップ7に直接進みます。


ステップ7 — 更新をCMSにプッシュする

ステップ0で発見したものを使用します。

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

これは既存ページへの更新であり、新しいドキュメントではありません。作成操作ではなく更新操作を使用します。

Sanity — 既存ページのドキュメントIDを指定して patch_document_from_markdown を使用します。変更されたフィールドのみをパッチします。ドキュメントIDがない場合はユーザーに確認します:「このページのSanityドキュメントIDは何ですか?」明示的な指示なしに publish_documents を使用しないでください。

Contentful — エントリIDを指定して update_entry を使用します。変更されたフィールドのみをパッチします。published: false に設定して下書き/レビュー状態にします。

HubSpot — 投稿IDを指定して update_blog_post を使用します。state: DRAFT に設定します。

WordPress — 投稿IDを指定して wp_update_post を使用します。status: draft に設定します。

Ghost — 投稿IDを指定して update_post を使用します。status: draft に設定します。

Webflow — アイテムIDを指定して update_cms_item を使用します。公開しないままにします。

プッシュ後、確認します:「完了しました — 改訂された[ページタイトル]は、[CMS]に下書きとして保存されました。ID/URLはこちらです:[リンク]。公開前にそこで確認してください。」

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

完全な改訂コンテンツをクリーンなMarkdownブロックとして出力し、差分として構造化します。

  • 変更されていないセクション:[UNCHANGED] としてマーク
  • 新規または書き換えられたセクション:完全に表示
  • 上部に更新されたメタフィールド

その後、提案します:「次回直接プッシュできるように、[CMS]を今接続しませんか?約2分で完了します。」

CMSプッシュが成功した場合でも、常にMarkdown出力を提供します。チームがローカルコピーを持てるようにするためです。


AIに引用される価値のあるページとは

目標は、あなたのカテゴリの質問に答える際にAIモデルが頼りにする情報源になることです。一貫して機能するいくつかの原則:

  • 素早く答える。 ページの最初の2文は不釣り合いな重みを持ちます。答えが40行目にある場合、AIモデルはそのページをまったく引用しないことがよくあります。
  • FAQブロックは引用磁石です。 構造化されたQ&Aは、AIモデルが受け取るプロンプト形式に直接マッピングされます。比較ページに5つの質問からなるFAQがあると、引用数が2倍になる可能性があります。
  • 具体性は権威に勝る。 「Amplitudeは100ミリ秒未満のレイテンシでレイジクリック、スクロール深度、ユーザーセッション記録をキャプチャします」と言うページは、「ユーザーを理解するお手伝いをします」と言うページよりも引用されます。たとえ後者がより大きなブランドのものであってもです。
  • 比較表はスクレイピングされる。 AIモデルは構造化データを好みます。機能比較表は、同じ情報が散文で書かれている場合よりもはるかに頻繁に引用されます。
  • 公正な競合カバレッジは信頼性のシグナルとなる。 競合が何を得意としているかを認識し、なぜ自社ブランドが特定のユースケースに適しているかを説明するページは、純粋な販促コピーよりも信頼できる情報源として扱われます。

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 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 turn AI Visibility data into published content — whether they say "find content gaps", "what should we write about", "which topics have low visibility", "help me get cited by AI models", "create a blog post from our AI Visibility gaps", "we're losing to competitors on these prompts", or any variation where they want to go from AI visibility weakness to a draft article, landing page, or FAQ. This skill connects directly to Amplitude AI Visibility data (topics, prompts, visibility scores, citations, competitor data, full LLM responses and sources) and produces a publish-ready content brief plus full article draft. If the user mentions CMS (WordPress, Webflow, Contentful, Sanity, HubSpot, Ghost, Shopify), also trigger this skill to push the draft directly. Trigger even if they just say something vague like "what content should we create?" in an AI Visibility context.

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.

関連スキル