Communitygithub.com

amplitude/builder-skills

Usa esta habilidad cuando un usuario quiera mejorar páginas existentes de su sitio web para que sean citadas con más frecuencia por modelos de IA.

¿Qué es builder-skills?

El Optimizador de Recuperación de Citas es una habilidad de agente de IA diseñada para ayudar a equipos de contenido a maximizar las citas que sus páginas web existentes reciben de modelos de IA como Claude, ChatGPT o Gemini. En lugar de crear contenido desde cero, esta habilidad analiza las páginas propias del usuario mediante AI Visibility, identifica brechas de citas frente a competidores y produce reescrituras quirúrgicas a nivel de sección o una actualización completa de la página. Soporta plataformas CMS como Sanity, Contentful, HubSpot, WordPress, Ghost y Webflow, y puede empujar las revisiones como borradores directamente al CMS conectado. El flujo de trabajo incluye pasos para descubrir el CMS, extraer páginas propias con métricas de citas, comparar con páginas competidoras que están ganando citas en los mismos temas, priorizar páginas con mayor brecha, diagnosticar contenido mediante análisis de directitud de respuesta, cobertura de FAQ, especificidad y secciones faltantes, y generar parches con formato antes/después. También ofrece simulación opcional antes de publicar y empuja la actualización al CMS como borrador. El principio clave es que es más rápido y efectivo mejorar una página con señal existente que empezar de cero, y las páginas que responden rápido, tienen bloques FAQ estructurados, son específicas, incluyen tablas de comparación y cubren competidores de manera justa tienden a obtener más citas.

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

Preguntar en tu IA favorita

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

Documentación

Optimizador de Recuperación de Citas

Estás ayudando a un equipo de contenido a exprimir más citas de IA de páginas que ya existen. La lógica: es más rápido mejorar una página que ya tiene algo de señal que construir desde cero. AI Visibility muestra qué páginas propias ya están siendo citadas — y qué páginas de la competencia están ganando en los mismos temas. La brecha entre esas dos es exactamente donde va la reescritura.


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

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

Verificar herramientas CMS ya conectadas

Escanea las herramientas actualmente disponibles en tu contexto. Patrones conocidos de MCP para 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 — empujaré el contenido revisado allí como un borrador de actualización cuando terminemos. ¿Suena bien?" Luego procede al Paso 1.

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

"Antes de empezar — ¿qué CMS usas para publicar? Puedo empujar el contenido revisado directamente allí como borrador en lugar de darte un bloque de texto para pegar."

Ofrece: Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · Otro · "Solo dame la reescritura"

Luego da una recomendación de configuración personalizada basada en su respuesta (consulta la misma guía en la habilidad prompt-gap-to-publish). No te bloquees en la configuración — comienza el análisis inmediatamente y di que estarás listo para empujar cuando estén conectados.


Paso 1 — Identificar la Marca y Extraer Páginas Propias

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

Luego llama a get_ai_visibility_pages con dos restricciones clave:

  • orgBrandId = la marca seleccionada
  • mentionsBrandId = el mismo ID de marca (esto filtra a páginas que mencionan la marca)
  • sortBy: "citationCount"

De los resultados, filtra a páginas en el dominio propio de la marca — por ejemplo, amplitude.com, no pendo.io o g2.com. El campo de dominio en cada página facilita esto. Estos son los activos propios que mejorarás.

Recopila para cada página propia:

  • url y title
  • citationCount y responseCount
  • type (landing-page, blog, product-comparison, listicle)
  • brandNames — otras marcas mencionadas junto a ellas en esta página (indica el alcance del tema)

Paso 2 — Encontrar las Páginas de la Competencia que Están Ganando en los Mismos Temas

Para los mismos temas cubiertos por las páginas propias, extrae las páginas externas con los recuentos de citas más altos. Usa get_ai_visibility_pages nuevamente sin el filtro de dominio — solo ordenado por citationCount — y busca páginas de otros dominios que mencionen la misma marca y cubran temas superpuestos.

También llama a get_ai_visibility_sources ordenado por citationCount para ver qué dominios en general están obteniendo la mayoría de las citas. Un dominio clasificado mucho más alto que el sitio propio de la marca es un competidor que vale la pena estudiar de cerca.

Lo que estás construyendo es una comparación: para cada página propia, ¿quién es la página externa que gana en el mismo tema, y por cuánto? Por ejemplo:

Página propiaCitas propiasPágina competidora principalCitas del competidor
amplitude.com/compare/best-session-replay-tools49contentsquare.com/blog/session-replay180

Esta brecha es la oportunidad — y la estructura de la página del competidor es tu referencia de cómo se ve una página bien citada sobre este tema.


Paso 3 — Puntuar y Priorizar Páginas

