product-marketing-context

Descripción general

Qué hace este skill

El skill product-marketing-context te ayuda a crear y mantener un único documento reutilizable de contexto de marketing de producto para tu proyecto.

En lugar de volver a explicar tu producto, audiencia y posicionamiento en cada nueva tarea, este skill te guía por un cuestionario estructurado y guarda el resultado en:

• .agents/product-marketing-context.md

Otros skills y agentes de marketing compatibles leen después este archivo para entender tu producto y así poder generar contenido, campañas y materiales de lanzamiento que mantengan el mensaje alineado.

A quién va dirigido

Usa product-marketing-context si eres:

• Un founder o product owner que está definiendo la historia de su producto por primera vez
• Un product marketer o marketing manager que quiere mensajes coherentes en todas las campañas
• Un developer que está conectando un sistema de skills y agentes de marketing que comparten un archivo de contexto común

Es especialmente útil cuando trabajas en:

• Content marketing continuo (blogs, emails, anuncios, landing pages)
• Lanzamientos de producto y actualizaciones de planes o niveles
• Refinar el posicionamiento o tu ICP / personas

Problemas que resuelve

El skill product-marketing-context está diseñado para resolver estos problemas recurrentes:

• Repetir la misma descripción de producto y detalles de audiencia en múltiples conversaciones
• Mensajes incoherentes entre distintos agentes o skills
• Notas de marketing de producto dispersas o repartidas en muchos archivos
• Documentos de posicionamiento difíciles de mantener que nunca se actualizan

Al centralizar todo en .agents/product-marketing-context.md, obtienes un documento vivo que cubre:

• Descripción general del producto y propuesta de valor
• Audiencia objetivo e ICP
• Personas y roles implicados en el proceso de compra
• Problemas que resuelves y jobs-to-be-done
• Entorno competitivo y diferenciación
• Objeciones, dinámicas de cambio y pruebas de valor
• Lenguaje del cliente, voz de marca y objetivos de marketing

Cuándo encaja bien y cuándo no

Usa product-marketing-context cuando:

• Estás empezando un proyecto nuevo y quieres una base sólida antes de usar otros skills de marketing
• Has cambiado precios, planes o audiencia (por ejemplo, añadiendo un plan enterprise o nuevos roles de comprador)
• Estás configurando un flujo de trabajo de marketing basado en IA que necesita un contexto compartido

Puede no ser la mejor opción cuando:

• Solo necesitas una pieza de copy puntual y no piensas reutilizar el contexto
• Tu producto está en una fase extremadamente temprana y aún no tienes nada claro (quizá quieras esbozar lo básico primero y luego ejecutar este skill)

Si tienes previsto hacer más de una tarea de marketing, instalar primero product-marketing-context suele compensar rápidamente.

Cómo usarlo

Instalación

Para añadir el skill product-marketing-context a tu entorno, ejecuta:

npx skills add https://github.com/coreyhaines31/marketingskills --skill product-marketing-context
``

Esto descarga el skill `product-marketing-context` desde el repositorio `coreyhaines31/marketingskills` y lo deja disponible junto con cualquier otro skill que instales desde la misma fuente.

Después de la instalación, puedes abrir los archivos del skill directamente en tu editor para revisar cómo funciona y adaptar tus flujos de trabajo según necesites:

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

### Flujo de trabajo principal
El skill product-marketing-context sigue un flujo claro con dos caminos, en función de si ya existe o no un archivo de contexto.

#### 1. Comprobar si ya existe un contexto
Cuando se invoca, el skill busca primero un documento de contexto existente:

- Ubicación principal: `.agents/product-marketing-context.md`
- Ubicación heredada: `.claude/product-marketing-context.md` (para configuraciones antiguas)

Si solo existe un archivo antiguo bajo `.claude/`, el skill está diseñado para ofrecer moverlo o actualizarlo a `.agents/` para mantener una configuración coherente.

#### 2. Si el archivo de contexto existe
Si `.agents/product-marketing-context.md` ya está presente, el skill:

1. Lee y resume el contenido actual
2. Pregunta qué secciones quieres actualizar (por ejemplo, Target Audience, Personas o Differentiation)
3. Solo te guía por las secciones seleccionadas, para que no tengas que repetirlo todo

Esto facilita hacer actualizaciones incrementales, como por ejemplo:

- Ampliar tu audiencia objetivo (por ejemplo, ahora incluyendo VP of Engineering)
- Añadir un nuevo plan o nivel (por ejemplo, un plan enterprise)
- Actualizar pruebas de valor, logos o casos de éxito

#### 3. Si el archivo de contexto no existe
Si no se encuentra ningún archivo de contexto, el skill ofrece dos caminos:

1. **Auto-draft from codebase (recomendado)**
   - El skill inspecciona tu repositorio (por ejemplo: `README`, landing pages, textos de marketing, `package.json`, etc.)
   - Redacta una primera versión de tu contexto de marketing de producto en función de lo que encuentra
   - Tú revisas, corriges y amplías este borrador V1

2. **Start from scratch**
   - El skill te guía por cada sección una a una de forma conversacional
   - Respondes a preguntas específicas sobre tu producto, audiencia y posicionamiento

En ambos casos, una vez completado el proceso, el skill escribe el documento final en:

- `.agents/product-marketing-context.md`

### Secciones que se capturan en el archivo de contexto
El archivo de contexto creado por product-marketing-context se estructura en torno a secciones prácticas y reutilizables. Según las evaluaciones incluidas, se espera que el skill cubra al menos las siguientes áreas cuando sean relevantes:

