Communitygithub.com

amplitude/builder-skills

撰写专为传统SEO和AI引擎引证(AEO)优化的技术产品发布博客文章。使用此技能以编写产品发布公告、技术博客、更新日志或其他与发布相关的长文内容。

builder-skills 是什么?

该AI代理技能旨在协助编写技术产品的发布博客文章,确保其同时优化传统搜索引擎(SEO)和AI答案引擎(AEO/GEO)。它接受多种文章类型,包括公告帖、技术深度分析、教程和更新日志,并能根据受众和发布层级匹配最合适的结构。技能强调以价值为导向的开篇、提供可工作代码示例、使用具体数据支撑论点,并包含清晰的行动号召(CTA)。在SEO方面,它指导选择核心关键词、优化标题标签、元描述、URL和内部链接。在AEO方面,它关注创作自包含、可引用的段落,优先使用定量化表述,并推荐使用FAQPage、HowTo和Product等结构化数据标记,以增加内容被AI引擎引用并长期获得的发现机会。

兼容平台✓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答案引擎引用。

文章类型

根据发布层级和受众匹配文章类型。

公告帖

最佳适用:一级和二级发布。主要受众:现有用户和潜在客户。

结构:发布了什么 → 为什么重要 → 如何工作 → 如何开始。字数控制在1500字以内。读者应能在阅读后5分钟内理解变化并尝试使用。

技术深度分析

最佳适用:开发者/技术产品的一级发布。主要受众:评估是否采纳的工程师。

结构:问题 → 方法 → 架构/实现 → 基准测试 → 入门指南。篇幅可以更长(2000-3000字)。包含代码示例、架构图和性能数据。这类文章通常在Hacker News上被分享。

教程 / "用Y构建X"

最佳适用:任何层级发布的首周内发布。主要受众:刚听说您并希望动手评估的开发者。

结构:我们要构建什么 → 先决条件 → 分步实现 → 结果。应在15-30分钟内完成。包含完整的工作代码,而非片段。

更新日志条目

最佳适用:三级发布和捆绑的小改进。主要受众:现有用户。

结构:每个改进一个简短段落。以变更内容开头,而非原因。链接到文档获取详情。按周或双周汇总。

撰写文章

从信息传递简报开始

如果存在发布策略信息传递简报,请使用它。主要价值主张成为文章的核心论点。次要价值主张成为章节。证据点成为贯穿全文的论据。

如果没有简报,请在写作前定义:这篇文章写给谁?他们现在能做什么?他们为什么要在意?

以价值而非过程开头

第一段必须回答“发布了什么,为什么对我重要?”切勿以您花了多长时间、有多少工程师参与或产品开发历程开头。读者不关心您的过程——他们只关心自己的问题。

好的开头: “您现在可以通过单一API调用处理14种语言的音频文件。对于10分钟以内的文件,延迟低于200毫秒。”

差的开头: “经过六个月的努力,我们的团队激动地宣布音频处理平台的下一轮进化。”

展示,而非空谈

对每个主张提供证据:

  • 性能主张 → 包含方法的基准测试数据
  • “易于使用” → 5-10行的工作代码示例
  • “客户喜爱” → 带来龙去脉的具体引用
  • “优于替代方案” → 诚实的对比表格

包含可工作示例

每篇技术产品的发布文章都应包含读者可以运行的代码。不是伪代码或概念性片段,而是包含安装命令、导入和预期输出的实际可工作代码。这是技术博客文章中转化率最高的单一元素。

以明确的下一步行动结尾

文章结尾需要一个明确的行动号召(CTA)。“立即尝试”、“阅读文档”、“加入测试版”。不是三个选项——而是一个。

SEO优化

关键词定位

写作前选择主要关键词。该关键词应匹配目标受众在遇到您产品解决的问题时所搜索的内容。文章标题、H1和第一段都应自然地包含此关键词。

对于发布文章,关键词通常是功能/产品名称加类别:“[产品] [类别]”(例如,“实时转录API”或“开源功能标志”)。

页面基础优化

  • 标题标签:包含主要关键词,不超过60个字符。博客文章标题和HTML标题标签应紧密匹配。
  • 元描述:150-160个字符,总结读者将学到或能做什么。
  • URL短链接:简短、包含关键词、不包含日期(以便保持长期有效)。
  • 标题(H2/H3):用于逻辑性地构建文章。每个H2应是一个人们可能搜索的问题或主题。
  • 内部链接:链接到您的文档、相关博客文章和着陆页。在文档中链接回此文章。
  • 图片alt文本:描述图片内容,在自然处包含相关关键词。

