Communitygithub.com

amplitude/builder-skills

分析 AI 模型引用的外部來源,並建立能超越它們的權威內容資產,讓你的品牌成為 AI 的首選資料來源。

builder-skills 是什麼?

這個技能旨在幫助品牌內容團隊,在 AI 模型(如 ChatGPT)回答產業關鍵問題時,讓自家內容被引用,擊敗像是 G2、TechRadar 等第三方網站的排名。它能分析 AI 能見度資料,找出品牌相關主題中哪些外部網頁被引用最多,並深入審查這些頂尖來源的結構、資料完整性、權威性與時效性,歸納出它們之所以被選中的模式。接著,根據引用差距、主題策略重要性與可行性,自動推薦最高槓桿的內容資產類型(如定義指南、基準報告、比較中心),並利用 CMS 整合工具(支援 Sanity、Contentful、HubSpot、WordPress 等)直接產生草稿並推送至內容管理系統。這個技能適用於所有需要 AI 能見度分析的品牌,特別是在使用者明確表達要「超越現有權威來源」、「建立權威資產」或「讓品牌成為最被引用的資料來源」時觸發。其運作方式完全基於 SKILL.md 文件中的五步驟流程,從 CMS 檢查開始,依序進行來源分析、審計、資產生成與最終發佈。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/source-outranker

在你喜歡的 AI 中提問

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

說明文件

來源超車手 (Source Outranker)

你正在幫助內容團隊成為 AI 模型引用時的首選來源——不僅針對品牌查詢,更針對那些定義類別的關鍵問題。當 AI 被問到「什麼是產品分析」或「數位分析工具如何運作」時,它會引用它認為最權威的頁面。這個技能能找出這些頁面、分析它們勝出的原因,並打造出更好的內容。


第 0 步 — CMS 發現(每個工作階段開始時只執行一次)

在開始任何其他操作之前,先找出新內容會落腳在哪裡。這可以避免最後出現複製貼上的死胡同。

檢查是否已有已連接的 CMS 工具

掃描你目前環境中可用的工具。已知的 CMS MCP 模式:

CMS要尋找的工具名稱模式
Sanitysanity, create_documents_from_markdown, patch_document_from_markdown
Contentfulcontentful, create_entry, update_entry
HubSpot CMShubspot, update_blog_post, create_blog_post
WordPresswordpress, wp_update_post, wp_create_post
Ghostghost, update_post, create_post
Webflowwebflow, update_cms_item, create_cms_item

如果已有 CMS MCP 連接: 用一行話確認: 「我看到 [CMS] 已經連線——完成後我會把新的來源資產以草稿形式推送到那裡。好嗎?」 然後繼續進行第 1 步。

如果沒有任何連線: 簡潔地問一次:

「在我們開始之前——您發布到哪個 CMS?我可以直接把內容推送到那裡作為草稿,而不是給您一段要貼上的文字。」

提供選項:Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · 其他 · 「只要給我內容就好」

然後根據他們的回答提供客製化的設定建議(與 prompt-gap-to-publish 中相同的指導)。不要因設定而停滯——立即開始分析,並表示等他們準備好時,你就能推送。


第 1 步 — 識別品牌並提取熱門引用來源

使用 list_ai_visibility_org_brands 來識別品牌(或使用使用者指定的品牌)。

然後使用所選的 orgBrandId,按 citationCount 降序排序,呼叫 get_ai_visibility_sources。這會回傳 AI 模型在與品牌相關的主題上引用的每個網域,欄位包括:domain、citationCount、responseCount、url、title。

將結果分成兩組:

  • 自有來源:品牌自家網域上的頁面(例如 amplitude.com)
  • 第三方來源:其他所有來源——評論網站、媒體、文件、競爭對手部落格

排名超過品牌自家網域的第三方來源就是目標。這些是你需要超越的頁面。

找出按引用次數排名前 10 的第三方來源。呈現摘要:

來源網域引用次數類型
g2.com340評論聚合器
contentsquare.com/blog180競爭對手部落格
techradar.com150媒體
...