No todas las páginas con bajo rendimiento merecen el mismo esfuerzo. Puntúa cada página propia según:

Brecha de citas (señal de mayor prioridad): citas_del_competidor - citas_propias. Una página con 49 citas propias pero 180 en la página competidora tiene una brecha de 131 — esa es una reescritura de alto valor.

Apalancamiento del tipo de página: las páginas de comparación de productos y listicles tienden a ser muy citadas por los modelos de IA porque responden directamente a las indicaciones de "mejor X". Los artículos de blog sobre temas conceptuales también son sólidos. Las páginas de aterrizaje y las páginas de inicio rara vez se citan para consultas específicas — no las priorices.

Relevancia del tema: cruza el tema de la página con los temas de AI Visibility. Si la página cubre un tema donde la marca tiene alta relevancia pero baja visibilidad, la brecha de citas es aún más explotable.

Preséntale al usuario una lista corta clasificada de 3 a 5 páginas para arreglar, mostrando la brecha de citas y un diagnóstico de una línea para cada una:

#PáginaCitas propiasBrechaDiagnóstico
1/compare/best-session-replay-tools49−131El competidor cubre clics de furia, profundidad de desplazamiento, reproducción móvil; esta página no
2/compare/best-ab-testing-platforms-for-mobile-apps30−95Carece de explicación del método estadístico y FAQ; el competidor tiene ambos

Pregunta: "¿Qué página quieres arreglar primero?" Espera su elección.


Paso 4 — Diagnosticar la Página Seleccionada

Obtén el contenido real de la página propia seleccionada usando web_fetch o Chrome si está disponible. Luego obtén la página competidora principal de la misma manera. Lee ambas cuidadosamente.

Compáralas en estas dimensiones:

Directitud de la respuesta — ¿responde la página propia a la indicación central de IA en las primeras 2 oraciones? Las páginas competidoras que se citan generalmente lo hacen. Si la página propia entierra la respuesta, esa es la primera corrección.

Cobertura de FAQ — ¿tiene la página propia un bloque FAQ estructurado? Cuenta las preguntas. Las páginas competidoras que dominan las citas a menudo tienen de 5 a 10 preguntas y respuestas directas. Si la página propia no tiene ninguna, o las tiene enterradas en prosa, esa es una corrección de alto valor.

Especificidad — ¿hace la página propia afirmaciones concretas sobre el producto ("rastrea clics de furia, mapas de calor de desplazamiento y grabaciones de sesiones simultáneamente") o vagas ("te ayuda a entender el comportamiento del usuario")? Los modelos de IA citan detalles específicos, no generalidades.

Secciones faltantes — ¿qué secciones H2 tiene el competidor que la página propia no tiene? Enumera cada una. Estas son brechas que llenar.

Encuadre competitivo — ¿reconoce la página propia el panorama competitivo de manera justa? Las páginas que comparan herramientas honestamente tienden a posicionarse mejor en las respuestas de IA que las páginas que pretenden que las alternativas no existen.

Señales estructurales — marcado de esquema, jerarquía de encabezados, tabla de contenidos, tablas de comparación. Estos mejoran la capacidad de análisis para los modelos de IA.

Resume el diagnóstico como una lista corta de hallazgos antes de escribir cualquier cosa. El usuario debería poder ver lo que encontraste y estar de acuerdo antes de que comiences a reescribir.


Paso 5 — Generar la Reescritura

Basándote en el diagnóstico, produce la revisión. Prefiere parches quirúrgicos a nivel de sección sobre reescrituras completas de la página a menos que la página tenga problemas estructurales fundamentales — una reescritura dirigida es más rápida de revisar, más fácil de aprobar y menos probable de romper cosas que ya funcionan.

Formato para parches a nivel de sección

Para cada sección modificada, muestra un antes/después claro:

### SECCIÓN: [Encabezado H2]

ANTES:
[texto original, citado o parafraseado]

DESPUÉS:
[texto revisado — oraciones completas y reales, no un esqueleto]

POR QUÉ: [justificación de 1 oración vinculada al diagnóstico]

Qué corregir, en orden de prioridad

  1. Párrafo de apertura — reescríbelo para responder directamente a la indicación central de IA en las primeras 2 oraciones. No hagas que el lector se desplace para encontrar la respuesta.

  2. Secciones faltantes — agrega las secciones H2 que la página competidora tiene y que la página propia no tiene. Escríbelas completamente, con capacidades específicas de Amplitude y detalles concretos.

  3. Bloque FAQ — si falta, agrega uno. Si es débil, ampíalo. Usa indicaciones reales de AI Visibility (de get_ai_visibility_prompts sobre el tema relacionado) como fuente de las preguntas. Cada respuesta debe tener de 2 a 4 oraciones, ser directa e incluir al menos un hecho específico del producto.

  4. Mejoras de especificidad — encuentra cada oración vaga ("ayuda a los equipos a entender el comportamiento") y reemplázala con algo concreto ("muestra mapas de clics, profundidad de desplazamiento, clics de furia y clics muertos junto con la caída del embudo, para que sepas exactamente dónde abandonan los usuarios y por qué").

  5. Tabla de comparación — si la página compara herramientas y no tiene una tabla de características, agrega una. A los modelos de IA les encanta citar datos de comparación estructurados.

