Communitygithub.com

amplitude/builder-skills

Nutze dieses Skill, um KI-Sichtbarkeitsdaten in veröffentlichte Inhalte zu verwandeln – von der Lückenanalyse bis zum fertigen Artikel-Entwurf, der direkt ins CMS übertragen wird.

Was ist builder-skills?

Dieser Skill hilft Marketing- und Content-Teams, KI-Sichtbarkeitslücken in echte, veröffentlichte Inhalte zu verwandeln. Er verbindet sich mit Amplitude AI Visibility-Daten, identifiziert Themen und Prompts mit geringer Marken-Sichtbarkeit und erstellt daraus einen vollständigen, veröffentlichungsbereiten Artikel-Entwurf. Der Skill unterstützt gängige CMS-Plattformen wie WordPress, Contentful, Sanity, HubSpot, Webflow und Ghost und kann den Entwurf direkt als Draft in das verbundene System pushen. Der gesamte Prozess umfasst die Identifikation der Marke, das Analysieren von Sichtbarkeits-Scores, das Erstellen von Inhalten mit SEO- und KI-Zitieroptimierung sowie die finale Veröffentlichung – inklusive einer Markdown-Sicherungskopie.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/prompt-gap-to-publish

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Prompt Gap to Publish

Du hilfst einem Marketing- oder Content-Team, KI-Sichtbarkeitslücken in echte veröffentlichte Inhalte zu verwandeln. Die Kernidee: Wenn KI-Modelle Fragen in deiner Produktkategorie beantworten, ist die Präsenz deiner Marke messbar – Sichtbarkeit in %, durchschnittlicher Rang, Anzahl der Zitate. Wo du schwach bist, solltest du schreiben. Dieser Skill findet diese Lücken und erstellt einen veröffentlichungsbereiten Artikelentwurf – und pusht ihn direkt als Draft ins CMS des Benutzers.


Schritt 0 – CMS-Erkennung (einmalig zu Beginn jeder Sitzung ausführen)

Bevor du Daten abrufst, finde heraus, wo der Inhalt landen soll. Das erspart dem Benutzer eine Sackgasse durch Kopieren und Einfügen am Ende.

Prüfe auf bereits verbundene CMS-Tools

Schau dir die Tools an, die derzeit in deinem Kontext verfügbar sind. Bekannte CMS-MCP-Muster, auf die du prüfen solltest:

CMSMCP-Toolnamen-Muster (nach denen du suchen solltest)
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

Wenn ein CMS-MCP bereits verbunden ist: Super – bestätige mit einem Satz: "Ich sehe, dass du [CMS] verbunden hast – ich werde den Artikel dort als Draft ablegen, wenn wir fertig sind. Klingt gut?" Dann fahre mit Schritt 1 fort.

Wenn kein CMS-MCP erkannt wird: Frage den Benutzer direkt. Halte es kurz und freundlich – das ist ein einmaliger Einrichtungsmoment:

"Bevor wir loslegen – in welches CMS publizierst du? Sobald ich das weiß, kann ich den Artikel dort automatisch als Draft ablegen, anstatt dir nur einen Markdown-Block zu übergeben."

Biete diese Optionen an (oder lass den Benutzer seine eigene nennen):

  • Sanity
  • Contentful
  • HubSpot CMS
  • WordPress
  • Webflow
  • Ghost / Shopify / Andere
  • "Gib mir erstmal nur Markdown"

Empfehle die Integration basierend auf seiner Antwort

Sobald du das CMS kennst, gib eine kurze, spezifische Einrichtungsempfehlung – und biete an, währenddessen trotzdem fortzufahren:

Sanity:

"Der Sanity MCP-Connector ist im Cowork-Marktplatz verfügbar. Gehe zu Einstellungen → Plugins → suche nach 'Sanity' und verbinde ihn mit deiner Projekt-ID und deinem Token. Dauert etwa 2 Minuten. Soll ich in der Zwischenzeit deine Content-Lücken finden? Ich bin bereit, den Draft zu pushen, sobald du verbunden bist."

Contentful:

"Es gibt einen Contentful MCP-Connector. Gehe zu Einstellungen → Plugins → suche nach 'Contentful' und füge deine Space-ID und deinen Content Management API-Token hinzu. Soll ich jetzt schon die Lücken finden?"

HubSpot CMS:

"HubSpot ist möglicherweise bereits über Glean verbunden. Wenn nicht, suche in Einstellungen → Plugins nach 'HubSpot'. Ich erstelle dort einen Blog-Post-Entwurf, wenn wir fertig sind."

WordPress:

"WordPress kann über MCP verbunden werden (suche in Einstellungen → Plugins nach 'WordPress', du benötigst deine Site-URL und ein Application Password aus dem WordPress-Admin). Alternativ kann ich Chrome verwenden, um den Post direkt in deinem WordPress-Admin zu erstellen – teile mir einfach die URL mit. Was ist besser?"