同時呼叫 get_ai_visibility_topics 來了解哪些主題驅動了這些引用——你會用它來選擇要建立哪個來源資產。


第 2 步 — 審計頂尖來源勝出的原因

對於排名前 5 的第三方來源中的每一個,使用 web_fetch 來取得實際頁面內容。仔細閱讀每個頁面。你要尋找的是讓這些頁面對 AI 模型具有權威性的結構和內容模式。

根據以下幾點評估每個來源:

答案結構:頁面是否直接回答了一個明確的問題?是否有清晰的 H2 和 H3 層級結構來對應子問題?結構清晰的頁面更容易被可靠地抓取。

數據與具體性:頁面是否引用了統計數據、基準、調查結果或其他可驗證的數據?AI 模型引用含有具體數據的頁面的比例遠高於意見。

全面性:它是否詳盡地涵蓋了該主題——歷史、運作機制、用例、比較、常見問題?內容單薄的頁面會輸給覆蓋深入的頁面。

時效性訊號:頁面是否醒目地顯示了日期、「已更新至 [年份]」或參考了近期事件?AI 模型偏好看起來是最新的來源。

權威性訊號:作者資歷、公司聲譽、方法論揭露、研究引用、同儕參考。

資產類型:什麼格式讓這個頁面具有權威性?常見的勝出格式:

  • 定義指南(「什麼是產品分析」)
  • 基準報告(「2025 年產品分析現狀」)
  • 方法論解釋(「Session Replay 如何運作」)
  • 詞彙表(「產品分析術語解釋」)
  • 比較中心(「產品分析工具比較」)

將審計結果總結為一個模式:「此主題上最常被引用的來源共享:[3–4 個模式]。品牌現有內容缺少:[2–3 個差距]。」


第 3 步 — 識別來源資產機會

根據審計結果,找出最具槓桿效益的來源資產來建立。根據以下幾點為機會評分:

引用差距:頂尖外部來源比品牌在同主題上最佳自有頁面多了多少引用?差距超過 200 次引用的目標是高價值目標。

主題策略重要性:與 get_ai_visibility_topics 交叉比對——這是不是一個品牌相關性高但能見度低的主題?如果是,擁有該來源將帶來複合效應。

可建構性:品牌是否能可信地擁有這種資產類型?基準報告需要數據;定義指南只需要專業知識。偏好品牌能以權威性進行製作的資產。

資產類型選擇指南:

  • 如果頂尖來源是定義性頁面 → 建立一個更深入的全面指南
  • 如果頂尖來源是評論聚合器(G2、Capterra) → 建立一個方法論/透明度頁面,讓 AI 模型將其引用為比較標準的主要來源
  • 如果頂尖來源是競爭對手部落格 → 建立一個中立、數據豐富的資產,比競爭對手帶有私心的版本更具權威性
  • 如果頂尖來源是媒體/分析師報告 → 建立一個專有的基準或研究報告

呈現 2–3 個資產選項 並附上建議:

#資產類型目標主題估計引用差距建議
1終極指南「什麼是產品分析」−280優先建立:定義性、搜尋量高
2基準報告「2025 年產品分析採用趨勢」−140其次建立:需要數據
3比較中心「產品分析工具比較」−95不錯,但競爭激烈

詢問:「您想建立哪個資產?」 等待他們的選擇。


第 4 步 — 生成來源資產

撰寫完整的資產。不是骨架——而是真正比它要超越的來源更有用、更具體、更全面的、可發布的內容。

資產類型模板

終極指南(「什麼是 X」、「X 如何運作」、「X 完全指南」)

  • H1:直接回答定義性問題
  • 開場(2–3 段):第一句直接給出定義;為什麼重要;本指南涵蓋的內容
  • 核心章節(5–8 個 H2):定義 → 運作方式 → 關鍵組成 → 按公司類型的用例 → 如何評估 → 實施考量 → 常見問題
  • 數據點:至少包含 5 個具體的統計資料或基準(如果是專有資料,請註明來源或標註來自 Amplitude 研究)
  • 視覺輔助描述:提及哪些圖表、截圖或表格可以強化每個章節——即使未包含圖片,所描述的結構也能傳達權威性
  • FAQ 區塊:使用與此主題 AI 能見度提示完全相同的語言,包含 6–8 組問答
  • 內部連結:4–5 個指向相關 Amplitude 內容的連結
  • 最後更新備註:在元資料中包含「最後更新:[當前月份/年份]」