长尾排名内容

主要公告以下的章节——工作原理、技术细节、常见问题、对比——作为长尾关键词目标。编写它们以回答受众提出的特定问题。标题为“[功能]如何处理[边缘情况]?”的章节可以针对该确切查询排名。

AEO:答案引擎优化

AI搜索引擎(ChatGPT、Perplexity、Claude、Gemini以及传统搜索中的AI增强摘要)正成为人们发现和评估产品的主要方式。AEO是一种结构化内容的实践,使AI引擎在生成答案时引用它。

AEO和SEO是互补的,而非竞争关系。大多数AEO最佳实践也有助于SEO。但有特定技术使内容更易被AI引用。

AEO对发布文章的重要性

当有人向AI助手询问“做[您产品做的事情]的最佳工具是什么?”或“我如何[您产品实现的任务]?”时,您希望您的发布文章成为AI引用的来源之一。一次AI引用可以在发布日流量消退后长期推动持续发现。

使内容可被AI引用

编写自包含、可提取的段落。 AI引擎引用的是段落,而非整篇文章。文章的每个部分应能独立理解,无需读者阅读了之前的内容。一个段落如果包含明确的主张、有证据支持、并提及您的产品,就是一个可引用的单元。

以直接答案开头每个部分。 当某个部分解答一个问题时(即使只是隐含的),将答案放在第一句,然后再详细阐述。AI引擎倾向于选择能快速且具体回答的内容。

示例——与其写:

“选择转录API时需要考虑许多因素。延迟、准确性、语言支持和价格都起作用。经过广泛测试,我们发现……”

不如写:

“[产品]以每分钟0.006美元的价格,在14种语言中实现低于200毫秒的音频转录。以下是基准测试的详细分解……”

第二个版本可直接引用。AI引擎在回答“最快的转录API是什么?”时可以逐字提取该句子。

使用具体、量化的主张。 AI引擎优先引用包含具体数据的内容:数字、基准、对比、百分比。“快速API”不可引用,“10分钟音频文件的P99延迟为180毫秒”则可引用。

包含结构化数据。 对比表格、功能矩阵和基准测试表格因提供结构化、可提取的信息而高度可被引用。诚实地将您的产品与替代方案对比的表格是最常被AI引用的内容格式之一。

编写具有真实问题的常见问题部分。 每个问题匹配人们实际会向AI助手询问的FAQ部分是引文磁铁。将问题写成自然的H3,然后在第一句直接给出答案。

面向AI引擎的Schema标记

Schema标记为AI引擎提供机器可读的上下文。在发布博客文章中添加以下标记:

  • Article / BlogPosting schema:告知AI引擎这是一篇带有特定作者和主题的日期文章。包含headline、datePublished、dateModified、author和description。
  • FAQPage schema:如果文章包含FAQ部分,进行标记以便AI引擎直接提取问答对。
  • HowTo schema:如果文章包含教程或分步指南,标记步骤。
  • Product schema:如果文章宣布带有定价的产品,包含产品schema,包括name、description和offers。

您不需要全部使用——只使用与实际内容匹配的标记。

内容新鲜度信号

AI引擎会权衡内容的时效性。未更新的页面会随着时间推移而失去AI引用。对于发布文章:

  • 在页面上包含可见的“最后更新:[日期]”
  • 每次更改时更新Article schema中的dateModified
  • 每季度重新访问发布文章:更新基准测试、添加新功能、刷新代码示例
  • 如果发布文章过时,要么更新它,要么重定向到一篇新文章——不要让陈旧内容继续排名

实体和品牌信号

AI引擎会构建品牌和产品的内部模型。通过以下方式保持一致性来帮助它们:

  • 始终使用确切的产品/功能名称(不要交替使用昵称)
  • 明确声明产品所属类别(例如,“一个开源功能标志平台”)
  • 链接到关于您公司的权威来源(主页、文档、GitHub、如果适用,维基百科)
  • 确保您的产品在博客、文档、着陆页和社交资料中的描述保持一致

发布后检查清单

发布后:

  1. 从各处链接:文档、着陆页、更新日志、相关博客文章、README
  2. 在社交平台分享:使用发布推文技能来编写社交文案
  3. 提交到聚合平台:Hacker News、相关Reddit子版块、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.

相关技能