Communitygithub.com

amplitude/builder-skills

요구사항이나 목표를 바탕으로 종합적인 Amplitude 대시보드를 구축하여, 차트를 논리적인 섹션별로 정리하고 적절한 레이아웃으로 구성합니다. 완전한 대시보드를 새로 만들거나 기존 차트를 통합하여 일관된 뷰를 만들 때 사용하세요.

builder-skills란 무엇인가요?

이 스킬은 Amplitude 내에서 대시보드를 처음부터 생성하거나 기존 차트를 논리적인 레이아웃으로 구성하는 과정을 안내하는 전문 도구입니다. 팀, 이니셔티브, 경영진 보고, 정기 검토 등 다양한 목적의 대시보드 제작을 지원하며, 목표와 청중에 맞춰 대시보드를 설계하는 데 초점을 맞춥니다. 주요 기능으로는 기존 차트 검색 및 재구성, 새로운 차트 생성(그린필드 빌드), 섹션별 레이아웃 계획(요약, 트렌드, 분석, 세부), 그리고 맥락 정보를 추가하는 리치 텍스트 블록 삽입 등이 있습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트가 Amplitude API를 통해 직접 데이터를 쿼리하고 차트를 저장하며 대시보드를 생성할 수 있도록 설계되었습니다. 사용자는 먼저 목표와 청중을 명확히 하고, 필요한 이벤트와 속성을 검색한 후, 차트를 배치하여 대시보드를 완성할 수 있습니다. 또한 일반적인 오류(쿼리 오류, 데이터 없음 등)에 대한 해결 방법을 제공하여 안정적인 빌드를 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/analytics-skills/skills/create-dashboard

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

대시보드 생성

새로운 팀 또는 이니셔티브 대시보드를 만들고, 흩어진 차트를 정리하며, 경영진 보고를 구축하거나 정기 검토 대시보드를 설정하세요.

지침

0단계: 탐색 (기능이 익숙하지 않은 경우)

빌드하기 전에 추적 중인 내용을 이해하세요:

  • 주제와 관련된 기존 대시보드/차트 검색
  • 관련 이벤트 검색: Amplitude:search (entityTypes: ["EVENT", "CUSTOM_EVENT"])
  • get_event_properties를 사용하여 세분화에 사용 가능한 속성 파악
  • 사용자에게 주요 목표, 핵심 세그먼트, 시간 범위에 대해 질문

1단계: 대시보드 목적 정의

명확히 하세요:

  • 대상 청중은 누구인가?
  • 어떤 의사 결정을 지원할 것인가?
  • 얼마나 자주 검토될 것인가?
  • 내러티브 구조는 무엇인가?

2단계: 차트 수집 또는 생성

기존 차트가 발견된 경우 (5개 이상 관련):

  • Amplitude:search를 사용하여 관련 기존 차트 검색
  • Amplitude:get_charts를 사용하여 해당 차트 정의 검색
  • 새로운 차트가 필요한 격차 식별

차트가 거의 없거나 없는 경우 (5개 미만 관련):

  • "그린필드 빌드" 모드로 전환
  • Amplitude:query_dataset을 사용하여 필요한 차트 생성
  • 대시보드를 구축하기 전에 Amplitude:save_chart_edits로 모든 차트 저장
  • 먼저 entityTypes: ["EVENT", "CUSTOM_EVENT"]로 관련 이벤트 검색 고려

새 차트 생성:

  • query_dataset으로 프로토타입을 만들어 데이터 검증
  • save_chart_edits를 사용하여 배치로 저장 (더 효율적)
  • 대시보드를 생성하기 전에 모든 차트 ID 수집

3단계: 레이아웃 계획

논리적 섹션으로 구성:

  1. 요약 행: 주요 지표를 한눈에 (헤드라인 뷰)
  2. 트렌드 섹션: 변화 추이
  3. 분석 섹션: 세그먼트 및 차원
  4. 세부 섹션: 지원 분석

4단계: 대시보드 생성

Amplitude:create_dashboard 사용:

  • 명확하고 설명적인 이름
  • 적절한 높이의 행 (375, 500, 625 또는 750px)
  • 적절한 크기의 차트 (3-12 열)
  • 섹션용 리치 텍스트 헤더
  • chartMetas의 차트 표시 설정:
    • metric_only: 헤드라인 KPI (단일 숫자)
    • series: 트렌드 라인 (기본 뷰)
    • converted: 퍼널 (전환 뷰)
    • table: 데이터 테이블

5단계: 컨텍스트 추가

다음 내용이 포함된 리치 텍스트 블록 포함:

  • 대시보드 목적 및 대상 청중
  • 주요 지표 해석 방법
  • 관련 리소스 링크
  • 마지막 업데이트 또는 검토 일정

레이아웃 가이드라인

콘텐츠 유형권장 폭권장 높이
헤드라인 지표3-4 열375px
트렌드 차트6-12 열500px
비교 차트6 열500px
상세 테이블12 열625px
섹션 헤더12 열375px

모범 사례

  • 가장 중요한 지표를 접힌 부분 위에 배치
  • 행 내에서 일관된 차트 크기 사용
  • 관련 지표들을 함께 그룹화
  • 복잡한 지표에는 설명 텍스트 추가
  • 여러 유효한 접근 방식이 있는 경우 사용자에게 초점 영역 질문
  • 툴 호출을 최소화하기 위해 차트를 배치로 생성

일반적인 문제

쿼리 오류 (500/400):

  • 단순화: 복잡한 groupBy 제거, 날짜 범위 축소, 중첩 속성 사용 피하기
  • 먼저 검색을 사용하여 이벤트/속성 존재 여부 확인
  • 상위 N 목록의 경우 dataTableV2 대신 groupBy가 있는 eventsSegmentation 사용

데이터 없음:

  • 이벤트 이름이 정확히 일치하는지 확인 (대소문자 구분)
  • 날짜 범위가 이벤트 추적 기간을 포함하는지 확인
  • 사용자 세그먼트가 너무 제한적이지 않은지 확인

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

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.

관련 스킬