Communitygithub.com

amplitude/builder-skills

Usa esta skill cuando un usuario quiera probar variantes de contenido antes de publicar para encontrar cuál será citada con más frecuencia por los modelos de IA.

¿Qué es builder-skills?

Esta skill permite a los equipos de contenido tomar decisiones basadas en datos en lugar de corazonadas al publicar. Simula cómo responderán los modelos de IA a diferentes variantes de contenido antes de publicarlas, utilizando la visibilidad de IA de Amplitude (AI Visibility) para obtener respuestas reales de modelos como GPT, Claude y Gemini sobre un tema dado. Genera de 2 a 3 variantes con enfoques distintos, las puntúa según criterios como alineación con prompts, especificidad y cobertura de brechas, y recomienda la variante ganadora. Finalmente, la skill puede publicar la variante ganadora como borrador directamente en el CMS (como Sanity, Contentful, HubSpot, WordPress, Ghost o Webflow) y guarda las variantes alternativas para pruebas A/B futuras. Esta skill es ideal para optimizar contenido para IA antes de publicar, ahorrando tiempo y mejorando las posibilidades de que el contenido sea citado por modelos de lenguaje.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/simulation-backed-publisher

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Publicación respaldada por simulación

Estás ayudando a un equipo de contenido a dejar de adivinar. En lugar de publicar un contenido y esperar que sea citado, esta skill genera 2–3 variantes distintas, puntúa cada una contra lo que los modelos de IA realmente están diciendo sobre este tema, y recomienda la que tiene más probabilidades de ganar citas — antes de que una sola palabra se publique.


Paso 0 — Descubrimiento de CMS (ejecutar una vez al inicio de cada sesión)

Antes de hacer cualquier otra cosa, averigua dónde aterrizará el contenido ganador. Esto evita un callejón sin salida de copiar y pegar al final del flujo de trabajo.

Verificar herramientas de CMS ya conectadas

Escanea las herramientas disponibles actualmente en tu contexto. Patrones conocidos de MCP de CMS:

CMSPatrones de nombre de herramienta a buscar
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

Si un MCP de CMS ya está conectado: confirma en una línea: "Veo que [CMS] está conectado — enviaré la variante ganadora allí como borrador cuando terminemos. ¿Suena bien?" Luego procede al Paso 1.

Si no hay nada conectado: pregunta una vez, de forma concisa:

"Antes de empezar — ¿a qué CMS publicas? Puedo enviar la variante ganadora directamente allí como borrador, en lugar de darte un bloque de texto para pegar."

Ofrece: Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · Otro · "Solo dame el contenido"

Luego da una recomendación de configuración personalizada según su respuesta (misma guía que en prompt-gap-to-publish). No te detengas por la configuración — comienza el análisis inmediatamente y di que estarás listo para enviar cuando se hayan conectado.


Paso 1 — Identificar la oportunidad a simular

Usa list_ai_visibility_org_brands para identificar la marca (o usa la que el usuario especificó).

El usuario puede llegar aquí con una oportunidad ya en mano (por ejemplo, de ejecutar prompt-gap-to-publish o competitor-prompt-hijacker). Si es así, usa esa oportunidad directamente.

Si no, usa get_ai_visibility_topics con el orgBrandId seleccionado para mostrar los 3–5 mejores oportunidades usando la heurística de puntuación estándar: temas con relevancia > 60% y visibilidad < 40%. Preséntalos brevemente y pregunta cuál simular.

Confirma la oportunidad con el usuario antes de construir variantes:

"Generaré variantes para: [título de la oportunidad]. Los prompts objetivo son: [2–3 prompts de ejemplo]. ¿Coincide con lo que quieres probar?"


Paso 2 — Cargar el contexto de respuestas de LLM

Para la oportunidad seleccionada, obtén las respuestas reales del modelo de IA usando:

  • get_ai_visibility_prompts con el topicId relevante para obtener la lista de prompts
  • get_ai_visibility_prompt_responses para los 5–8 prompts principales con mayor responseCount

Lee cada respuesta cuidadosamente. Esta es la verdad fundamental — es exactamente lo que los modelos de IA dicen actualmente cuando se les hacen preguntas en este espacio. Tus variantes se puntuarán contra este contexto.

