product-marketing-context

Visión general de la skill product-marketing-context

Qué hace product-marketing-context

La skill product-marketing-context te ayuda a crear y mantener un archivo fuente compartido de marketing de producto en .agents/product-marketing-context.md. Su función es sencilla pero muy útil: capturar una sola vez la visión general del producto, la audiencia, el posicionamiento, las objeciones, las pruebas y los fundamentos del mensaje para que otros flujos de marketing puedan reutilizarlos, en lugar de volver a hacer las mismas preguntas básicas cada vez.

Quién debería usar esta skill

Es una muy buena opción para founders, especialistas de product marketing, responsables de growth y agencias que necesitan trabajo de marketing asistido por IA de forma repetible dentro de un repo o proyecto de cliente. Resulta especialmente útil si buscas más consistencia en tareas de messaging como posicionamiento, trabajo de ICP, borradores de landing pages, planificación de campañas o contenidos de sales enablement.

El trabajo real que resuelve

La mayoría de los equipos no necesitan “más copy”. Necesitan una capa de contexto estable que el modelo pueda consultar antes de escribir nada. La product-marketing-context skill está pensada para ese paso de preparación. Primero crea un documento reutilizable de contexto de marketing y, a partir de ahí, otras skills pueden construir encima.

Por qué esto es mejor que un prompt genérico

Un prompt normal puede pedir posicionamiento, pero normalmente produce una respuesta aislada. product-marketing-context está estructurada en torno a:

• comprobar primero si ya existe un archivo de contexto
• actualizar solo las secciones que cambiaron
• ofrecer un auto-draft a partir del codebase o un flujo guiado para empezar desde cero
• guardar el resultado en una ruta de archivo predecible que otras skills puedan consultar

Eso la hace más operativa que un prompt genérico del tipo “ayúdame con el messaging”.

Casos ideales y casos en los que encaja peor

Encaja especialmente bien en:

• productos nuevos que todavía no tienen una base de messaging
• repos donde se van a usar varias skills de marketing con IA
• equipos que actualizan el posicionamiento tras un lanzamiento, un cambio de pricing o un cambio de audiencia

Encaja peor en:

• tareas puntuales de copy donde no quieres mantener contexto persistente
• productos sin repo accesible ni materiales de producto que se puedan inspeccionar
• equipos que esperan investigación de mercado profunda solo con la skill

Cómo usar la skill product-marketing-context

Contexto de instalación y ubicación del archivo

Si tu entorno admite instalación de Skills, añade el repositorio padre y usa desde ahí la skill product-marketing-context. El archivo de salida alrededor del cual está diseñada esta skill es:

/.agents/product-marketing-context.md

La skill también revisa .claude/product-marketing-context.md en configuraciones antiguas y puede ayudarte a migrar ese contenido.

Empieza comprobando si ya existe un archivo de contexto

Antes de crear nada nuevo, el flujo previsto es buscar:

• .agents/product-marketing-context.md
• .claude/product-marketing-context.md

Si ya existe un archivo de contexto, lo correcto no es “reescribirlo todo”. Léelo, resume lo que ya está recogido y actualiza solo las secciones afectadas por los cambios del usuario.

Elige la ruta de configuración adecuada

El repositorio muestra dos rutas prácticas de entrada:

1. Auto-draft from codebase
   Recomendado cuando el repo tiene señales útiles como README.md, copy de la landing page, docs, package.json o copy del producto dentro de la app.

2. Start from scratch
   Mejor cuando el repo tiene poca información, cuando los materiales privados importan más que el código o cuando el producto todavía se está definiendo.

Este es uno de los detalles de adopción más importantes en la product-marketing-context guide: obtendrás mejores resultados si eliges la ruta que encaja con la calidad de la evidencia disponible.

Qué información necesita product-marketing-context

Para obtener un resultado útil, aporta al menos:

• qué es el producto
• para quién es
• cuál es el principal problema que resuelve
• en qué se diferencia de las alternativas
• cualquier prueba o limitación actual
• si se trata de un primer borrador o de una actualización

Información adicional útil:

• cambios en niveles de pricing
• nuevas personas
• patrones de win/loss
• lenguaje de clientes sacado de llamadas o reseñas
• preferencias de brand voice
• objeciones de ventas
• objetivos del lanzamiento o del trimestre

