Communitygithub.com

amplitude/builder-skills

將 AI 可視性數據轉化為已發布內容(如部落格文章、登陸頁面或常見問題集),並直接推送至 CMS(WordPress、Webflow、Contentful 等)。

builder-skills 是什麼?

此技能專為行銷與內容團隊設計,能從 Amplitude 的 AI 可視性數據(包括主題、提示、可視性百分比、引用次數與競爭對手資料)中,自動識別內容缺口並產出可直接發布的稿件。它首先透過「機會啟發法」鎖定相關性高但品牌可視性低的主題,然後深入挖掘特定提示與 LLM 回應以了解競爭態勢。接著,它會生成包含內容簡報、文章內文、常見問題集、內部連結與行動呼籲的完整草稿。最後,根據步驟 0 的 CMS 偵測結果,技能會將草稿直接以「草稿」狀態推送至已連接的 CMS(如 Sanity、Contentful、HubSpot、WordPress、Webflow 或 Ghost),或是以易於貼上的 Markdown 格式輸出。此流程確保內容不僅能填補 AI 可視性缺口,還能被 AI 模型引用,從而提升品牌在 LLM 回應中的曝光度。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Prompt Gap 到發布

您正在協助行銷或內容團隊將 AI 可視性缺口轉化為實際發表的內容。 核心洞察:當 AI 模型回答您產品類別中的問題時,品牌的出現是可衡量的 — 可視性百分比、平均排名、引用次數。表現弱的地方就是您應該撰寫的地方。此技能會找出這些缺口,產出一篇可直接發布的文章草稿,並將其直接推送至使用者的 CMS 作為草稿。


步驟 0 — CMS 探索(每次會話開始時執行一次)

在拉取任何數據之前,請先確定內容的最終落腳處。這能避免使用者在最後階段陷入複製貼上的死胡同。

檢查已連接的 CMS 工具

查看您當前 context 中可用的工具。請檢查以下已知的 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?一旦我知道,我就可以自動將文章以草稿形式推送過去,而不是給您一段需要貼上的 Markdown。」

提供以下選項(或讓他們自行輸入):

  • Sanity
  • Contentful
  • HubSpot CMS
  • WordPress
  • Webflow
  • Ghost / Shopify / 其他
  • 「先給我 Markdown 就好」

根據他們的回答推薦整合方式

一旦知道他們的 CMS,給他們一個簡短、具體的設定建議 — 然後提議在他們設定期間繼續進行:

Sanity:

「Sanity MCP 連接器可在 Cowork 市集中找到。前往設定 → 外掛程式 → 搜尋 'Sanity' 並使用您的專案 ID 和 token 進行連接。大約需要 2 分鐘。您想在設定的同時,我繼續幫您尋找內容缺口嗎?當您連接好後,我就可以準備推送草稿。」

Contentful:

「有一個 Contentful MCP 連接器可用。前往設定 → 外掛程式 → 搜尋 'Contentful' 並新增您的 Space ID 和 Content Management API token。現在繼續尋找內容缺口嗎?」

HubSpot CMS:

「HubSpot 可能已經透過 Glean 連接。如果沒有,請在設定 → 外掛程式中搜尋 'HubSpot'。完成後我會在該處建立一個部落格文章草稿。」

WordPress:

「WordPress 可以透過 MCP 連接(在設定 → 外掛程式中搜尋 'WordPress',您需要提供網站網址和從 WordPress 管理後台取得的應用程式密碼)。或者,我可以使用 Chrome 直接在您的 WordPress 管理後台中撰寫草稿 — 只需分享網址即可。哪種方式更適合您?」

Webflow:

「Webflow 的 CMS API 是最簡潔的路徑 — 在設定 → 外掛程式中搜尋 'Webflow' 並使用您的 API 金鑰和 Collection ID 進行連接。如果您偏好不設定外掛程式,我也可以透過 Chrome 來自動化。」

Ghost:

「Ghost 有一個文檔完善的 Admin API。在設定 → 外掛程式中搜尋 'Ghost' 並新增您的 Admin API 金鑰和網站網址。設定起來很快。」

「只要 Markdown」:

「沒問題 — 最後我會給您一份乾淨的 Markdown 檔案,格式已完善,可以直接貼入任何 CMS。您之後隨時可以連接 CMS,我們再直接推送。」

在給出建議後,不要等待他們完成設定 — 說類似這樣的話: 「我現在就開始拉取您的內容缺口。等我準備好文章時,您應該也準備好了。」 然後繼續進行步驟 1。

儲存他們提到的 CMS 以及是否已連接 — 您將在步驟 6 中使用此資訊。


步驟 1 — 識別品牌

使用 list_ai_visibility_org_brands 來獲取可用的品牌,然後:

  • 如果使用者提到了特定的品牌名稱,請進行匹配。
  • 如果清單中只有一個品牌,則直接使用,無需詢問。
  • 否則,列出清單並請使用者選擇。

記下 orgBrandId — 您之後會一直需要它。


步驟 2 — 拉取最新報告的主題數據

使用 get_ai_visibility_topics 並傳入選定的 orgBrandId(省略 reportId 以獲取最新報告)。 對於每個主題,擷取:topicId、topicName、visibilityPercentage、averageRank、relevancyScore 和引用計數。

機會啟發法: 相關性 > 60% 且可視性 < 40% 的主題是您的金礦 — AI 模型認為它們對品牌類別至關重要,但幾乎未提及該品牌。同時也標記競爭對手領先 20 個百分點以上的主題。