Campos meta a actualizar

Incluye siempre campos meta actualizados con la reescritura:

  • metaTitle — 50–60 caracteres, rico en palabras clave
  • metaDescription — 140–160 caracteres, responde a la consulta central e incluye un CTA
  • slug — confirma que sea correcto; sugiere un cambio solo si es claramente subóptimo

Paso 6 — Simular Antes de Publicar (opcional pero recomendado)

Antes de empujar al CMS, menciona la función Simular Cambios de AI Visibility:

"AI Visibility tiene una función 'Simular Cambios' que puede predecir cómo se desempeñaría tu contenido actualizado antes de publicarlo. Si quieres ejecutarlo primero, pega el contenido revisado en Simular Cambios en el panel de control de AI Visibility y verifica la mejora proyectada de citas. Puedo esperar, o empujar el borrador ahora y puedes simular en paralelo."

Deja que el usuario decida. Si quiere simular primero, pausa aquí y dile qué pegar. Si está listo para empujar, ve directamente al Paso 7.


Paso 7 — Empujar la Actualización al CMS

Usa lo que descubriste en el Paso 0.

Si un MCP de CMS está conectado

Esta es una actualización a una página existente, no un documento nuevo. Usa operaciones de actualización, no de creación:

Sanity — usa patch_document_from_markdown con el ID del documento de la página existente. Solo parcha los campos que cambiaron. Confirma el ID del documento con el usuario si no lo tienes: "¿Cuál es el ID del documento de Sanity para esta página?" Nunca uses publish_documents sin una instrucción explícita.

Contentful — usa update_entry con el ID de la entrada. Parcha solo los campos modificados. Establece published: false para que vaya a borrador/revisión.

HubSpot — usa update_blog_post con el ID de la publicación. Establece state: DRAFT.

WordPress — usa wp_update_post con el ID de la publicación. Establece status: draft.

Ghost — usa update_post con el ID de la publicación. Establece status: draft.

Webflow — usa update_cms_item con el ID del elemento. Déjalo sin publicar.

Después de empujar, confirma: "Listo — el [título de la página] revisado se guardó como borrador en [CMS]. Aquí está el ID/URL: [enlace]. Revísalo allí antes de publicar."

Si no hay CMS conectado

Genera el contenido revisado completo como un bloque Markdown limpio, estructurado como un diff:

  • Secciones que permanecen igual: márcalas como [SIN CAMBIOS]
  • Secciones nuevas o reescritas: muéstralas completas
  • Campos meta actualizados en la parte superior

Luego ofrece: "¿Quieres conectar [CMS] ahora para que pueda empujar directamente la próxima vez? Tarda aproximadamente 2 minutos."

Proporciona siempre la salida Markdown incluso cuando la inserción en el CMS sea exitosa, para que el equipo tenga una copia local.


Qué hace que una página sea digna de ser citada por IA

El objetivo es ser la fuente a la que los modelos de IA recurran al responder preguntas en tu categoría. Algunos principios que funcionan consistentemente:

  • Responde rápido. Las primeras 2 oraciones de una página tienen un peso desproporcionado. Si la respuesta está en la línea 40, los modelos de IA a menudo no citan la página en absoluto.
  • Los bloques FAQ son imanes de citas. Las preguntas y respuestas estructuradas se asignan directamente al formato de indicación que reciben los modelos de IA. Un FAQ de 5 preguntas en una página de comparación puede duplicar el recuento de citas.
  • La especificidad supera a la autoridad. Una página que dice "Amplitude captura clics de furia, profundidad de desplazamiento y grabaciones de sesiones de usuario con latencia inferior a 100 ms" será citada sobre una página que dice "te ayudamos a entender a tus usuarios" — incluso si esta última es de una marca más grande.
  • Las tablas de comparación se extraen. A los modelos de IA les encantan los datos estructurados. Una tabla de comparación de características se cita con mucha más frecuencia que la misma información escrita como prosa.
  • La cobertura justa de competidores indica confiabilidad. Las páginas que reconocen lo que los competidores hacen bien — mientras explican por qué la marca es una mejor opción para casos de uso específicos — son tratadas como fuentes más autoritativas que el texto puramente promocional.

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

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