Las secciones que esta skill intenta construir

Según los evals del repositorio y el workflow, es razonable esperar que el flujo de product-marketing-context usage cubra secciones como:

• Product Overview
• Target Audience
• Personas
• Problems You Solve
• Competitive Landscape
• Differentiation
• Objections
• Switching Dynamics
• Customer Language
• Brand Voice
• Proof Points
• Goals

Esa estructura importa porque crea un archivo de contexto duradero, no solo un párrafo de posicionamiento.

Convierte una petición imprecisa en un prompt sólido

Débil:

Help me with product marketing.

Mejor:

Use the product-marketing-context skill. Check whether .agents/product-marketing-context.md already exists. If not, auto-draft a V1 from the repo and website copy. Capture product overview, ICP, personas, key pain points, differentiation, objections, proof points, customer language, and brand voice. Flag assumptions clearly so I can review them.

Mejor para actualizaciones:

Use the product-marketing-context skill to update our existing context. We added an enterprise tier and now sell to VP of Engineering in addition to Product Managers. Read .agents/product-marketing-context.md, tell me which sections need revision, then update only those sections and preserve everything still valid.

Un workflow práctico que reduce las suposiciones

Una buena secuencia de trabajo es:

1. Comprobar si ya existe un archivo de contexto.
2. Decidir entre auto-draft o entrevista guiada.
3. Construir o actualizar el archivo de contexto sección por sección.
4. Marcar supuestos y evidencia faltante.
5. Revisarlo con el usuario para corregirlo.
6. Guardarlo en .agents/product-marketing-context.md.
7. Reutilizar ese archivo en tareas de marketing posteriores.

Esta es la razón principal para hacer una product-marketing-context install al principio de un proyecto: reduce el trabajo repetido de configuración más adelante.

Lee primero estos archivos del repositorio

Para una evaluación rápida, empieza por:

• skills/product-marketing-context/SKILL.md
• skills/product-marketing-context/evals/evals.json

SKILL.md explica el workflow operativo. evals/evals.json resulta útil porque muestra cómo es un “uso correcto” en prompts realistas, incluidas actualizaciones después de cambios en el producto.

Qué mejora de verdad la calidad del resultado

Los mejores resultados salen de la evidencia, no de la aspiración. Si quieres un documento de contexto más sólido, orienta la skill hacia:

• copy de homepage o landing page
• documentación de producto y textos de onboarding
• notas de transcripciones de demos
• descripciones de pricing y planes
• citas de entrevistas con clientes
• comparativas reales con competidores que ya usáis
• objeciones de sales calls
• guías de marca existentes

Sin eso, el borrador puede seguir siendo útil, pero contendrá más supuestos genéricos.

Qué esperar del primer borrador

Una V1 creada con product-marketing-context debe tratarse como un documento de trabajo, no como una verdad definitiva. El borrador más útil:

• separa los hechos confirmados del posicionamiento inferido
• deja visibles las carencias en proof points o claridad de audiencia
• ofrece suficiente estructura para que las tareas posteriores de marketing con IA mantengan la consistencia

Si buscas messaging estratégico pulido, cuenta con al menos una ronda de revisión después de crear el archivo inicial.

Preguntas frecuentes sobre la skill product-marketing-context

¿product-marketing-context es buena para principiantes?

Sí. Es apta para principiantes porque el workflow es explícito: comprobar si ya existe un archivo, elegir entre auto-draft o configuración guiada y completar secciones concretas. No necesitas dominar frameworks formales de PMM para obtener una primera versión útil.

¿Cuándo debería usar product-marketing-context en lugar de un prompt normal?

Úsala cuando quieras contexto reutilizable para varias tareas. Si tu objetivo es un único titular para una landing page, un prompt normal puede bastar. Si tu objetivo es mantener un messaging consistente en muchas salidas, product-marketing-context for Product Marketing es una base mejor.

¿Puede actualizar un contexto existente en lugar de recrearlo?

Sí. Ese es uno de sus comportamientos centrales. La skill está diseñada para leer un .agents/product-marketing-context.md existente, resumir lo que ya contiene y revisar solo las secciones afectadas por la nueva información.

¿Hace investigación de mercado por mí?