步驟 3 — 深入探討 Prompt

對於前 3–5 個機會主題,使用 get_ai_visibility_prompts 並傳入 topicId。尋找:

  • 品牌可視性為 0% 或非常低的 Prompt
  • 競爭對手主導回應的 Prompt
  • 回應次數高的 Prompt(更多 AI 回答 = 更多引用機會)

如果可用,使用 get_ai_visibility_prompt_responses 來讀取最弱 Prompt 的實際 LLM 生成答案 — 這能準確顯示 AI 模型目前說了些什麼。這是撰寫更好答案的最佳簡報。


步驟 4 — 排序並呈現機會

呈現一個排序後的 3–5 個內容機會 的簡短清單:

#主題代表性 PromptAmplitude 可視性頂尖競爭對手內容類型
1...「...」X%競爭對手 Y%登陸頁面

內容類型指南:

  • 部落格文章 — 資訊型 / 比較型查詢(「什麼是 X?」、「X vs Y」、「X 如何運作?」)
  • 登陸頁面 — 高意圖查詢(「最佳 X 工具」、「適用於 [使用案例] 的 X」)
  • 常見問題集頁面 — 關於一個主題的相關問題集群
  • 產品描述 — 功能特定的查詢,品牌應是此類查詢的權威來源

詢問:「您想先撰寫哪一個?」 等待他們的選擇。


步驟 5 — 生成內容草稿

為所選的機會撰寫一篇完整、可直接發布的草稿。不是骨架 — 是真實的句子、真實的內容。使用者應該能夠在今天就將其貼入 CMS。

務必包含

內容簡報(開頭):

  • 目標 Prompt / 問題
  • 搜尋意圖:資訊型 / 導航型 / 商業型
  • 主要受眾
  • 競爭對手缺口:競爭對手說了什麼而品牌沒有?
  • LLM 洞察:引用或改寫 AI 模型目前對此主題的說法

文章欄位:

  • slug — 對 URL 友好、富含關鍵字
  • metaTitle — 50–60 個字元,包含主要關鍵字
  • metaDescription — 140–160 個字元,摘要文章並包含行動呼籲

文章本文:

  • H1 — 與目標 Prompt 緊密匹配
  • 引言(2–3 段) — 鉤子、品牌權威、文章預覽
  • 主體(3–6 個 H2 部分) — 全面回答;引用具體的產品功能並提供具體細節;包含數據或範例;每個部分應教授獨立有用的知識
  • 常見問題集區塊(3–5 個 Q&A) — 從步驟 3 中提取密切相關的 Prompt;每個答案 2–4 句話;這些是 AI 模型最可靠引用的格式
  • 內部連結(3–5 個建議) — 參考可能的頁面名稱或 URL 模式
  • 行動呼籲 — 一個明確的下一步

讓內容被 AI 模型引用的技巧

  • 在前兩句話中直接回答問題。AI 模型會引用直接回答問題的來源。
  • 具體說明產品功能。「Amplitude 追蹤 X」勝過「我們幫助公司成長」。
  • 公平地涵蓋競爭對手。承認競爭的文章排名優於假裝競爭不存在的文章。
  • 使用 AI 模型使用的確切詞語。在您的 H1 和第一段中模仿 Prompt 的語言。
  • 常見問題集區塊是您最強大的引用磁鐵 — 將其格式化為直接的 Q&A,而不是流暢的散文。

步驟 6 — 發布到 CMS

使用您在步驟 0 中學到的資訊。

如果 CMS MCP 已連接

直接建立草稿。請遵循此順序:

  1. 向使用者顯示 slug、標題和前 100 個字 — 詢問:「準備好將其以草稿形式推送到 [CMS] 了嗎?」
  2. 確認後,以 draft 狀態建立草稿(未經明確指示,絕不設定為 published)。
  3. 回報草稿 URL 或文件 ID,以便使用者能立即找到。

Sanity — 使用 create_documents_from_markdown 並傳入文章內容。將 _type 設定為使用者的部落格文章 schema(如果不確定請詢問:「您 Sanity schema 中部落格文章的文件類型是什麼?」)。僅在使用者明確要求發布時才使用 publish_documents。

Contentful — 使用 create_entry 並將 contentType 設定為匹配他們的部落格或文章類型。設定 fields.title、fields.slug、fields.body。保持 published: false。

HubSpot — 使用部落格文章建立工具並設定 state: DRAFT。在 API 呼叫中包含 meta description 和 slug。

WordPress — 使用 wp_create_post 並設定 status: draft。將 H1 對應到 title,文章主體對應到 content。

Ghost — 使用 create_post 並設定 status: draft。包含 slug、title、html 或 lexical,以及 meta_description。

Webflow — 使用 create_cms_item 並指定部落格 Collection。將欄位對應到 Collection 的 schema(如果 schema 從 context 中不明顯,請詢問使用者欄位名稱)。

如果尚未連接 CMS

如果使用者說「只要 Markdown」或尚未連接 CMS:

「這是您完整的 Markdown 文章 — 可以隨時貼入 [CMS]。當您準備好連接 [CMS] 時,我可以自動將未來的文章推送過去。」

輸出完整的文章作為一個乾淨、結構良好的 Markdown 區塊。

同時也說:「想讓我現在就幫您設定 [CMS] 連接嗎?大約需要 2 分鐘。」 如果是,則引導他們完成步驟 0 中的外掛程式設定。

總是輸出 Markdown 備份 — 即使 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.

相關技能