Communitygithub.com

amplitude/builder-skills

AI 가시성 데이터를 기반으로 콘텐츠 격차를 찾고, 출판 가능한 초안을 생성하며, 선택한 CMS에 초안을 자동으로 푸시하는 스킬입니다.

builder-skills란 무엇인가요?

이 스킬은 Amplitude AI Visibility 데이터를 활용하여 마케팅 및 콘텐츠 팀이 AI 모델이 답변하는 영역에서 브랜드의 가시성 격차를 식별하고, 이를 출판 준비가 완료된 기사 초안으로 전환합니다. 사용자가 '콘텐츠 격차 찾기', '무엇에 대해 써야 할까요?' 또는 '경쟁자에게 지고 있는 프롬프트'와 같은 요청을 할 때 자동으로 트리거됩니다. 주요 기능으로는 최신 보고서에서 주제 데이터를 가져와 가시성 점수, 평균 순위, 인용 횟수를 분석하고, 기회가 되는 주제(관련성 >60%, 가시성 <40%)를 식별한 후, 프롬프트 단계까지 드릴다운하여 정확한 콘텐츠 방향을 설정합니다. 생성된 초안은 슬러그, 메타 태그, FAQ 블록, 내부 링크 등 SEO 및 AI 모델 인용에 최적화된 구조를 가지며, 최종적으로 WordPress, Webflow, Contentful, Sanity, HubSpot, Ghost, Shopify 등 주요 CMS에 자동으로 초안을 푸시하거나 마크다운 파일로 제공합니다. 이 스킬은 Claude Code, Cursor, Codex 등 모든 AI 에이전트 환경에서 사용 가능하며, CMS 연결 여부를 먼저 확인하는 단계부터 시작하여 사용자 설정을 최대한 간소화합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/prompt-gap-to-publish

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

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

문서

프롬프트 격차에서 출판까지

마케팅 또는 콘텐츠 팀이 AI 가시성 격차를 실제 출판 콘텐츠로 전환할 수 있도록 지원합니다. 핵심 통찰: AI 모델이 귀사의 제품 카테고리에 대한 질문에 답할 때, 브랜드의 존재감은 가시성 %, 평균 순위, 인용 횟수로 측정 가능합니다. 약한 부분이 바로 작성해야 할 부분입니다. 이 스킬은 이러한 격차를 찾아 출판 준비가 완료된 기사 초안을 생성하고, 사용자의 CMS에 초안으로 직접 푸시합니다.


0단계 — CMS 발견 (모든 세션 시작 시 한 번 실행)

데이터를 가져오기 전에 콘텐츠가 어디에 게시될지 파악합니다. 이렇게 하면 사용자가 마지막 단계에서 복사-붙여넣기라는 막다른 골목에 빠지는 것을 방지할 수 있습니다.

이미 연결된 CMS 도구 확인

현재 컨텍스트에서 사용 가능한 도구를 살펴보세요. 확인해야 할 알려진 CMS MCP 패턴:

CMS확인할 MCP 도구 이름 패턴
Sanitysanity, create_documents_from_markdown, publish_documents
Contentfulcontentful, create_entry, publish_entry
HubSpot CMShubspot, create_blog_post, update_blog_post
WordPresswordpress, wp_create_post
Ghostghost, create_post
Webflowwebflow, create_cms_item

CMS MCP가 이미 연결된 경우: 좋습니다. 한 문장으로 사용자에게 확인하세요: "[CMS]가 연결된 것을 확인했습니다. 작업이 완료되면 기사를 초안으로 푸시하겠습니다. 괜찮으신가요?" 그런 다음 1단계로 진행합니다.

CMS MCP가 감지되지 않은 경우: 사용자에게 직접 물어보세요. 간결하고 친근하게 유지하세요 — 이는 일회성 설정입니다:

"본격적으로 들어가기 전에 — 어떤 CMS에 게시하시나요? 알려주시면, 기사를 마크다운 블록으로 전달하는 대신 초안으로 자동 푸시해 드릴 수 있습니다."

다음 옵션을 제시하거나 (사용자가 직접 입력할 수도 있음):

  • Sanity
  • Contentful
  • HubSpot CMS
  • WordPress
  • Webflow
  • Ghost / Shopify / 기타
  • "지금은 마크다운만 주세요"

답변에 따른 통합 권장

CMS를 알게 되면 구체적인 설정 권장 사항을 간략히 제공한 후, 사용자가 설정하는 동안 계속 진행할 것을 제안합니다:

Sanity:

"Sanity MCP 커넥터는 Cowork 마켓플레이스에서 사용 가능합니다. 설정 → 플러그인 → 'Sanity' 검색 후 프로젝트 ID와 토큰으로 연결하세요. 약 2분 정도 소요됩니다. 그동안 콘텐츠 격차를 찾는 작업을 계속할까요? 연결이 완료되면 초안을 푸시할 준비가 되어 있을 겁니다."

Contentful:

"Contentful MCP 커넥터가 있습니다. 설정 → 플러그인 → 'Contentful' 검색 후 Space ID와 Content Management API 토큰을 추가하세요. 지금 격차를 찾는 작업을 계속하시겠습니까?"

HubSpot CMS:

"HubSpot은 이미 Glean을 통해 연결되어 있을 수 있습니다. 그렇지 않다면 설정 → 플러그인에서 'HubSpot'을 검색하세요. 완료되면 블로그 게시물 초안을 생성하겠습니다."

WordPress:

"WordPress는 MCP를 통해 연결할 수 있습니다 (설정 → 플러그인에서 'WordPress' 검색, 사이트 URL과 WordPress 관리자에서 생성한 애플리케이션 비밀번호가 필요합니다). 또는 Chrome을 사용하여 WordPress 관리자에서 직접 게시물을 초안 작성할 수도 있습니다 — URL을 공유해 주세요. 어떤 방법이 더 편리하신가요?"

Webflow:

"Webflow CMS API가 가장 깔끔한 경로입니다 — 설정 → 플러그인에서 'Webflow' 검색 후 API 키와 컬렉션 ID로 연결하세요. 플러그인 설정이 번거롭다면 Chrome을 통해 자동화할 수도 있습니다."

Ghost:

"Ghost는 잘 문서화된 Admin API를 제공합니다. 설정 → 플러그인에서 'Ghost' 검색 후 Admin API 키와 사이트 URL을 추가하세요. 빠르게 설정할 수 있습니다."

"지금은 마크다운만":

"문제 없습니다. 마지막에 깔끔한 마크다운 파일을 제공하여 어떤 CMS에도 바로 붙여넣을 수 있도록 하겠습니다. 나중에 CMS를 연결하면 직접 푸시할 수도 있습니다."

권장 사항을 제공한 후, 사용자가 설정을 완료할 때까지 기다리지 말고 다음과 같이 말하세요: "지금 콘텐츠 격차를 가져오기 시작하겠습니다. 제가 기사를 준비할 때쯤이면 설정이 완료되어 있을 겁니다." 그런 다음 1단계로 진행합니다.

사용자가 언급한 CMS와 연결 여부를 저장하세요 — 6단계에서 사용합니다.


1단계 — 브랜드 식별

list_ai_visibility_org_brands를 사용하여 사용 가능한 브랜드를 가져온 후:

  • 사용자가 특정 브랜드 이름을 언급한 경우 해당 브랜드를 매칭합니다.
  • 목록에 브랜드가 하나만 있는 경우 묻지 않고 사용합니다.
  • 그렇지 않으면 목록을 제시하고 사용자에게 선택하도록 요청합니다.

orgBrandId를 기록해 두세요 — 전체 과정에서 필요합니다.


2단계 — 최신 보고서의 주제 데이터 가져오기

