Communitygithub.com

amplitude/builder-skills

이 스킬은 기능 설계를 위한 구조화된 템플릿을 제공합니다. 문제 정의, 솔루션 설계, 수용 기준을 명확히 작성하여 개발자와 제품 팀이 효과적으로 협업하고 일관된 기능을 구축할 수 있도록 돕습니다.

builder-skills란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code)가 기능 설계 과정을 구조화된 템플릿으로 안내합니다. 개발자와 제품 팀은 '문제 상황' 섹션에서 핵심 문제를 명확히 정의하고, '솔루션 설계' 섹션에서 다양한 후보 솔루션을 탐색한 후 최적의 전략을 결정합니다. 특히 규모의 경제, 네트워크 효과, 고착 비용, 브랜드 강화 등 전략적 레버를 고려하고, 사용자 경험 원칙을 적용하여 직관적인 인터페이스를 설계하도록 유도합니다. 이 스킬은 Amplify, Builder.io 등 다양한 플랫폼에서 사용 가능하며, '수용 기준'을 기능적/에지 케이스/범위 외로 세분화하여 테스트 가능한 조건을 명시함으로써 과도한 개발을 방지하고 명확한 완료 조건을 설정하는 데 도움을 줍니다.

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

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

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

문서

업데이트: @오늘 날짜 (MM/DD/YY)

문제 상황

기능을 통해 해결하려는 핵심 문제와 그 동기를 한 문단으로 간결하게 작성하세요. 이 기능으로 해결할 핵심 문제나 구축을 통해 열리는 기회를 명확히 설명합니다. 이 기능의 마케팅 문구는 무엇인가요? 왜 지금 구축해야 하나요? 이 기능으로 성공할 자격이 있는 이유는 무엇인가요? 문제 설명은 추가 맥락 없이도 모든 핵심 내용을 전달할 수 있도록 상세하고 실행 가능해야 하며, 최대 3문장으로 제한합니다. 가장 관련성이 높은 고객 페르소나를 먼저 언급하세요(예: "비즈니스 소유자는..."). 단, 개요 문단에 정확한 개인 또는 회사 이름은 사용하지 마십시오.

솔루션 설계

솔루션 공간 탐색 – 방향을 결정하기 전에 여러 후보 솔루션을 고려하고 전략적 및 경험적 관점에서 평가하십시오.

이 솔루션에 가장 중요한 전략적 레버를 식별하고 깊이 탐구하십시오.

  • 사용자 채택 또는 운영 규모가 증가함에 따라 단위 비용을 줄이는 규모의 경제를 극대화하는 기능을 우선시합니다.
  • 참여자 수가 증가함에 따라 사용자 가치를 높이는 네트워크 효과를 증폭시키는 기능을 선택합니다.
  • 경쟁자가 자사의 전략을 크게 방해하지 않고 쉽게 복제할 수 없는 역위치 기회를 창출하는 기능을 선호합니다.
  • 사용자가 생태계를 떠나기 어렵거나 덜 매력적으로 만드는 고착 비용을 개선하는 기능에 중점을 둡니다.
  • 브랜드를 강화하여 고유한 정체성을 강화하고 사용자와 지속적인 감정적 연결을 구축하는 기능에 집중합니다.
  • 독점 데이터, 독점적 파트너십 또는 경쟁자가 쉽게 접근하거나 모방할 수 없는 고유한 역량과 같은 코너 리소스를 활용하는 기능을 활용합니다.
  • 우수한 프로세스 또는 독점 워크플로를 입증하여 경쟁사 대비 지속 가능한 운영 우위를 창출하는 기능을 구현합니다.

단순하고 즐거운 사용자 경험을 설계할 때 사용자 흐름을 디자인하는 데 다음 원칙을 적용해 보십시오.

  • 끊임없이 단순화하십시오. 직관적이고 미니멀한 경험을 제공하기 위해 불필요한 단계나 기능을 제거하십시오. 모든 요소는 그 자리를 얻기 위해 노력해야 합니다.

  • 원활한 연속성을 유지하십시오. 최소한의 인지 부하와 막다른 길 없이 처음부터 끝까지 사용자를 자연스럽게 안내하십시오.

  • 세부 사항에 집중하십시오. 타이포그래피, 전환, 간격, 카피는 모두 세심한 장인 정신을 반영해야 합니다. 모든 접점에서 균일하고 일관된 브랜드 느낌으로 기능과 아름다움의 균형을 맞추십시오.

  • 세심한 터치로 즐거움을 더하십시오. 기능 이상의 경험을 끌어올리는 작지만 기억에 남는 디테일을 추가하십시오.

  • SaaS 구성 요소를 설계하는 방법이 불분명한 경우, Linear의 디자인이나 구성 요소 작동 방식을 참고하십시오.

