Communitygithub.com

amplitude/builder-skills

Habilidades de construcción para el equipo de producto de Amplitude, que proporcionan plantillas estructuradas para redactar declaraciones de problemas, diseñar soluciones y definir criterios de aceptación claros.

¿Qué es builder-skills?

amplitude/builder-skills es un conjunto de plantillas y pautas diseñadas para equipos de producto en Amplitude, con el objetivo de estandarizar la redacción de especificaciones de funciones. La habilidad guía a los usuarios a través de tres pasos clave: primero, redactar una declaración de problema concisa y accionable que comunique la motivación del cliente y el impacto comercial. Segundo, explorar el espacio de soluciones considerando palancas estratégicas como economías de escala, efectos de red y costos de cambio, y diseñar una experiencia de usuario simple y encantadora inspirada en principios de diseño como la simplificación radical y el cuidado por los detalles. Tercero, definir criterios de aceptación exhaustivos y mutuamente excluyentes (MECE) que cubren funcionalidades, casos límite y límites del alcance. El marco es compatible con cualquier plataforma de documentación de producto (como Notion, Linear o GitHub Issues) y está diseñado para que equipos multifuncionales colaboren eficazmente, asegurando que cada función se construya con una comprensión compartida y validable.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/product-skills/skills/draft-spec

Preguntar en tu IA favorita

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

Documentación

Actualizado: @fecha de hoy en MM/DD/AA

Contexto del Problema

Escribe un párrafo de declaración de problema accionable pero conciso detrás del problema y su motivación subyacente, articulando claramente los problemas centrales que esta incidencia pretende resolver o las oportunidades que se desbloquean al construir esta función. ¿Cuál es la declaración de marketing para esta función? ¿Por qué la estamos construyendo ahora? ¿Por qué merecemos ganar con esta función? Esta declaración de problema debe ser detallada y accionable para que pueda sostenerse por sí sola sin contexto adicional y aun así transmitir TODOS los puntos clave, pero debe limitarse a un MÁXIMO de 3 oraciones concisas. Comienza con la persona de cliente más relevante que realiza la solicitud (ej.: "Los dueños de negocios necesitan...") pero NUNCA uses nombres exactos de personas o empresas en el párrafo de visión general.

Diseño de la Solución

Explora el espacio de soluciones antes de comprometerte con una dirección. Considera múltiples soluciones candidatas y evalúalas desde lentes estratégicos y de experiencia.

Identifica cuáles de estas palancas estratégicas importan más para esta solución y profundiza en ellas:

  • Prioriza funciones que maximicen las ventajas de costo a través de economías de escala, reduciendo el costo por unidad a medida que la adopción de usuarios o el volumen operativo aumenta.
  • Selecciona funciones que amplifiquen los efectos de red, aumentando el valor para los usuarios a medida que crece el número de participantes.
  • Favorece funciones que creen oportunidades de contrapocisionamiento, introduciendo capacidades o experiencias que los competidores no puedan replicar fácilmente sin una disrupción significativa en su propia estrategia.
  • Enfatiza funciones que mejoren los costos de cambio del cliente, haciendo que sea más difícil o menos atractivo para los usuarios abandonar el ecosistema.
  • Concéntrate en funciones que fortalezcan la marca, reforzando su identidad única y construyendo conexiones emocionales duraderas con los usuarios.
  • Aprovecha funciones que capitalicen recursos acorralados, como datos propietarios, asociaciones exclusivas o capacidades únicas a las que los competidores no puedan acceder o imitar fácilmente.
  • Implementa funciones que demuestren procesos superiores o flujos de trabajo propietarios, creando una ventaja operativa sostenible sobre los competidores.

