Communitygithub.com

amplitude/builder-skills

PRD 또는 기능 설명서를 개발자가 바로 구현할 수 있는 사용자 스토리로 분할합니다. 엔지니어링팀에 전달하거나 스프린트 계획을 수립할 때 사용하세요.

builder-skills란 무엇인가요?

이 스킬은 제품 요구사항 문서(PRD)나 기능 설명을 입력받아 엔지니어가 바로 작업할 수 있는 사용자 스토리로 변환합니다. 각 스토리는 명확한 제목, '사용자 역할-행동-목적' 형식의 스토리 본문, 구체적인 수용 기준, 우선순위(P0/P1/P2), 그리고 메모를 포함하여 체계적으로 구성됩니다. 특히 수용 기준은 테스트 가능한 행동으로 작성되며, 정상 경로뿐만 아니라 에러 상태나 경계 조건과 같은 예외 상황도 포함하도록 설계되어 있습니다. 개발자는 스토리만 보고도 무엇을 구현해야 하는지 명확히 알 수 있고, QA는 각 기준을 그대로 테스트 케이스로 활용할 수 있습니다. 또한 각 스토리가 한 스프린트 내에 완료 가능하도록 크기를 조절하고, 스토리 간 의존성을 최소화하여 병렬 개발을 용이하게 합니다. 'craft-spec' 스킬과 연계하여 사용하면 PRD에서 사용자 스토리로 이어지는 깔끔한 파이프라인을 구축할 수 있습니다.

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

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

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

문서

사용자 스토리 생성

사양서를 엔지니어가 바로 작업할 수 있는 스토리로 변환하세요.

PRD 또는 기능 설명을 가지고 스프린트 내에 구현할 수 있을 만큼 작고, 엔지니어가 추측할 필요 없이 명확하며, QA가 완료 시점을 알 수 있을 만큼 테스트 가능한 사용자 스토리로 분할해야 합니다.


프롬프트 템플릿

당신은 기능을 엔지니어링을 위한 사용자 스토리로 분해하는 경험 많은 제품 관리자입니다.

분해할 기능 또는 사양은 다음과 같습니다:

<context>
$ARGUMENTS
</context>

> 위 내용이 비어 있으면 사용자에게 다음과 같이 질문하세요: "{{PRD, 기능 설명, 디자인 링크 또는 대략적인 요구사항을 여기에 붙여넣으세요}}"

이 기능을 다음 구조를 사용하여 사용자 스토리로 분할하세요:

**제목:** 스토리를 짧고 설명적으로 나타내는 이름

**스토리:** [특정 사용자 역할]로서, 나는 [행동]을 하고 싶다. 그래서 [혜택/결과]를 얻을 수 있다.

**수용 기준:**
- [ ] [전제 조건]이 주어졌을 때, [행동]을 하면, [예상 결과]가 나타난다.
- [ ] 엣지 케이스, 오류 상태, 경계 조건을 포함하세요.
- [ ] 스토리당 4-6개의 기준 — 명확할 만큼 충분하지만 미니 사양이 될 정도로 많지 않아야 합니다.

**우선순위:** P0 (출시에 반드시 필요), P1 (있어야 함), P2 (있으면 좋음 / 미래)

**메모:** 의존성, 디자인 참조, 기술적 고려 사항 또는 미해결 질문.

다음 원칙을 적용하세요:
- 각 스토리는 단일 스프린트 내에 완료할 수 있어야 합니다. 너무 크면 분할하세요.
- 스토리는 독립적이어야 합니다 — 스토리 B가 스토리 A의 출시를 기다려야만 시작할 수 있는 체인을 피하세요.
- 수용 기준은 테스트 가능한 행동으로 작성하고 모호한 설명을 피하세요. "사용자에게 좋은 경험이 제공된다"가 아니라 "사용자에게 성공 메시지가 표시된다"라고 작성하세요.
- 불행한 경로를 포함하세요. API가 실패하면 어떻게 되나요? 사용자에게 데이터가 없으면 어떻게 되나요? 비율 제한에 도달하면 어떻게 되나요?
- 기술 구성 요소별이 아닌 사용자 워크플로별로 스토리를 그룹화하세요.
- 디자인 입력, API 변경 또는 교차 팀 의존성이 필요한 스토리는 표시하세요.

팁

  • craft-spec의 출력을 이 스킬에 입력하면 PRD에서 사용자 스토리로 이어지는 깔끔한 파이프라인이 완성됩니다.
  • 스토리가 계속 너무 크게 나온다면, 사양에 먼저 단계로 분할해야 할 범위가 포함되어 있을 가능성이 높습니다.
  • 가장 좋은 수용 기준은 테스트 스크립트처럼 읽혀야 합니다. QA 엔지니어가 질문 없이 각 기준을 검증할 수 있어야 합니다.
  • "제로 상태" 스토리를 잊지 마세요. 사용자가 데이터를 갖기 전에 무엇을 보게 되나요? 이것은 거의 항상 누락됩니다.

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.

관련 스킬