Communitygithub.com

amplitude/builder-skills

撰寫專為傳統 SEO 與 AI 引擎引用 (AEO) 最佳化的技術發布部落格文章。

builder-skills 是什麼?

這個技能「amplitude/builder-skills」是專為開發者和技術寫作者設計的 AI 代理技能,其核心功能是自動化產出高品質的產品發布部落格文章。它不僅擅長 SEO,更獨特地強化了「答案引擎優化 (AEO)」,確保文章能被 ChatGPT、Perplexity 等 AI 搜尋引擎準確引用。技能支援多種文章類型,從正式的發布公告、技術深度解析,到實作教學與簡潔的變更日誌,都能根據發布層級受眾自動匹配結構。其運作方式強調「用證據說話」,要求為每個效能、易用性宣稱提供基準測試數據、可執行代碼或真實客戶評價,並在結尾提供單一、明確的行動呼籲。此外,它內建了從關鍵字研究、Schema 標記到發布後監控的完整檢查清單,是一套從撰寫到推廣的整合方案。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/launch-skills/skills/launch-blog-post

在你喜歡的 AI 中提問

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

說明文件

發布部落格文章

此技能協助撰寫用於發布產品消息的部落格文章。一篇出色的發布文章需達成三個目標:告訴你的受眾你發布了什麼及其重要性、在搜尋引擎中針對你的受眾正在搜尋的關鍵詞排名、以及在人們詢問你的產品能解決的問題時,被 AI 答案引擎引用。

文章類型

根據發布層級和目標受眾選擇合適的文章類型。

公告文章

最佳適用於:Tier 1 和 Tier 2 發布。主要受眾:現有用戶與潛在客戶。

結構:發布了什麼 → 為何重要 → 如何運作 → 如何開始。字數控制在 1500 字以內。讀者應能在閱讀後 5 分鐘內理解變更內容並開始嘗試。

技術深度解析

最佳適用於:Tier 1 開發者/技術產品的發布。主要受眾:評估是否採納的工程師。

結構:問題 → 方法 → 架構/實作 → 基準測試 → 開始使用。篇幅可較長 (2000-3000 字)。包含程式碼範例、架構圖與效能數據。這是在 Hacker News 上會被分享的文章類型。

教學 / 「用 Y 打造 X」

最佳適用於:任何層級發布後的第一週內發布。主要受眾:剛聽說你並想親身體驗評估的開發者。

結構:我們要建構什麼 → 前置需求 → 逐步實作 → 成果。應能在 15-30 分鐘內完成。需包含完整可運作的程式碼,而非片段。

變更日誌條目

最佳適用於:Tier 3 發布或小型改進的彙整。主要受眾:現有用戶。

結構:每個改進以一個簡短段落說明。開頭直接說明什麼改變了,而非為何改變。連結至文件以獲取詳細資訊。建議每週或雙週彙整發布。

撰寫文章

從訊息簡報開始

若存在發布策略的訊息簡報,請使用它。主要價值主張成為文章的核心論點,次要價值主張則成為各章節。證據點則成為你貫穿全文的佐證。

若無簡報,請在寫作前先行定義:這篇文章寫給誰?他們現在能做些什麼?他們為何應該在乎?

以價值引領,而非過程

第一段必須回答「發布了什麼,以及為什麼這對我重要?」。切勿以你花了多少時間、有多少工程師參與或你的開發歷程開場。讀者不在乎你的過程——他們在乎的是自己的問題。

好的開頭: 「你現在可以透過單一 API 呼叫處理 14 種語言的音訊檔案。對於 10 分鐘內的檔案,延遲低於 200ms。」

不好的開頭: 「經過六個月的努力,我們的團隊非常興奮地宣布我們音訊處理平台的下一階段演進。」

展示,而非僅敘述

針對每個主張提供證據:

  • 效能聲明 → 附有方法的基準測試數據
  • 「易於使用」 → 5-10 行的可運作程式碼範例
  • 「客戶喜愛它」 → 附有背景的具體引言
  • 「比替代方案更好」 → 誠實的比較表格

包含可運作的範例

每篇技術產品的發布文章都應包含讀者可執行的程式碼。不是虛擬碼,也不是概念性片段——而是真正的、包含安裝指令、匯入語句和預期輸出結果的可運作程式碼。這是技術部落格文章中轉換率最高的單一元素。

以明確的下一步行動結尾

文章結尾必須只有一個行動呼籲(CTA)。「立即試用」、「閱讀文件」、「加入 Beta 版」。不是三個選項——只是一個。

SEO 優化

關鍵字定位

在動筆前選定主要關鍵字。它應符合你的目標受眾在遇到你的產品所能解決的問題時,會搜尋的詞彙。文章標題、H1 標題和第一段都應自然地包含此關鍵字。

對於發布文章,關鍵字通常是功能/產品名稱加上類別:「[產品] [類別]」(例如:「即時轉寫 API」或「開源功能開關」)。

頁面基本要素

  • 標題標籤 (Title Tag):包含主要關鍵字,字數少於 60 個字元。部落格文章標題應與 HTML 標題標籤密切匹配。
  • Meta 描述:150-160 個字元,總結讀者將學到或能夠做到的事情。
  • URL 縮寫 (URL Slug):簡短、富含關鍵字,不包含日期(使其保持長青)。
  • 標題 (H2/H3):用於邏輯地組織文章結構。每個 H2 應是某人可能搜尋的問題或主題。
  • 內部連結:連結到你的文件、相關部落格文章和著陸頁。從文件回連到這篇文章。
  • 圖片替代文字 (Alt Text):描述圖片內容,在自然的前提下包含相關關鍵字。