No exactamente. Puede inferir bastante a partir del repo y de los materiales del producto, pero no sustituye la investigación con clientes. Si la evidencia es débil, el resultado será útil en lo estructural, pero más flojo en lo estratégico.

¿Qué pasa si mi repo tiene muy poco copy de marketing?

Usa la ruta start-from-scratch y responde a las preguntas de forma conversacional. Suele ser mejor que forzar un auto-draft sobre codebases escasos que revelan poco sobre clientes, objeciones o contexto de compra.

¿product-marketing-context solo es útil dentro de este ecosistema de repos?

Aporta más valor cuando se usa junto con otras skills de marketing que consultan .agents/product-marketing-context.md, pero el archivo en sí es portable. También puedes usarlo como tu brief canónico de PMM incluso fuera del ecosistema completo de skills.

¿Cuándo encaja mal esta skill?

Es mejor omitirla si:

• solo necesitas una salida de copy aislada
• tu equipo no va a mantener un archivo de contexto compartido
• tu producto todavía está demasiado poco definido como para responder preguntas básicas sobre audiencia y problema

Cómo mejorar la skill product-marketing-context

Da a la skill evidencia, no solo objetivos

La mayor mejora en la calidad de la product-marketing-context skill viene de mejores materiales de origen. “Queremos un posicionamiento más fuerte” no basta. Proporciona inputs en bruto como:

• texto de la homepage
• notas de llamadas con clientes
• principales objeciones del equipo de ventas
• motivos por los que los clientes cambian
• explicaciones de feature-to-benefit
• proof points con números

Eso permite que el modelo ancle sus afirmaciones en algo real en vez de inventarlas.

Sé explícito sobre qué cambió

Para actualizaciones, no pidas una revisión general si solo han cambiado dos cosas. Di exactamente qué hay de nuevo:

• nuevo nivel de pricing
• ICP ampliado
• categoría renombrada
• foco más fuerte en enterprise
• nueva presión competitiva

Esto ayuda a la skill a actualizar las secciones correctas sin debilitar por accidente mensajes que siguen siendo válidos.

Pide que los supuestos se etiqueten

Un fallo habitual es que haya conjeturas ocultas. Para mejorar la calidad del resultado, pide al modelo que marque:

• hechos confirmados
• inferencias probables
• inputs faltantes
• preguntas para revisión

Eso hace que el primer borrador sea mucho más fácil de aprobar y refinar.

Usa una revisión por secciones para obtener un mejor resultado final

No revises todo el documento solo al final. Las secciones de mayor valor para validar al principio son:

• Target Audience
• Problems You Solve
• Differentiation
• Objections
• Proof Points

Si esas partes están mal, el messaging posterior que se construya sobre el archivo también se desviará.

Refuerza la captura de customer language

Un punto débil frecuente es el lenguaje genérico. Para mejorar en la práctica la product-marketing-context guide, aliméntala con frases reales que los clientes usan en:

• entrevistas
• tickets de soporte
• sitios de reseñas
• llamadas de ventas
• feedback de onboarding

El lenguaje real del cliente mejora de forma clara la relevancia del copy posterior.

Vigila estos fallos comunes

Los problemas típicos incluyen:

• listas de funcionalidades disfrazadas de posicionamiento
• ICPs demasiado amplios
• diferenciación débil frente a “competidores” vagos
• brand voice aspiracional sin ejemplos
• proof points que son afirmaciones, no evidencia

Si detectas alguno de estos problemas, revisa los inputs de origen antes de pedir una reescritura.

Itera con prompts de seguimiento específicos

Después del primer borrador, usa prompts enfocados como:

• “Narrow the ICP to the most likely first buyer.”
• “Rewrite objections based on enterprise procurement concerns.”
• “Separate direct competitors from status-quo alternatives.”
• “Turn proof points into evidence-backed bullets only.”

La iteración dirigida mejora el documento mucho más rápido que pedir una reescritura completa.

Mantén product-marketing-context como un archivo vivo

La mejor forma de aprovechar product-marketing-context a largo plazo es mantenerlo de forma continua, no tratarlo como una configuración de una sola vez. Vuelve al archivo cuando cambien tu producto, audiencia, pricing, categoría o enfoque comercial. Así mantendrás alineadas con la realidad actual todas las tareas de marketing posteriores, en lugar de trabajar sobre supuestos desactualizados.