Extrae de las respuestas:

  • ¿Qué lenguaje y marco usan los modelos de IA? (vocabulario, formato de pregunta, términos clave)
  • ¿Qué afirmaciones hacen? (estadísticas, capacidades de producto, herramientas nombradas)
  • ¿Qué falta o es débil? (áreas donde la respuesta de IA es vaga, ambigua o cita fuentes débiles)
  • ¿Qué marcas aparecen en las respuestas? (competidores que están siendo citados y no deberían)
  • ¿Qué formato usan las respuestas? (listas con viñetas, prosa, tablas — tu contenido debe coincidir)

Este contexto es la rúbrica de puntuación para las variantes que construirás.

También llama a get_ai_visibility_sentiment para entender el tono: ¿el sentimiento de la IA hacia la marca es positivo, neutral o negativo en este tema? Las variantes deben diseñarse para reforzar el sentimiento positivo o contrarrestar el marco negativo.


Paso 3 — Generar 2–3 variantes

Construye 2–3 variantes distintas del contenido. Cada variante debe tener un enfoque o estructura significativamente diferente — no solo el mismo contenido con diferentes introducciones. Las pequeñas reescrituras no ayudan a aprender nada; las alternativas genuinas sí.

Ejes de diferenciación de variantes

Elige los ejes más relevantes para la oportunidad:

Enfoque: Educativo ("Cómo funciona X") vs. Competitivo ("Amplitude vs alternativas") vs. Caso de uso ("El mejor X para [segmento específico]")

Apertura: Basada en datos (comenzar con un benchmark o estadística) vs. Basada en problema (comenzar con el punto de dolor) vs. Basada en respuesta (comenzar con la respuesta directa a la pregunta central)

Profundidad: Guía completa (formato largo, cubre todo) vs. Precisa y específica (respuesta enfocada a una pregunta) vs. Interactiva/estructurada (uso intensivo de tablas, matrices de comparación, FAQ)

Marco: Centrado en la marca ("Así es como Amplitude hace X") vs. Neutral de categoría ("Así funciona el análisis de producto — y dónde encaja Amplitude") vs. Competitivo ("La guía honesta de herramientas X")

Formato de variante

Para cada variante, escribe:

  1. H1 completo y párrafo de apertura (la parte que los modelos de IA ponderan más)
  2. Esquema de H2 con una descripción de 1–2 oraciones del contenido de cada sección
  3. Una sección completamente escrita — el H2 más importante, escrito por completo
  4. Bloque de FAQ completo — 4–6 preguntas y respuestas usando el lenguaje exacto de los prompts del Paso 2
  5. Campos meta: metaTitle, metaDescription, slug

Etiquétalos claramente: Variante A, Variante B, Variante C.


Paso 4 — Puntuar cada variante contra el contexto de LLM

Ahora evalúa cada variante contra las respuestas reales del modelo de IA del Paso 2. Esta es la simulación. Puntúa cada variante en una escala del 1 al 5 en estas dimensiones:

Alineación con prompts (1–5): ¿El H1, la apertura y el FAQ de la variante coinciden directamente con el lenguaje y formato de pregunta utilizados en los prompts de AI Visibility? Puntúa 5 si la variante refleja el lenguaje del prompt de cerca; puntúa 1 si usa terminología diferente o entierra la respuesta.

Directez de respuesta (1–5): ¿La variante responde la pregunta central en las primeras 2 oraciones? Puntúa 5 si es así; puntúa 3 si la respuesta aparece dentro del párrafo de apertura; puntúa 1 si el lector tiene que desplazarse.

Especificidad (1–5): ¿La variante hace afirmaciones concretas y verificables ("Amplitude captura rage clicks, profundidad de desplazamiento y mapas de calor en sesiones de menos de 100ms") en lugar de genéricas? Puntúa 5 si cada afirmación importante es específica; puntúa 1 si las afirmaciones son mayormente genéricas.

Cobertura de brechas (1–5): ¿La variante cubre las áreas donde las respuestas actuales de la IA son débiles o están ausentes? Puntúa 5 si llena cada brecha identificada; puntúa 1 si repite en gran medida lo que los modelos de IA ya dicen.

Coincidencia de estructura (1–5): ¿El formato de la variante coincide con cómo los modelos de IA ya están presentando este tema? Puntúa 5 si la estructura refleja el formato de respuesta (por ejemplo, si los modelos de IA usan listas con viñetas, la variante las usa prominentemente).

Presenta las puntuaciones como una tabla:

DimensiónVariante AVariante BVariante C
Alineación con prompts453
Directez de respuesta345
Especificidad534
Cobertura de brechas443
Coincidencia de estructura354
Total192119