선택한 orgBrandId로 get_ai_visibility_topics를 사용합니다 (reportId를 생략하면 최신 보고서를 가져옴). 각 주제에 대해 다음을 캡처합니다: topicId, topicName, visibilityPercentage, averageRank, relevancyScore, 인용 횟수.

기회 휴리스틱: relevancy > 60%이고 visibility < 40%인 주제는 금광입니다 — AI 모델이 이를 브랜드 카테고리의 핵심으로 간주하지만 브랜드를 거의 언급하지 않습니다. 또한 경쟁자가 20포인트 이상 앞서는 주제도 플래그를 지정합니다.


3단계 — 프롬프트로 드릴다운

상위 3~5개의 기회 주제에 대해 topicId로 get_ai_visibility_prompts를 사용합니다. 다음을 찾으세요:

  • 브랜드 가시성이 0% 또는 매우 낮은 프롬프트
  • 경쟁자가 응답을 지배하는 프롬프트
  • 응답 수가 많은 프롬프트 (AI 답변이 많을수록 인용 기회 증가)

가능하다면 get_ai_visibility_prompt_responses를 사용하여 가장 약한 프롬프트에 대한 실제 LLM 생성 답변을 읽으세요 — AI 모델이 현재 무엇을 말하는지 정확히 보여줍니다. 더 나은 답변을 작성하기 위한 최고의 브리핑입니다.


4단계 — 기회 순위 지정 및 제시

3~5개의 콘텐츠 기회에 대한 순위가 매겨진 후보 목록을 제시합니다:

#주제대표 프롬프트Amplitude 가시성주요 경쟁자콘텐츠 유형
1..."..."X%경쟁사 Y%랜딩 페이지

콘텐츠 유형 가이드:

  • 블로그 게시물 — 정보 제공 / 비교 쿼리 ("X란 무엇인가?", "X vs Y", "X는 어떻게 작동하나요?")
  • 랜딩 페이지 — 높은 의도의 쿼리 ("최고의 X 도구", "[사용 사례]를 위한 X")
  • FAQ 페이지 — 한 주제에 대한 관련 질문 클러스터
  • 제품 설명 — 브랜드가 확실한 출처여야 하는 기능별 쿼리

질문: "이 중 무엇을 먼저 작성하시겠습니까?" 사용자의 선택을 기다립니다.


5단계 — 콘텐츠 초안 생성

선택한 기회에 대해 전체적이고 출판 준비가 된 초안을 작성합니다. 뼈대가 아닌 실제 문장, 실제 콘텐츠를 작성합니다. 사용자가 오늘 바로 CMS에 붙여넣을 수 있어야 합니다.

항상 포함

콘텐츠 브리핑 (사전):

  • 대상 프롬프트 / 질문
  • 검색 의도: 정보 탐색 / 네비게이션 / 상업적
  • 주요 대상
  • 경쟁사 격차: 경쟁사는 브랜드가 하지 않는 말을 무엇을 하나요?
  • LLM 통찰: AI 모델이 이 주제에 대해 현재 말하는 내용을 인용하거나 의역

기사 필드:

  • slug — URL 친화적, 키워드 풍부
  • metaTitle — 50~60자, 주요 키워드 포함
  • metaDescription — 140~160자, CTA와 함께 기사 요약

기사 본문:

  • H1 — 대상 프롬프트와 밀접하게 일치
  • 서론 (2~3문단) — 훅, 브랜드 권위, 기사 미리보기
  • 본문 (3~6개의 H2 섹션) — 포괄적인 답변; 구체적인 세부 사항과 함께 특정 제품 기능 인용; 데이터 또는 예시 포함; 각 섹션은 독립적으로 유용한 내용을 가르쳐야 함
  • FAQ 블록 (35개의 Q&A) — 3단계에서 밀접하게 관련된 프롬프트를 가져옴; 답변당 24문장; AI 모델이 가장 신뢰성 있게 인용하는 형식
  • 내부 링크 (3~5개 제안) — 예상 페이지 이름 또는 URL 패턴 참조
  • CTA — 명확한 다음 단계 하나