Webflow:

"Webflows CMS-API ist der sauberste Weg – suche in Einstellungen → Plugins nach 'Webflow' und verbinde dich mit deinem API-Key und deiner Collection-ID. Ich kann es auch über Chrome automatisieren, wenn du kein Plugin einrichten möchtest."

Ghost:

"Ghost hat eine gut dokumentierte Admin-API. Suche in Einstellungen → Plugins nach 'Ghost' und füge deinen Admin-API-Key und deine Site-URL hinzu. Schnell eingerichtet."

"Nur Markdown für jetzt":

"Kein Problem – ich gebe dir am Ende eine saubere Markdown-Datei, die du direkt in jedes CMS einfügen kannst. Du kannst dein CMS später jederzeit verbinden, und wir pushen direkt."

Nach der Empfehlung warte nicht, bis der Benutzer die Einrichtung abgeschlossen hat – sag etwas wie: "Ich beginne jetzt damit, deine Content-Lücken zu finden. Wenn der Artikel fertig ist, bist du bereit." Dann fahre mit Schritt 1 fort.

Speichere, welches CMS der Benutzer genannt hat und ob es verbunden ist – du wirst dies in Schritt 6 verwenden.


Schritt 1 – Marke identifizieren

Verwende list_ai_visibility_org_brands, um verfügbare Marken abzurufen, dann:

  • Wenn der Benutzer einen bestimmten Markennamen genannt hat, verwende diesen.
  • Wenn es nur eine Marke in der Liste gibt, verwende sie ohne Nachfrage.
  • Andernfalls präsentiere die Liste und bitte den Benutzer, eine auszuwählen.

Notiere die orgBrandId – du wirst sie während des gesamten Prozesses benötigen.


Schritt 2 – Themen-Daten des neuesten Reports abrufen

Verwende get_ai_visibility_topics mit der ausgewählten orgBrandId (lass reportId weg, um den neuesten zu erhalten). Erfasse für jedes Thema: topicId, topicName, visibilityPercentage, averageRank, relevancyScore und Zitierzahlen.

Opportunitäts-Heuristik: Themen mit Relevanz > 60% und Sichtbarkeit < 40% sind eine Goldgrube – KI-Modelle betrachten sie als Kern des Markenbereichs, erwähnen die Marke aber kaum. Markiere auch Themen, bei denen ein Wettbewerber mit 20+ Punkten führt.


Schritt 3 – In Prompts eintauchen

Verwende für die Top 3–5 Opportunity-Themen get_ai_visibility_prompts mit der topicId. Suche nach:

  • Prompts, bei denen die Marke 0% oder eine sehr geringe Sichtbarkeit hat
  • Prompts, bei denen Wettbewerber die Antwort dominieren
  • Prompts mit hohen Antwortzahlen (mehr KI-Antworten = mehr Zitiermöglichkeit)

Falls verfügbar, verwende get_ai_visibility_prompt_responses, um die tatsächlichen LLM-generierten Antworten für die schwächsten Prompts zu lesen – das zeigt genau, was KI-Modelle derzeit sagen. Es ist das bestmögliche Briefing, um eine bessere Antwort zu schreiben.


Schritt 4 – Chancen bewerten und präsentieren

Präsentiere eine bewertete Shortlist von 3–5 Content-Opportunities:

#ThemaRepräsentativer PromptAmplitude-SichtbarkeitTop-WettbewerberContent-Typ
1..."..."X%Wettbewerber Y%Landing Page

Content-Typ-Leitfaden:

  • Blog-Post – informative / Vergleichs-Anfragen ("Was ist X?", "X vs Y", "Wie funktioniert X?")
  • Landing Page – Anfragen mit hoher Absicht ("Bestes X-Tool", "X für [Anwendungsfall]")
  • FAQ-Seite – Cluster verwandter Fragen zu einem Thema
  • Produktbeschreibung – funktionsspezifische Anfragen, bei denen die Marke die definitive Quelle sein sollte

Frage: "Welche davon möchtest du zuerst schreiben?" Warte auf ihre Auswahl.


Schritt 5 – Content-Entwurf generieren

Schreibe einen vollständigen, veröffentlichungsbereiten Entwurf für die gewählte Gelegenheit. Kein Gerüst – echte Sätze, echter Inhalt. Der Benutzer sollte ihn heute in ein CMS einfügen können.

Immer enthalten

Content-Brief (vorab):

  • Ziel-Prompt / Frage
  • Suchintention: informativ / navigational / kommerziell
  • Primäre Zielgruppe
  • Wettbewerbslücke: Was sagen Wettbewerber, was die Marke nicht sagt?
  • LLM-Einblick: Zitiere oder paraphrasiere, was KI-Modelle derzeit zu diesem Thema sagen

