Communitygithub.com

amplitude/builder-skills

Amplitudeダッシュボードを深く分析し、主要なチャートを解析して注目すべき領域や重要な知見を抽出し、異常値を特定し、ユーザーフィードバックのトレンドを用いて変化を説明します。

builder-skills とは?

このスキルは、Amplitudeのダッシュボードを自動的に分析し、ミーティング前の準備やパターン検出、異常値の調査、定量データと定性データの関連付け、ダッシュボードのオンボーディングを支援します。Claude CodeやCursorなどのAIエージェント上で動作し、Amplitude API(`get_dashboard`、`query_charts`、`get_feedback_insights`、`get_feedback_mentions`)を活用してデータを取得・分析します。分析結果は、「全体の健全性」「懸念事項」「重要な知見」「推奨事項」の構造化された形式で提供され、各チャートの種類(KPI、時系列、ファネル、積み上げ面など)に応じた適切な評価基準に従います。また、必要に応じてユーザーフィードバックを組み込み、定性的なインサイトで数値の変化を説明します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/analytics-skills/skills/analyze-dashboard

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

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

ドキュメント

ダッシュボードの分析

使用タイミング

  • ミーティングの準備:レビューや役員会議の前にダッシュボードを要点にまとめる
  • チャート間のパターン検出:手動では見つけにくい複数チャート間の相関を発見する
  • ダッシュボード調査:ダッシュボード内のチャートで主要な数値が変動し、その理由を説明したい場合
  • 定量と定性の結合:ユーザーフィードバックが観測されたトレンドを説明するかどうかを理解する
  • 未知のダッシュボードへのオンボーディング:ダッシュボードが追跡する内容と現在の状態を素早く把握する

手順

ステップ0:ダッシュボードIDの特定

ユーザーがURLを指定した場合は、Amplitude:getting_data_from_urlを使用してダッシュボードIDを取得します

ステップ1:ダッシュボードの取得

Amplitude:get_dashboardにダッシュボードIDを指定し、全体の構造とチャートIDを取得します。

ステップ2:全チャートのクエリ

Amplitude:query_chartsを使用して、最大3つのチャートのデータを一度に取得します。以下の優先順位に従ってください:

  1. 主要KPIチャート(通常は上部に配置)
  2. 最近変化があったチャート
  3. トレンドベースの可視化

ステップ3:パターンの分析

各タイプのチャートを分析する際は、最も意思決定に関連するシグナルに焦点を当てます:

  • KPIタイル:コンテキスト(時間枠、ユーザータイプ)とパーセント変化(表示されている場合)
  • 折れ線グラフ/時系列:トレンド、傾きの変化、注目すべきイベント(右端のノイズは無視)
  • ファネル:主要な離脱ステップや予期しないリテンション。明示的に関連する場合を除き、離脱フレームではなく転換フレーム(実線)を使用。
  • 棒グラフ/カテゴリカル:集中度、ギャップ、または驚くべき分布
  • 積み上げ面グラフ:総量の変化と時間経過に伴う構成の変化
  • インターバル別リテンション:主要なインターバル(1日目、7日目、30日目)でセグメントを比較
  • 経時リテンション:最近のコホートはリテンション期間を完了していないため不完全な期間(点線)が表示される場合がある。これはリテンションが低下していることを意味しません。
  • テーブル:主要な貢献者、支配的なプレイヤー、分布の不均衡

ステップ4:ユーザーフィードバックによる文脈付け(オプション)

重大な変化や異常が検出された場合、ユーザーフィードバックがそれらを説明できるか確認します。

  1. Amplitude:get_feedback_insightsを以下のパラメータで使用:

    • ダッシュボードと同じprojectId
    • 分析期間に合わせたdateStartとdateEnd
    • 関連するタイプでフィルタ:request、complaint、lovedFeature、bug、painPoint
  2. 指標の変化と相関するフィードバックテーマを探す:

    • エンゲージメント低下と一致する機能に対する不満
    • コンバージョン低下と同時期のバグ報告
    • 利用増加と一致する高評価の機能
  3. 関連するインサイトが見つかった場合、Amplitude:get_feedback_mentionsをinsightIdと共に使用して、パターンを説明する具体的なユーザーの声を取得します。

このステップをスキップする条件:

  • プロジェクトにフィードバックソースが設定されていない
  • 期間または観測された変化に一致するインサイトがない
  • ダッシュボードの変更が軽微または予想範囲内である

ステップ5:調査結果の統合

構造化されたサマリーを提示します:

  1. 全体的な健全性:ダッシュボード分析から得られた最重要な知見(または知見のセット)を、簡潔で実用的かつ容易に理解できる一言で表現。
  2. 懸念事項 🚩:調査が必要な緊急の課題、または悪化傾向にある指標のトップ1~3。緊急の課題がない場合は、簡潔にその旨を伝え、読者が情報過多にならないようにします。
  3. 重要な知見 💡:懸念事項に含まれない、分析から得られた最も重要または驚くべき知見のトップ1~3。
  4. 推奨事項:最大3つまでの具体的なアクション可能な推奨事項を簡潔にまとめたセクション。各タイトルの前に[p0]、[p1]、[p2]、[p3]を付けて優先度を示します(p0が最も緊急、p3が最も低優先度)。

ベストプラクティス

  • 調査と分析は網羅的に行うが、レスポンスは簡潔で実用的かつ指標に基づいたものにする。
  • 同じ知見を複数のセクションで繰り返さない。
  • 参照するチャートには常にマークダウンでリンクを付ける(例:[DAU](https://app.amplitude.com/...))。ターミナルモードでは、レスポンスをクリーンに保つため、特に要求がない限り出典は表示しません。ただし、明示的に求められた場合は、すべての参照とリンクを「出典」セクションとして下部に同じマークダウン形式(例:[DAUと指標が参照されている主な知見](https://app.amplitude.com/...))でまとめて表示します。
  • メインセクションでは完全なAmplitudeリンクをそのまま引用しない。代わりにチャート、指標、エンティティ名を簡潔に参照し、読みやすくします。
  • 週間変化率が10%を超える指標にフラグを立てる
  • データ品質に問題があるチャートを指摘する
  • 可能な限り、特定のチャートに調査結果を紐付ける
  • 推奨事項セクションでは、各推奨事項は長いテーマの概要ではなく、1つの簡潔で実行可能な箇条書きにする
  • 最後に自分の実施内容を振り返らず、簡潔な優先順位付きの推奨事項で終了する
  • 不完全な期間や信頼性の低いデータからトレンドを推測しない

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

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 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.

関連スキル