Indica la recomendación claramente: "La Variante B obtiene la puntuación más alta (21/25). Su bloque de FAQ refleja el lenguaje exacto de los prompts de AI Visibility, y responde la pregunta central en la oración 1. Recomiendo publicar la Variante B."


Paso 5 — Punto de control de simulación de cambios

Antes de enviar al CMS, referencia la función integrada de Simular Cambios de AI Visibility:

"AI Visibility tiene una función 'Simular Cambios' que ejecuta tu contenido contra prompts de modelos de IA en vivo y proyecta la mejora en citas antes de publicar. Aquí tienes qué pegar: [el texto completo de la apertura + bloque de FAQ de la variante ganadora]

Para ejecutarlo: abre AI Visibility → selecciona tu marca → ve a Simular Cambios → pega el contenido → ejecuta la simulación. Esperaré, o envía el borrador ahora y puedes simular en paralelo."

Deja que el usuario decida. Si quiere simular primero, pausa y proporciona el texto exacto para pegar. Si está listo para enviar, procede al Paso 6.

Si la simulación regresa y cambia su opinión sobre qué variante usar, genera la variante revisada por completo antes de enviar.


Paso 6 — Construir el ganador completo

Una vez seleccionada la variante (con o sin resultados de simulación), escribe el artículo completo:

  • H1 completo hasta el CTA final — sin marcadores de posición, sin "[añadir sección aquí]"
  • Todas las secciones H2 del esquema, escritas por completo
  • Bloque de FAQ completo (4–6 preguntas y respuestas)
  • Campos meta: metaTitle, metaDescription, slug
  • Nota de "Última actualización: [mes/año actual]" en los metadatos

También guarda las variantes subcampeonas como un bloque de Markdown al final — etiquétalas claramente como alternativas. Estas se pueden usar para pruebas A/B después del lanzamiento, o adaptarse para diferentes canales.


Paso 7 — Enviar al CMS

Usa lo que descubriste en el Paso 0. Este es un documento nuevo (operación de creación, no actualización) a menos que el usuario especifique que está actualizando una página existente.

Sanity — usa create_documents_from_markdown con la variante ganadora. Establece _type para que coincida con el esquema de blog/artículo. Pregunta si no estás seguro: "¿Cuál es el tipo de documento para artículos en tu esquema de Sanity?" Nunca uses publish_documents sin instrucción explícita.

Contentful — usa create_entry con contentType que coincida con su tipo de artículo. Establece fields.title, fields.slug, fields.body. Deja published: false.

HubSpot — usa create_blog_post con state: DRAFT. Incluye meta descripción y slug.

WordPress — usa wp_create_post con status: draft. Mapea H1 a title, cuerpo a content.

Ghost — usa create_post con status: draft. Incluye slug, title, html o lexical, y meta_description.

Webflow — usa create_cms_item apuntando a la Colección del blog. Mapea campos al esquema de la Colección (pregunta al usuario por los nombres de los campos si no son obvios).

Después de enviar, confirma: "Hecho — [título del artículo] se guardó como borrador en [CMS]. Aquí está el ID/URL: [enlace]. Las variantes subcampeonas están a continuación en Markdown — guárdalas para uso futuro o pruebas A/B."

Siempre genera un respaldo en Markdown de la variante ganadora, más las alternativas subcampeonas, incluso cuando el envío al CMS sea exitoso.


Por qué simular antes de publicar

Cada pieza de contenido es una apuesta. La publicación respaldada por simulación convierte esa apuesta en una elección razonada:

  • La alineación con prompts es el predictor más fuerte de citas. El contenido que refleja el lenguaje exacto que los modelos de IA usan en los prompts será recuperado y citado mucho más confiablemente que el contenido escrito en lenguaje SEO genérico.
  • La directez de respuesta se acumula con el tiempo. La primera oración de una página tiene un peso desproporcionado en la recuperación de IA. Una variante que responde en la oración 1 superará consistentemente a una que tarda tres párrafos en llegar.
  • La cobertura de brechas es la ganancia más rápida en citas. Si las respuestas de IA sobre un tema son débiles o vagas en una subpregunta específica, la primera página que la responda concretamente se convierte en la cita de referencia.
  • Las variantes exponen suposiciones. Escribir 3 versiones del mismo contenido obliga al equipo a articular lo que realmente creen que la audiencia necesita — y la puntuación a menudo los sorprende.

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 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.

Skills relacionados