- **Product Overview** – Qué vendes, qué hace y para quién es
- **Target Audience** – Tu ICP, roles, sectores y tamaños de empresa
- **Personas** – Stakeholders clave como Product Managers, VPs, founders o compradores
- **Problems You Solve** – Puntos de dolor, jobs-to-be-done y casos de uso
- **Competitive Landscape** – Contra quién compites y cómo ven los compradores las alternativas
- **Differentiation** – Qué hace que tu producto sea significativamente diferente
- **Objections** – Motivos habituales por los que los prospectos dudan o dicen que no
- **Switching Dynamics** – Qué tiene que suceder para que alguien cambie a tu solución
- **Customer Language** – Frases, citas y vocabulario que tus clientes realmente usan
- **Brand Voice** – Cómo quieres sonar en todos tus canales
- **Proof Points** – Testimonios, métricas, social proof y casos de éxito
- **Goals** – Qué aspecto tiene el éxito para tu marketing y tu go-to-market

No es obligatorio rellenar todas las secciones para todos los productos, pero el skill está diseñado para cubrir todas las que apliquen y avisarte cuando falte información.

### Uso del contexto en tus flujos de trabajo
Una vez que `.agents/product-marketing-context.md` existe, puedes:

- Referenciarlo al ejecutar otros **skills relacionados con marketing** para que compartan el mismo entendimiento de tu producto
- Mantenerlo bajo control de versiones en tu repositorio para seguir cómo evoluciona tu posicionamiento
- Usarlo como fuente interna de verdad para nuevas personas del equipo o colaboradores

Como el archivo vive en una ruta predecible, es fácil para:

- Otros agentes de la colección `marketingskills`
- Herramientas o scripts personalizados que tú desarrolles

…cargarlo y trabajar sobre una base de marketing de producto consistente.

### Archivos y directorios que conviene revisar
Para entender mejor el skill o personalizarlo, empieza por:

- `SKILL.md` – Definición principal del skill, descripción y detalles del flujo de trabajo
- `evals/evals.json` – Prompts de ejemplo y comportamiento esperado, útil para ver cómo debería responder el skill en escenarios reales

Puedes adaptar el comportamiento del skill (por ejemplo, cómo lo llamas o cómo lo encadenas con otros) para ajustarlo a la estructura de tu propio repositorio y a tus herramientas de automatización.

## FAQ

### ¿Qué es product-marketing-context en términos simples?
El skill product-marketing-context es un asistente guiado que te ayuda a crear un documento estructurado de marketing de producto —almacenado en `.agents/product-marketing-context.md`— que cubre tu producto, audiencia, posicionamiento y mensajes clave, de modo que otros skills y agentes puedan reutilizarlo.

### ¿Cómo instalo product-marketing-context?
Instálalo desde el repositorio `coreyhaines31/marketingskills` con:

```bash
npx skills add https://github.com/coreyhaines31/marketingskills --skill product-marketing-context

Después de la instalación, puedes ver SKILL.md en el directorio product-marketing-context para conocer el flujo de trabajo exacto.

¿Dónde se guarda el documento de contexto?

De forma predeterminada, el skill crea y mantiene tu contexto de marketing de producto en:

• .agents/product-marketing-context.md

También puede detectar configuraciones antiguas en .claude/product-marketing-context.md y ofrecer migrarlas a .agents/.

¿Qué pasa si ya tengo un archivo product-marketing-context?

Si .agents/product-marketing-context.md ya existe, el skill:

1. Lee y resume el contenido
2. Te pregunta qué secciones quieres cambiar
3. Solo recopila información nueva para esas secciones

Así evitas tener que volver a responder preguntas que ya están documentadas.

¿Puede product-marketing-context actualizar mi contexto cuando cambia mi producto?

Sí. El skill está diseñado para admitir actualizaciones incrementales. Por ejemplo, si:

• Añades un nuevo plan enterprise
• Amplías tu audiencia objetivo a nuevos roles (por ejemplo, añadiendo VP of Engineering)
• Ajustas tu diferenciación o pruebas de valor

…puedes invocar el skill y te ayudará a actualizar solo las secciones relevantes en .agents/product-marketing-context.md.

¿Este skill redacta contenido automáticamente a partir de mi codebase?

Puede hacerlo. Cuando no existe archivo de contexto, product-marketing-context ofrece una opción de auto-draft from codebase. En ese modo, revisa el material disponible en tu repo (como README, textos de marketing o metadatos del paquete) para redactar una primera versión que luego tú refinás.

¿Cómo funciona product-marketing-context con otros skills de marketing?

Otros skills centrados en marketing dentro de tu configuración pueden leer .agents/product-marketing-context.md para:

• Entender tu producto y tu ICP
• Reutilizar tu voz de marca y mensajes clave
• Mantenerse alineados con tu posicionamiento y objetivos

Normalmente ejecutas product-marketing-context primero en un proyecto nuevo y luego te apoyas en el archivo de contexto compartido cuando generas emails, landing pages, anuncios de lanzamiento u otros materiales.

¿Es útil product-marketing-context para developers?

Sí. Los developers que montan flujos de trabajo con múltiples skills pueden tratar .agents/product-marketing-context.md como una única fuente de verdad que:

• Vive en el repositorio
• Es fácil de parsear o cargar de forma programática
• Mantiene alineados todos los skills relacionados con marketing

Esto es especialmente útil en configuraciones de automatización más grandes, donde distintos agentes necesitan información consistente sobre producto y audiencia.

¿Qué archivos debería revisar para entender o personalizar el skill?

Empieza por:

• SKILL.md – Describe el propósito de product-marketing-context y su flujo de trabajo
• evals/evals.json – Muestra prompts de ejemplo y resultados esperados, lo que te ayuda a ver cómo se comporta el skill en escenarios reales

A partir de ahí puedes adaptar cómo llamas al skill o cómo lo encadenas con otros para que encaje con la estructura de tu repositorio y tus procesos de marketing.