AI 모델이 인용하는 콘텐츠를 위한 팁

  • 처음 두 문장에서 정확한 질문에 답하세요. AI 모델은 직접 답변하는 소스를 인용합니다.
  • 제품 기능에 대해 구체적으로 설명하세요. "Amplitude는 X를 추적합니다"가 "우리는 회사의 성장을 돕습니다"보다 낫습니다.
  • 경쟁사를 공정하게 다루세요. 경쟁을 인정하는 기사가 없는 척하는 기사보다 순위가 높습니다.
  • AI 모델이 사용하는 정확한 문구를 사용하세요. H1과 첫 번째 문단에서 프롬프트 언어를 반영하세요.
  • FAQ 블록은 가장 강력한 인용 자석입니다 — 흐르는 산문이 아닌 직접적인 Q&A 형식으로 작성하세요.

6단계 — CMS에 게시

0단계에서 학습한 내용을 사용합니다.

CMS MCP가 연결된 경우

초안을 직접 생성합니다. 다음 순서를 따르세요:

  1. 사용자에게 슬러그, 제목, 처음 100단어를 보여주고 *"이것을 [CMS]에 초안으로 푸시할 준비가 되셨나요?"*라고 물어보세요.
  2. 확인되면 상태를 draft로 설정하여 초안을 생성합니다 (명시적인 지시 없이 published는 안 됨).
  3. 사용자가 즉시 찾을 수 있도록 초안 URL 또는 문서 ID를 보고합니다.

Sanity — 기사 콘텐츠와 함께 create_documents_from_markdown을 사용합니다. _type을 사용자의 블로그 게시물 스키마와 일치시킵니다 (잘 모르겠으면 물어보세요: "Sanity 스키마에서 블로그 게시물의 문서 유형은 무엇인가요?"). 사용자가 명시적으로 게시를 요청한 경우에만 publish_documents를 사용합니다.

Contentful — 블로그 또는 기사 유형과 일치하는 contentType으로 create_entry를 사용합니다. fields.title, fields.slug, fields.body를 설정합니다. published: false로 둡니다.

HubSpot — state: DRAFT로 블로그 게시물 생성 도구를 사용합니다. API 호출에 메타 설명과 슬러그를 포함합니다.

WordPress — status: draft로 wp_create_post를 사용합니다. H1을 title에, 기사 본문을 content에 매핑합니다.

Ghost — status: draft로 create_post를 사용합니다. slug, title, html 또는 lexical, meta_description을 포함합니다.

Webflow — 블로그 컬렉션을 대상으로 create_cms_item을 사용합니다. 필드를 컬렉션 스키마에 매핑합니다 (컨텍스트에서 스키마가 명확하지 않은 경우 사용자에게 필드 이름을 물어보세요).

CMS가 아직 연결되지 않은 경우

사용자가 "마크다운만"이라고 말했거나 아직 CMS를 연결하지 않은 경우:

"전체 기사가 마크다운 형식으로 준비되었습니다 — [CMS]에 바로 붙여넣을 수 있습니다. [CMS] 연결 준비가 되면, 향후 기사는 자동으로 푸시해 드릴 수 있습니다."

완성된 기사를 깔끔하고 잘 구조화된 마크다운 블록으로 출력합니다.

또한 말하세요: "지금 [CMS] 연결 설정을 도와드릴까요? 약 2분 정도 소요됩니다." 예라고 답하면 0단계의 플러그인 설정 과정을 안내합니다.

CMS 생성이 성공한 경우에도 항상 마크다운 폴백을 출력하여 사용자가 소유한 로컬 복사본을 가질 수 있도록 합니다.

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

관련 스킬