Communitygithub.com

amplitude/builder-skills

Amplitude の機能開発における問題の特定、ソリューション設計、受け入れ基準の明確化を支援するスキルです。

builder-skills とは?

このスキルは、Amplitude のプロダクト開発プロセスを効率化するための AI エージェントスキルです。主に、フィーチャー開発の最初の段階である「問題の定義」から「ソリューション設計」「受け入れ基準の策定」までを、構造化されたテンプレートに沿って支援します。開発者やプロダクトマネージャーは、このスキルを使うことで、顧客視点に立った明確な問題提起、戦略的レンズ(規模の経済、ネットワーク効果、差別化など)を用いたソリューションの探索、そして具体的でテスト可能な受け入れ基準の定義を、一貫したフォーマットで行えます。対応プラットフォームは Claude Code や Cursor などの AI コーディングエージェントを想定しており、プロダクト仕様書や設計ドキュメントの作成を効率的に進めることができます。ソリューション設計では Linear のような洗練された SaaS 体験を参考に、シンプルで直感的なユーザーフローを重視します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/product-skills/skills/draft-spec

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

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

ドキュメント

問題の背景

この機能が解決しようとする中核的な問題、あるいは構築することで開かれる機会について、行動可能かつ簡潔な問題文を1段落で記述します。この機能のマーケティングステートメントは何ですか?なぜ今構築するのですか?なぜこの機能で勝ち抜く価値があるのですか?この問題文は、追加のコンテキストがなくても全ての重要なポイントを伝えられるよう、詳細かつ実行可能である必要があります。ただし、最大3文に制限します。最も関連性の高い顧客ペルソナ(例:「ビジネスオーナーは...」)で書き始めますが、概要段落では実際の人物名や会社名を決して使用しないでください。

ソリューション設計

ソリューションの可能性を探る前に、方向性を決定します。複数の候補ソリューションを検討し、戦略的および体験的なレンズで評価します。

このソリューションにとって最も重要な戦略的レバーを特定し、それらを深く掘り下げます。

  • 規模の経済によるコスト優位性を最大化し、ユーザー採用や運用ボリュームが増加するにつれてユーザーあたりのコストを削減する機能を優先します。
  • ネットワーク効果を増幅し、参加者が増えるにつれてユーザーへの価値が高まる機能を選択します。
  • 競合が自社の戦略を大きく混乱させることなく容易に複製できない機能や体験を導入することで、カウンターポジショニングの機会を生み出す機能を優先します。
  • 顧客のスイッチングコストを高め、ユーザーがエコシステムを離れるのを困難または魅力的でなくする機能を重視します。
  • ブランドを強化し、独自のアイデンティティを強化し、ユーザーとの永続的な感情的なつながりを構築する機能に焦点を当てます。
  • 独自データ、排他的パートナーシップ、競合が容易にアクセスまたは模倣できない独自の機能など、コーナーされたリソースを活用する機能を活用します。
  • 優れたプロセスまたは独自のワークフローを示し、競合に対する持続可能な運用上の優位性を生み出す機能を実装します。

シンプルで楽しいユーザーエクスペリエンスを設計する際には、ユーザーフローを設計する際に以下の原則のいくつかを採用してみてください。

  • 容赦なくシンプルにする — 直感的でミニマルな体験を提供するために、不要なステップや機能を削除します。すべての要素はその存在価値を証明する必要があります。

  • シームレスな連続性を維持する — 最小限の認知負荷で、行き止まりなく、ユーザーを開始から終了まで自然にガイドします。

  • 細部にこだわる — タイポグラフィ、トランジション、スペーシング、コピーはすべて、細心の注意を払って作成されている必要があります。すべてのタッチポイントで、機能性と美しさを統一された一貫性のあるブランド感覚でバランスさせます。

  • 思慮深いタッチで喜ばせる — 機能を超えて体験を高める、小さくても記憶に残る詳細を追加します。

  • SaaS コンポーネントの設計方法が不明な場合は、Linear がデザインやコンポーネントの動作方法をコピーします。

ソリューションについて説明する際にこれらの原則を明示的に言及しないでください。最適なソリューションを探索して決定し説明する際に、その根拠に組み込んでください。

ソリューションの可能性を探り、最適な戦略を特定した後、機能が何をするか、どのようにユーザーのペインポイントを解決するか、どのようにユーザーを喜ばせるかについて、不要な前置きなしに簡潔に説明します。

  • ユーザーが製品と対話し、体験する望ましい方法を非常に具体的に詳しく説明します。インターフェースデザイン、ユーザージャーニーの各ステップ、ソリューションの全体的なユーザビリティとシンプルさをどのように改善するかに焦点を当てます。
  • この機能のローンチ結果として発生すると予想される実際の使用シナリオを提示します。
  • 実際のユーザーと実際の瞬間に固定します。例:「フランクがサンフランシスコのさまざまなスタートアップを訪問しているとき、[機能 X] を使用して苦情を記録し、[機能 Y] で要件を追跡しています...」
  • 市場の代替手段とこのソリューションを区別し、競合他社に対して製品をカウンターポジショニングするために採用できる独自の戦術や側面を強調します。

最適なソリューションは ICE(影響、確信、努力)を最大化することを忘れないでください。影響が大きければ大きいほど、確信が高く、努力が少ないほど、ソリューションは優れています。

ソリューションの説明を、改行で区切られた焦点を絞った簡潔な段落に分割します。体験の1つの側面につき1段落です。

受け入れ基準

各基準は、明確な期待される結果を伴う、具体的でテスト可能な条件を記述する必要があります。基準は実装の選択ではなく、望ましい結果を記述します。基準は MECE(相互に排他的で集合的に網羅的)である必要があり、作業が完了するために必要なすべての条件をカバーします。

機能:

  • [観察可能なユーザー行動 → 期待されるシステム応答または結果]

エッジケースとエラーハンドリング:

  • [入力が無効な場合、サービスが失敗した場合、データが欠落している場合、またはユーザーが予期しない状態に達した場合に何が起こるか]

範囲外:

  • [この作業に明示的に含まれないもの — 過剰な構築を防ぐために明確な境界を設定します]

<strongな受け入れ基準の例>

  • ユーザーが検索バーに入力すると、300ms のデバウンス後に結果がライブで更新され、製品名、画像、価格がランク付けされたリストに表示されます。
  • ユーザーは [設定] > [プロフィールを編集] に移動し、名、姓、メールアドレス、電話番号を更新できます。変更は保存時にすぐに永続化され、更新しなくてもアプリ全体に反映されます。
  • 保存リクエストが失敗した場合(タイムアウトまたは5xx)、インラインエラー「問題が発生しました。もう一度お試しください。」を表示します。フォームはユーザーの未保存の入力を保持します。
  • 空の検索クエリを送信すると、エラーや空の状態ではなく、デフォルトの結果リストが返されます。
  • これには、一括プロフィール編集、CSV エクスポート、管理者レベルの権限変更は含まれません。 </strongな受け入れ基準の例>

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

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.

関連スキル