基準報告(「X 的現狀」、「X 趨勢報告」、「X 數字會說話」)

  • H1:「[類別] 基準報告 [年份]:關鍵指標與趨勢」
  • 執行摘要:以要點形式列出 5–7 個關鍵發現
  • 方法論章節:資料收集方式、樣本數、時間範圍——AI 模型喜歡引用透明的方法論
  • 資料章節(4–6 個 H2):每個章節包含一個標題發現、支援數據和解釋
  • 按區隔比較:企業 vs 中小企業、產業垂直類別、公司階段
  • 趨勢分析:如果有的話,提供逐年變化
  • 建議:這些數據對產品團隊的意義
  • FAQ 區塊:4–5 組問答

比較中心(「X 工具比較」、「最佳 X 平台」、「[類別] 軟體指南」)

  • H1:「[年份] 最佳 [類別] 工具:為產品團隊比較」
  • 選擇標準:工具的評估方式——這讓比較更值得信賴
  • 摘要比較表:8–10 個工具、關鍵維度、最佳適用情境標註
  • 每個工具的深入分析:每個 200–300 字,涵蓋優勢、限制、定價模式、最佳適用場景
  • 決策框架:針對 5–6 種情境,採用「如果你 [條件],選擇 X」的格式
  • FAQ 區塊:5–6 組問答

總是包含中繼欄位

  • metaTitle — 50–60 個字元,包含主要關鍵字
  • metaDescription — 140–160 個字元,傳達權威性和全面性
  • slug — 關鍵字豐富、具體(例如 /blog/what-is-product-analytics 而非 /blog/analytics)
  • lastUpdated — 當前日期

第 5 步 — 推送至 CMS

使用你在第 0 步中發現的資訊。這是一個新文件(建立操作,而非更新)。

Sanity — 使用 create_documents_from_markdown 搭配完整的資產內容。將 _type 設定為符合部落格/文章結構的值。如果不確定,詢問使用者:「在您的 Sanity 結構中,長篇指南的文件類型是什麼?」未經明確指示,絕不使用 publish_documents。

Contentful — 使用 create_entry,contentType 設定為他們的文章類型。設定 fields.title、fields.slug、fields.body。保留 published: false。

HubSpot — 使用 create_blog_post,state: DRAFT。包含 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 的結構(如果從上下文不明確,請詢問使用者欄位名稱)。

推送後,確認:「完成——[資產標題] 已儲存為 [CMS] 中的草稿。這裡是 ID/URL:[連結]。發布前請到那裡審查。」

即使 CMS 推送成功,也總是輸出完整的 Markdown 備份內容。


什麼讓一個來源對 AI 模型具有權威性

AI 模型引用來源不是因為它們來自大品牌。它們引用的是能夠:

  • 比任何人更好地回答一個特定問題。「什麼是產品分析」的最佳來源,就是那個定義最清晰、最完整、最直接的頁面。
  • **包含具有透明方法論的數據。**一個說「我們調查了 500 個產品團隊」的基準報告,比一個說「領先專家認為」的報告更常被引用。
  • **從各個角度涵蓋主題。**AI 模型偏好全面的來源而非狹隘的來源。一個涵蓋定義、運作機制、用例、評估標準和常見問題的指南,將在任何單一維度上擊敗較短的頁面。
  • 有清楚的日期標示。「已更新至 2025 年 4 月」的標籤傳達了時效性。AI 模型會避免引用快速變動主題上的過時來源。
  • **連結到其他權威訊號。**指向相關內容的內部連結、數據的外部引用、作者資歷——所有這些都能增加頁面在 AI 訓練和推論中的信任分數。

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

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.

相關技能