Communitygithub.com

amplitude/builder-skills

对特定的 Amplitude 图表进行深度分析,解释趋势、异常和可能的驱动因素。当指标看起来异常、需要调查突然上涨或下跌,或理解数字背后的“原因”时使用。

builder-skills 是什么?

该技能旨在帮助用户深入分析 Amplitude 图表中的异常或趋势,揭示其背后的驱动因素。它通过一个结构化的五步流程工作:首先识别并验证图表数据,然后使用 Amplitude 的分析工具识别模式(如尖峰、下降、趋势或异常),接着通过引导式细分(而非穷举切片)来聚焦高信号属性,寻找主要驱动因素。对于异常,它会自动关联同一时间范围内的实验、部署和客户反馈等上下文信号,以建立时间关联。最后,它会合成一份结构化的分析报告,包含“发生了什么”、“何时发生”、“主要假设”、“支持证据”、“替代解释”、“影响量化”和“下一步建议”,帮助利益相关者做出数据驱动的决策。该技能适用于 Amplitude 平台,并限定最多测试 9 个属性,并建议每次查询不超过 3 个新图表,以避免过度分析。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/analytics-skills/skills/analyze-chart

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

图表深度分析

使用时机

  • 某个指标意外上涨或下跌
  • 你需要理解是什么在驱动一个趋势
  • 为利益相关者准备一份详细、有证据支撑的分析
  • 调查不同用户或事件细分之间的差异

操作说明

第 0 步:识别图表

  • 接受一个图表 URL 或图表 ID
  • 如果用户提供的是 URL,使用 Amplitude:getting_data_from_url 提取图表 ID
  • 如果未提供任何图表标识符,则明确要求用户提供图表 URL 或 ID,并停止执行

第 1 步:检索并验证图表数据(必选)

  • 使用 Reading chart data 检索图表定义和数据
  • 如果无法获取图表数据或数据为空,不要继续
    • 解释缺失的内容(如时间范围、事件、过滤器、权限)
    • 要求用户修正图表或提供有效的图表

捕获并重述:

  • 正在衡量的指标
  • 时间范围和粒度
  • 图表类型(例如时间序列、漏斗、留存)
  • 现有的过滤器、细分或分组

第 2 步:识别模式与变化窗口

使用 Analyzing chart 来表征正在发生的情况:

  • 尖峰 / 下降:在特定日期发生突然变化
  • 趋势:随时间逐渐增加或减少
  • 季节性:每周或每月重复出现的模式
  • 异常:偏离近期基线或历史行为

明确识别:

  • 变化窗口(开始/结束)
  • 变化的方向和幅度
  • 用于比较的基线周期(默认:前一个等长时间段)

第 3 步:调查可能的驱动因素(有限范围内)

不要进行广泛的切片,而是使用引导式细分:

  1. 使用 Finding the right event properties 识别最相关的事件属性来解释变化
  2. 选择最多 9 个高信号属性(例如平台、国家、计划、版本)
  3. 在考虑这些属性的情况下重新运行 Analyzing chart,以确定:
    • 哪些细分对变化的贡献最大
    • 模式是局部的还是广泛的
    • 使用 Amplitude:query_charts 时,每次仅获取最多 3 个图表

除非用户明确要求进行更深入的探索,否则避免合计测试超过 9 个属性。


第 4 步:与上下文关联(异常情况必选)

对于尖峰、下降或意外变化,在相同时间框架内收集上下文信号:

  • 使用 Getting experiments 识别正在进行的实验或标识
  • 使用 Getting deployments 识别发布或回滚
  • 使用 Searching for content 获取注释或相关文档
  • 使用 Amplitude:get_feedback_insights 搜索可能解释变化的客户反馈趋势
  • 如果存在可能与被解释内容相关的反馈趋势,使用 Amplitude:get_feedback_mentions 提取具体的客户提及

确定是否有任何上下文变化在时间上与图表模式一致。


第 5 步:综合发现

呈现一份结构化的、支持决策的分析报告:

  1. 发生了什么
    对观察到的模式和幅度的清晰描述

  2. 何时
    准确的时间范围和比较基线

  3. 主要假设
    基于图表数据和上下文信号的最可能解释

  4. 支持证据

    • 关键指标
    • 细分贡献
    • 相关的实验、部署或注释
  5. 替代解释
    1–3 个合理的替代方案及为何可能性较低

  6. 影响
    尽可能量化影响(用户、事件、转化率、收入代理指标)

  7. 建议的下一步
    一个明确的后续行动(例如更深入的细分、实验审查、埋点检查)

始终包含:

  • 图表名称
  • 图表 ID
  • 图表的链接
  • 覆盖范围(例如测试的属性、分析的细分)

最佳实践

  • 始终与清晰的基线期进行比较
  • 区分观察结果和假设
  • 优先使用高信号细分,而非穷举切片
  • 注意数据质量问题(低量、不完整周期、大量“(无)”值)
  • 除非用户明确要求,否则不要创建或编辑图表

Individual skills in this repo

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

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

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.

相关技能