Communitygithub.com

amplitude/builder-skills

将AI可见性数据转化为可发布的内容,识别内容差距并生成可直接推送至CMS的草稿文章。

builder-skills 是什么?

该技能专为营销或内容团队设计,帮助用户将AI可见性数据中的差距(如低可见度主题、竞争对手占优的提示词)转化为实际发布的内容。它连接Amplitude的AI可见性数据(主题、提示词、可见度评分、引用和完整LLM响应),识别品牌表现薄弱的主题和提示词,并生成包含内容简报、标题、元描述、正文、FAQ区块和内链的完整文章草稿。支持Sanity、Contentful、HubSpot CMS、WordPress、Webflow和Ghost等主流CMS,通过MCP工具自动将草稿推送至用户连接的CMS。该技能基于“可见度<40%且相关性>60%”的机会启发式方法选择主题,并优先处理竞争对手领先超过20个百分点的领域,确保内容针对AI模型引用进行优化。

兼容平台~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 的新对话。

文档

提示词差距到发布

你正在帮助营销或内容团队将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?一旦我知道,我就可以自动将文章作为草稿推送到那里,而不是给你一份需要粘贴的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’,你需要站点URL和WordPress管理员中的应用程序密码)。或者,我可以使用Chrome在你的WordPress管理后台直接撰写草稿——只需分享URL。哪种方式更方便?”

Webflow:

“Webflow的CMS API是最简洁的方式——在设置→插件中搜索‘Webflow’并用你的API密钥和集合ID连接。如果你不想设置插件,我也可以通过Chrome自动操作。”

Ghost:

“Ghost有文档完善的Admin API。在设置→插件中搜索‘Ghost’并添加你的Admin API密钥和站点URL。设置很快。”

“暂时只要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步——深入分析提示词

对于前3-5个机会主题,使用 get_ai_visibility_prompts 并传入 topicId。查找:

  • 品牌可见度为0%或非常低的提示词
  • 竞争对手主导响应的提示词
  • 响应数量高的提示词(更多AI答案 = 更多引用机会)

如果可用,使用 get_ai_visibility_prompt_responses 读取最弱提示词的实际LLM生成答案——这能准确显示AI模型当前的说法。这是编写更好答案的最佳简报。


第4步——对机会进行排名和展示

展示一个包含3-5个内容机会的排名短列表:

#主题代表性提示词Amplitude可见度主要竞争对手内容类型
1...“...”X%竞争对手Y%着陆页

内容类型指南:

  • 博客文章 — 信息性/比较性查询(“什么是X?”、“X与Y对比”、“X如何工作?”)
  • 着陆页 — 高意图查询(“最佳X工具”、“X适用于[使用场景]”)
  • FAQ页面 — 围绕一个主题的相关问题集群
  • 产品描述 — 特定功能查询,品牌应作为权威来源

询问:“你想先写哪一个?” 等待用户选择。


第5步——生成内容草稿

为所选机会撰写一份完整的、可发布的草稿。不是框架——要有真实的句子和内容。用户应该能够今天就直接粘贴到CMS中。

始终包含

内容简报(开头):

  • 目标提示词/问题
  • 搜索意图:信息性/导航性/商业性
  • 主要受众
  • 竞争对手差距:竞争对手说了什么而品牌没有说?
  • LLM洞察:引用或转述AI模型当前在这个主题上的说法

文章字段:

  • slug — 对URL友好,包含关键词
  • metaTitle — 50-60个字符,包含主要关键词
  • metaDescription — 140-160个字符,总结文章并包含行动号召

文章正文:

  • H1 — 与目标提示词紧密匹配
  • 引言(2-3段)——钩子、品牌权威性、文章预览
  • 正文(3-6个H2部分)——全面回答;引用具体的产品能力并提供具体细节;包含数据或示例;每个部分都应独立地传授有价值的内容
  • FAQ区块(3-5个问答)——从第3步中提取密切相关的问题;每个答案2-4句话;这些是AI模型最可靠引用的格式
  • 内链建议(3-5个)——参考可能的页面名称或URL模式
  • 行动号召——一个清晰的下一步

让内容被AI模型引用的技巧

  • 在前两句话中直接回答问题。AI模型会引用直接回答问题的来源。
  • 具体说明产品能力。“Amplitude跟踪X”优于“我们帮助公司成长。”
  • 公平地涵盖竞争对手。承认竞争的文章排名优于假装竞争不存在的文章。
  • 使用AI模型使用的确切措辞。在你的H1和第一段中镜像提示词语言。
  • FAQ区块是你最强大的引用磁石——将其格式化为直接的问答,而不是流畅的散文。

第6步——发布到CMS

使用你在第0步学到的信息。

如果已连接CMS MCP

直接创建草稿。遵循以下顺序:

  1. 向用户显示slug、标题和前100个词——询问*“准备好将其作为草稿推送到[CMS]了吗?”*
  2. 一旦确认,以状态 draft 创建草稿(除非明确指示,否则绝不使用 published)。
  3. 返回草稿URL或文档ID,以便用户立即找到它。

Sanity — 使用 create_documents_from_markdown 并传入文章内容。将 _type 设置为用户的博客文章模式(如果不确定则询问:“你的Sanity模式中博客文章的文档类型是什么?”)。仅当用户明确要求发布时,才使用 publish_documents。

Contentful — 使用 create_entry 并设置 contentType 匹配他们的博客或文章类型。设置 fields.title、fields.slug、fields.body。保留 published: false。

HubSpot — 使用博客文章创建工具并设置 state: DRAFT。在API调用中包含元描述和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 定位博客集合。将字段映射到集合的模式(如果模式从上下文中不明显,则询问用户字段名称)。

如果尚未连接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.

相关技能