長尾關鍵詞排名內容

主要公告下方的章節——如何運作、技術細節、常見問題、比較——是長尾關鍵詞的目標。編寫它們以回答你受眾提出的具體問題。一個標題為「[功能] 如何處理 [邊緣案例]?」的章節,可以為該確切查詢進行排名。

AEO:答案引擎優化

AI 搜尋引擎(ChatGPT、Perplexity、Claude、Gemini 以及傳統搜尋中的 AI 驅動摘要)正成為人們發現和評估產品的主要方式。AEO 是一種結構化內容以利 AI 引擎在生成答案時引用的實務。

AEO 與 SEO 互補而非競爭。大多數 AEO 最佳實務也有助於 SEO。但有一些特定技術能使內容更易被 AI 引用。

為什麼 AEO 對發布文章很重要

當有人問 AI 助手「什麼是 [你的產品功能] 的最佳工具?」或「我該如何 [你的產品能完成的任務]?」時,你希望你的發布文章是 AI 從中提取資訊的來源之一。一次 AI 引用就能在發布日的流量消退後,持續長久地帶來發現機會。

讓內容可被 AI 引用

撰寫自成一體、可提取的段落。 AI 引擎引用段落而非整篇文章。你文章的每個章節都應能獨立理解,無需讀者先閱讀前文。一個明確陳述主張、用證據佐證、並提及你產品名稱的段落——這就是一個可被引用的單元。

以直接答案引領章節。 當一個章節處理一個問題(即使是隱含的)時,將答案放在第一句,然後再詳細說明。AI 引擎偏好能快速且具體回答的內容。

範例——與其這樣寫:

「選擇轉寫 API 時有許多因素需要考慮。延遲、準確度、語言支援和價格都扮演了重要角色。經過廣泛測試後,我們發現...」

不如這樣寫:

「[產品] 能以低於 200ms 的延遲轉寫 14 種語言的音訊,每分鐘僅需 $0.006。以下是基準測試的詳細分析...」

第二個版本可直接被引用。一個回答「最快的轉寫 API 是什麼?」的 AI 引擎可以直接抓取該句。

使用具體的量化主張。 AI 引擎偏好引用包含具體數據的內容:數字、基準測試、比較、百分比。「快速 API」不可引用,但「10 分鐘音訊檔案的 P99 延遲為 180ms」則可以。

包含結構化數據。 比較表格、功能矩陣和基準測試表格非常容易被引用,因為它們提供結構化、可提取的資訊。一個誠實比較你的產品與替代方案的表格,是最常被 AI 引用的內容格式之一。

使用真實問題編寫常見問題 (FAQ) 章節。 每個問題都匹配真實用戶會問 AI 助理的問題的常見問答章節,是引用的磁鐵。將問題寫成自然的 H3,然後在第一句直接回答。

針對 AI 引擎的 Schema 標記

Schema 標記為 AI 引擎提供機器可讀的內容上下文。在你的發布部落格文章中新增以下標記:

  • Article / BlogPosting schema:告訴 AI 引擎這是一篇帶有特定作者和主題的日期文章。包含 headline、datePublished、dateModified、author 和 description。
  • FAQPage schema:如果你的文章有 FAQ 章節,標記它以便 AI 引擎直接提取問答對。
  • HowTo schema:如果你的文章包含教學或逐步指南,標記這些步驟。
  • Product schema:如果文章發布的產品有定價,則包含帶有 name、description 和 offers 的產品 schema。

你不需要全部使用——只需使用與你實際編寫的內容相匹配的即可。

內容時效性訊號

AI 引擎會權重建檔日期。未更新的頁面會隨著時間失去 AI 引用。對於發布文章:

  • 在頁面上包含一個可見的「最後更新:[日期]」
  • 每當你進行更改時,更新 Article schema 中的 dateModified
  • 每季重新檢視發布文章:更新基準測試、新增功能、更新程式碼範例
  • 如果發布文章已過時,請更新它或將流量導向更新的文章——不要讓過時的內容繼續排名

實體與品牌訊號

AI 引擎會建立品牌和產品的內部模型。透過保持一致性來幫助它們:

  • 一致地使用你的確切產品/功能名稱(不要在不同暱稱間交替使用)
  • 明確陳述你的產品屬於哪個類別(例如「一個開源的功能開關平台」)
  • 連結到關於你公司的權威來源(首頁、文件、GitHub、若適用的 Wikipedia)
  • 確保你的產品在你的部落格、文件、著陸頁和社交媒體上描述一致

發布後檢查清單

發布後:

  1. 從各處建立連結:文件、著陸頁、變更日誌、相關部落格文章、README
  2. 在社群媒體上分享:使用 launch-tweet 技能來撰寫社群文案
  3. 提交到內容聚合平台:Hacker News、相關 subreddits、dev.to、Hashnode(針對技術文章)
  4. 發送電子郵件:包含在發布電子郵件或下期電子報中
  5. 監看問題:文章下方的留言、HN 討論串、Reddit——這些通常會揭示文章中的不足,你應透過更新來補救
  6. 發布週後更新:加入客戶故事、更新基準測試、修正讀者提出的任何問題

配套技能

  • launch-strategy — 訊息簡報與發布規劃
  • launch-tweet — 推廣文章的社群文案
  • launch-email — 連結到這篇文章的電子郵件
  • launch-video — 可嵌入文章中的示範影片和 GIF
  • launch-distribution — 如何及在何處進行部落格以外的發布分發
  • launch-landing-page — 部落格文章連結到的目標頁面
  • launch-metrics — 為部落格文章連結設置 UTM,追蹤文章長期表現

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.

相關技能