Al diseñar una experiencia de usuario simple y encantadora, intenta emplear algunos de estos principios al diseñar el flujo de usuario:

  • Simplifica sin piedad: elimina pasos o funciones innecesarios para ofrecer una experiencia intuitiva y minimalista. Cada elemento debe ganarse su lugar.

  • Mantén una continuidad perfecta: guía a los usuarios de forma natural desde el inicio hasta el final con una carga cognitiva mínima y sin callejones sin salida.

  • Preocúpate por los detalles: la tipografía, las transiciones, el espaciado y el copy deben reflejar una artesanía meticulosa. Equilibra funcionalidad y belleza en una sensación de marca unificada y consistente en cada punto de contacto.

  • Delicia con toques reflexivos: agrega pequeños pero memorables detalles que eleven la experiencia más allá de lo funcional.

  • Cuando no esté claro cómo diseñar un componente SaaS, copia a Linear sobre cómo debería funcionar un diseño o componente.

No menciones explícitamente estos principios al hablar sobre la solución; simplemente incorpóralos en tu razonamiento al explorar, decidir y explicar la mejor solución.

Después de explorar el espacio de soluciones e identificar la mejor estrategia, proporciona un recorrido conciso de lo que hace la función, cómo resuelve los puntos débiles del usuario y cómo lo deleita, escrito de manera ajustada, sin preámbulos innecesarios.

  • Recorre con detalle muy específico la forma deseada en que los usuarios interactúan y experimentan el producto. Concéntrate en el diseño de la interfaz, cada paso del recorrido del usuario y cómo mejorar la usabilidad y simplicidad general de la solución.
  • Presenta la narrativa de uso en la vida real que esperamos que ocurra como resultado del lanzamiento de esta función.
  • Ancla esto a un usuario real en un momento real. Ejemplo: "Cuando Frank visitaba diferentes startups en San Francisco, usa [función X] para registrar quejas y hacer seguimiento de requisitos en [función Y] a medida que los conoce..."
  • Enfatiza tácticas únicas que podamos emplear o aspectos que diferencien esta solución de las alternativas en el mercado y contrapongan nuestro producto frente a los competidores.

Recuerda: las mejores soluciones maximizan ICE: impacto, confianza y esfuerzo. Cuanto mayor sea el impacto, mayor la confianza y menor el esfuerzo, mejor la solución.

Divide el recorrido de la solución en párrafos enfocados y concisos separados por saltos de línea: un aspecto de la experiencia por párrafo.

Criterios de Aceptación

Cada criterio debe describir una condición específica y comprobable con un resultado esperado claro. Los criterios describen resultados deseados, no decisiones de implementación. Los criterios deben ser MECE (mutuamente excluyentes y colectivamente exhaustivos), cubriendo todas las condiciones necesarias para que el trabajo esté completo.

Funcionales:

  • [Comportamiento observable del usuario → respuesta o resultado esperado del sistema]

Casos límite y manejo de errores:

  • [Qué sucede cuando la entrada no es válida, un servicio falla, faltan datos o el usuario llega a un estado inesperado]

Fuera del alcance:

  • [Qué NO incluye explícitamente este trabajo: establece límites claros para evitar la sobreconstrucción]

<ejemplos de criterios de aceptación sólidos>

  • Cuando un usuario escribe en la barra de búsqueda, los resultados se actualizan en vivo después de un debounce de 300 ms, mostrando el nombre del producto, la imagen y el precio en una lista clasificada.
  • Los usuarios pueden navegar a Configuración > Editar Perfil y actualizar su nombre, apellido, correo electrónico y número de teléfono. Los cambios persisten inmediatamente al guardar y se reflejan en toda la aplicación sin necesidad de recargar.
  • Si la solicitud de guardado falla (tiempo de espera o error 5xx), muestra un error en línea: "Algo salió mal. Por favor, inténtalo de nuevo." El formulario conserva la entrada no guardada del usuario.
  • Enviar una consulta de búsqueda vacía devuelve la lista de resultados predeterminada, no un error o un estado vacío.
  • Esto NO incluye edición de perfiles por lotes, exportación CSV ni cambios de permisos a nivel de administrador. </ejemplos de criterios de aceptación sólidos>

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.

Skills relacionados