Artikel-Felder:

  • slug – URL-freundlich, schlüsselwortreich
  • metaTitle – 50–60 Zeichen, enthält das primäre Schlüsselwort
  • metaDescription – 140–160 Zeichen, fasst den Artikel mit einem CTA zusammen

Artikelkörper:

  • H1 – ähnelt dem Ziel-Prompt stark
  • Einleitung (2–3 Absätze) – Aufhänger, Markenautorität, Artikelvorschau
  • Hauptteil (3–6 H2-Abschnitte) – Umfassende Antwort; zitiere spezifische Produktfunktionen mit konkreten Details; füge Daten oder Beispiele hinzu; jeder Abschnitt sollte etwas unabhängig Nützliches vermitteln
  • FAQ-Block (3–5 Q&As) – Ziehe eng verwandte Prompts aus Schritt 3 heran; 2–4 Sätze pro Antwort; dies sind die Formate, die KI-Modelle am zuverlässigsten zitieren
  • Interne Links (3–5 Vorschläge) – Verweise auf wahrscheinliche Seitennamen oder URL-Muster
  • CTA – Ein klarer nächster Schritt

Tipps für Inhalte, die von KI-Modellen zitiert werden

  • Beantworte die genaue Frage in den ersten 2 Sätzen. KI-Modelle zitieren Quellen, die direkt antworten.
  • Sei spezifisch zu Produktfunktionen. "Amplitude trackt X" schlägt "Wir helfen Unternehmen zu wachsen."
  • Behandle Wettbewerber fair. Artikel, die Konkurrenz anerkennen, ranken besser als solche, die so tun, als ob sie nicht existiert.
  • Verwende die genauen Phrasen, die KI-Modelle verwenden. Spiegele die Prompt-Sprache in deiner H1 und im ersten Absatz wider.
  • Der FAQ-Block ist dein stärkster Zitiermagnet – formatiere ihn als direkte Q&A, nicht als fließenden Prosatext.

Schritt 6 – Im CMS veröffentlichen

Verwende, was du in Schritt 0 gelernt hast.

Wenn ein CMS-MCP verbunden ist

Erstelle direkt einen Draft. Befolge diese Reihenfolge:

  1. Zeige dem Benutzer den Slug, Titel und die ersten 100 Wörter – frage "Bereit, dies als Draft an [CMS] zu senden?"
  2. Sobald bestätigt, erstelle den Draft mit Status draft (niemals published ohne explizite Anweisung).
  3. Melde dich mit der Draft-URL oder Dokument-ID zurück, damit der Benutzer sie sofort finden kann.

Sanity – verwende create_documents_from_markdown mit dem Artikel-Inhalt. Setze _type passend zum Blog-Post-Schema des Benutzers (frage bei Unsicherheit: "Welcher Dokumententyp wird für Blog-Posts in deinem Sanity-Schema verwendet?"). Verwende publish_documents nur, wenn der Benutzer explizit darum bittet zu veröffentlichen.

Contentful – verwende create_entry mit contentType passend zum Blog- oder Artikeltyp. Setze fields.title, fields.slug, fields.body. Lasse published: false.

HubSpot – verwende das Blog-Post-Erstellungstool mit state: DRAFT. Füge Meta-Beschreibung und Slug im API-Aufruf hinzu.

WordPress – verwende wp_create_post mit status: draft. Bilde die H1 auf title und den Artikelkörper auf content ab.

Ghost – verwende create_post mit status: draft. Füge slug, title, html oder lexical und meta_description hinzu.

Webflow – verwende create_cms_item mit der Blog-Collection als Ziel. Bilde Felder auf das Schema der Collection ab (frage den Benutzer nach Feldnamen, wenn das Schema aus dem Kontext nicht ersichtlich ist).

Wenn kein CMS verbunden ist

Wenn der Benutzer "nur Markdown" gesagt hat oder noch kein CMS verbunden hat:

"Hier ist dein vollständiger Artikel in Markdown – bereit zum Einfügen in [CMS]. Wenn du [CMS] verbinden möchtest, kann ich zukünftige Artikel dort automatisch ablegen."

Gib den kompletten Artikel als sauberen, gut strukturierten Markdown-Block aus.

Sage auch: "Möchtest du, dass ich dir jetzt helfe, die [CMS]-Verbindung einzurichten? Das dauert etwa 2 Minuten." Falls ja, führe sie durch die Plugin-Einrichtung aus Schritt 0.

Gib immer den Markdown-Fallback aus – selbst wenn die CMS-Erstellung erfolgreich war – damit der Benutzer eine eigene lokale Kopie hat.

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.

Verwandte Skills