솔루션을 논의할 때 이러한 원칙을 명시적으로 언급하지 말고, 최상의 솔루션을 탐색, 결정 및 설명할 때 근거에 통합하십시오.

솔루션 공간을 탐색하고 최상의 전략을 식별한 후, 기능이 무엇을 하는지, 사용자의 불편을 어떻게 해결하는지, 어떻게 사용자를 즐겁게 하는지에 대한 간결한 설명을 불필요한 서문 없이 제공하십시오.

  • 사용자가 제품과 상호 작용하고 경험하는 방식에 대해 매우 구체적인 세부 사항을 설명하십시오. 인터페이스 디자인, 사용자 여정의 각 단계, 솔루션의 전반적인 사용성과 단순성을 개선하는 방법에 초점을 맞추십시오.
  • 이 기능 출시로 인해 발생할 것으로 예상되는 실제 사용 내러티브를 제시하십시오.
  • 실제 사용자를 특정 순간에 고정시키십시오. 예: "Frank가 샌프란시스코의 여러 스타트업을 방문할 때, 그는 [기능 X]를 사용하여 불만 사항을 기록하고 [기능 Y]에서 요구 사항을 추적합니다..."
  • 시장 대안과 차별화되고 경쟁사에 맞서 제품을 포지셔닝할 수 있는 고유한 전술이나 측면을 강조하십시오.

기억하십시오: 최상의 솔루션은 ICE(영향력, 확신도, 노력)를 극대화합니다. 영향력이 높을수록, 확신도가 높을수록, 노력이 낮을수록 더 나은 솔루션입니다.

솔루션 설명을 초점이 맞춰진 간결한 문단으로 나누고 줄 바꿈으로 구분하십시오 — 경험의 한 측면당 한 문단입니다.

수용 기준

각 기준은 명확한 예상 결과와 함께 구체적이고 테스트 가능한 조건을 설명해야 합니다. 기준은 구현 선택이 아닌 원하는 결과를 설명합니다. 기준은 MECE(상호 배타적이며 종합적으로 총망라)해야 하며, 작업 완료에 필요한 모든 조건을 다루어야 합니다.

기능:

  • [관찰 가능한 사용자 행동 → 예상되는 시스템 응답 또는 결과]

에지 케이스 및 오류 처리:

  • [입력이 유효하지 않거나, 서비스가 실패하거나, 데이터가 누락되거나, 사용자가 예상치 못한 상태에 도달했을 때 발생하는 상황]

범위 외:

  • [이 작업에 명시적으로 포함되지 않는 사항 — 과도한 개발을 방지하기 위해 명확한 경계 설정]

<강력한 수용 기준의 예시>

  • 사용자가 검색창에 입력하면 300ms 디바운스 후 결과가 실시간으로 업데이트되며, 순위 목록에 제품명, 이미지, 가격이 표시됩니다.
  • 사용자는 설정 > 프로필 편집으로 이동하여 이름, 성, 이메일, 전화번호를 업데이트할 수 있습니다. 변경 사항은 저장 즉시 지속되며 앱 전체에 새로 고침 없이 반영됩니다.
  • 저장 요청이 실패하면(시간 초과 또는 5xx), "문제가 발생했습니다. 다시 시도해 주세요."라는 인라인 오류를 표시합니다. 양식은 사용자의 저장되지 않은 입력을 유지합니다.
  • 빈 검색어를 제출하면 오류나 빈 상태 대신 기본 결과 목록이 반환됩니다.
  • 이는 대량 프로필 편집, CSV 내보내기 또는 관리자 수준 권한 변경을 포함하지 않습니다. </강력한 수용 기준의 예시>

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.

관련 스킬