product-marketing-context

Visão geral

O que esta skill faz

A skill product-marketing-context ajuda você a criar e manter um único documento de contexto de product marketing, reutilizável, para o seu projeto.

Em vez de ter que explicar seu produto, público e posicionamento de novo a cada tarefa, esta skill conduz você por um questionário estruturado e salva o resultado em:

• .agents/product-marketing-context.md

Outras skills e agentes de marketing compatíveis leem esse arquivo para entender seu produto e, assim, conseguem gerar conteúdos, campanhas e materiais de lançamento alinhados com a sua mensagem.

Para quem é

Use product-marketing-context se você é:

• Um(a) founder ou product owner definindo a história do seu produto pela primeira vez
• Um(a) product marketer ou marketing manager que quer mensagens consistentes entre campanhas
• Um(a) developer montando um sistema de skills e agentes de marketing que compartilham um arquivo de contexto comum

Ela é especialmente útil quando você trabalha com:

• Content marketing contínuo (blogs, emails, anúncios, landing pages)
• Lançamentos de produto e atualizações de planos/tiers
• Ajustes de posicionamento ou refinamento de ICP / personas

Problemas que ela resolve

A skill product-marketing-context foi criada para resolver estes problemas recorrentes:

• Repetir a mesma descrição de produto e detalhes de público em várias conversas
• Mensagens inconsistentes entre diferentes agentes ou skills
• Anotações de marketing de produto faltando ou espalhadas em vários arquivos
• Documentos de posicionamento difíceis de manter e que nunca são atualizados

Centralizando tudo em .agents/product-marketing-context.md, você passa a ter um documento vivo que cobre:

• Visão geral do produto e proposta de valor
• Público-alvo e ICP
• Personas e papéis envolvidos no processo de compra
• Problemas que você resolve e jobs-to-be-done
• Cenário competitivo e diferenciais
• Objeções, dinâmica de migração e provas
• Linguagem do cliente, voz de marca e objetivos de marketing

Quando é ou não é uma boa opção

Use product-marketing-context quando:

• Você está iniciando um novo projeto e quer uma base forte antes de usar outras skills de marketing
• Você mudou preços, tiers ou público (por exemplo, adicionando um plano enterprise ou novos perfis de compradores)
• Você está configurando um fluxo de marketing orientado por IA que precisa de contexto compartilhado

Talvez não seja uma boa opção quando:

• Você só precisa de um texto pontual e não pretende reutilizar o contexto
• Seu produto está em fase extremamente inicial e você ainda não tem nenhuma clareza (talvez faça sentido rascunhar o básico primeiro e, depois, rodar esta skill)

Se você pretende fazer mais de uma tarefa de marketing, instalar product-marketing-context primeiro geralmente compensa rápido.

Como usar

Instalação

Para adicionar a skill product-marketing-context ao seu ambiente, rode:

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

Esse comando baixa a skill `product-marketing-context` do repositório `coreyhaines31/marketingskills` e a deixa disponível junto com outras skills que você instalar da mesma origem.

Depois da instalação, você pode abrir os arquivos da skill diretamente no seu editor para revisar o comportamento e adaptar seus fluxos de trabalho conforme necessário:

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

### Fluxo principal
A skill product-marketing-context segue um fluxo de trabalho claro, com dois caminhos, dependendo se o arquivo de contexto já existe ou não.

#### 1. Verificar se já existe um contexto
Quando é acionada, a skill primeiro procura um documento de contexto existente:

- Local principal: `.agents/product-marketing-context.md`
- Local legado: `.claude/product-marketing-context.md` (para setups mais antigos)

Se existir um arquivo antigo apenas em `.claude/`, a skill foi projetada para sugerir mover ou atualizar esse arquivo para `.agents/`, mantendo seu setup consistente.

#### 2. Se o arquivo de contexto já existir
Se `.agents/product-marketing-context.md` já estiver presente, a skill vai:

1. Ler e resumir o conteúdo atual
2. Perguntar quais seções você quer atualizar (por exemplo, Target Audience, Personas ou Differentiation)
3. Passar apenas pelas seções selecionadas, para você não ter que repetir tudo

Isso facilita fazer atualizações incrementais, como:

- Expandir seu público-alvo (por exemplo, passar a incluir VP of Engineering)
- Adicionar um novo plano ou tier (por exemplo, um plano enterprise)
- Atualizar provas, logos ou estudos de caso

#### 3. Se o arquivo de contexto não existir
Se nenhum arquivo de contexto for encontrado, a skill oferece dois caminhos:

1. **Auto-draft a partir do codebase (recomendado)**
   - A skill inspeciona seu repositório (por exemplo: `README`, landing pages, textos de marketing, `package.json`, etc.)
   - Cria um primeiro rascunho do seu contexto de product marketing com base no que encontrar
   - Você revisa, corrige e expande esse rascunho V1

2. **Começar do zero**
   - A skill conduz você por cada seção, uma de cada vez, em formato de conversa
   - Você responde a perguntas direcionadas sobre seu produto, público e posicionamento

Nos dois casos, ao final do processo, a skill grava o documento final em:

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

### Seções capturadas no arquivo de contexto
O arquivo de contexto criado por product-marketing-context é estruturado em seções práticas e reutilizáveis. De acordo com as avaliações incluídas, espera-se que a skill cubra pelo menos as seguintes áreas, quando forem relevantes:

- **Product Overview** – O que você vende, o que o produto faz e para quem é
- **Target Audience** – Seu ICP, cargos, segmentos de indústria e portes de empresa
- **Personas** – Principais stakeholders, como Product Managers, VPs, founders ou compradores
- **Problems You Solve** – Dores, jobs-to-be-done e casos de uso
- **Competitive Landscape** – Com quem você concorre e como os compradores enxergam alternativas
- **Differentiation** – O que torna seu produto significativamente diferente
- **Objections** – Motivos mais comuns para os prospects hesitarem ou dizerem não
- **Switching Dynamics** – O que precisa acontecer para alguém migrar para você
- **Customer Language** – Frases, citações e vocabulário que seus clientes realmente usam
- **Brand Voice** – Como você quer soar em todos os canais
- **Proof Points** – Depoimentos, métricas, social proof e estudos de caso
- **Goals** – Como é o sucesso para seus esforços de marketing e go-to-market

Nem toda seção precisa ser preenchida para todo produto, mas a skill foi desenhada para cobrir todas as seções aplicáveis e avisar quando faltar informação.

### Como usar o contexto nos seus fluxos de trabalho
Depois que `.agents/product-marketing-context.md` existir, você pode:

- Referenciá-lo ao rodar outras **skills relacionadas a marketing**, para que todas compartilhem o mesmo entendimento do seu produto
- Mantê-lo sob controle de versão no seu repositório para acompanhar como seu posicionamento evolui
- Usá-lo como fonte interna de verdade para novas pessoas do time ou colaboradores

Como o arquivo fica em um caminho previsível, é fácil para:

- Outros agentes da coleção `marketingskills`
- Ferramentas ou scripts customizados que você criar

…carregarem esse conteúdo e trabalharem sobre uma base consistente de product marketing.

### Arquivos e diretórios para inspecionar
Para entender melhor ou personalizar, comece por:

- `SKILL.md` – Definição principal da skill, descrição e detalhes do fluxo de trabalho
- `evals/evals.json` – Prompts de exemplo e comportamento esperado, útil para ver como a skill deve responder em cenários reais

Você pode adaptar o comportamento da skill (por exemplo, como chamá-la ou encadeá-la com outras) para encaixar na estrutura do seu repositório e nas suas ferramentas de automação.

## FAQ

### O que é product-marketing-context em termos simples?
A skill product-marketing-context é um assistente guiado que ajuda você a criar um documento estruturado de product marketing — armazenado em `.agents/product-marketing-context.md` — cobrindo seu produto, público, posicionamento e mensagens principais, para que outras skills e agentes possam reutilizar esse conteúdo.

### Como instalo product-marketing-context?
Instale a partir do repositório `coreyhaines31/marketingskills` com:

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

Depois da instalação, você pode ver SKILL.md no diretório product-marketing-context para entender o fluxo exato.

Onde o documento de contexto é armazenado?

Por padrão, a skill cria e mantém seu contexto de product marketing em:

• .agents/product-marketing-context.md

Ela também consegue detectar setups antigos em .claude/product-marketing-context.md e sugerir a migração para .agents/.

O que acontece se eu já tiver um arquivo product-marketing-context?

Se .agents/product-marketing-context.md já existir, a skill vai:

1. Ler e resumir o conteúdo
2. Perguntar quais seções você quer alterar
3. Coletar novas informações apenas para essas seções

Assim você não precisa responder de novo perguntas que já estão documentadas.

product-marketing-context consegue atualizar meu contexto quando meu produto muda?

Sim. A skill foi projetada para suportar atualizações incrementais. Por exemplo, se você:

• Adicionar um novo plano enterprise
• Expandir seu público-alvo para novos cargos (por exemplo, incluir VP of Engineering)
• Ajustar seus diferenciais ou provas

…basta rodar a skill, e ela vai ajudar a atualizar somente as seções relevantes em .agents/product-marketing-context.md.

Esta skill cria conteúdo automaticamente a partir do meu codebase?

Pode criar. Quando não existe arquivo de contexto, product-marketing-context oferece a opção de auto-draft from codebase. Nesse modo, ela analisa materiais disponíveis no seu repositório (como README, textos de marketing ou metadados de package) para gerar um primeiro rascunho, que você depois refina.

Como product-marketing-context funciona com outras skills de marketing?

Outras skills focadas em marketing no seu setup podem ler .agents/product-marketing-context.md para:

• Entender seu produto e ICP
• Reutilizar sua voz de marca e mensagens
• Permanecer alinhadas com seu posicionamento e objetivos

Em geral, você roda product-marketing-context primeiro em um novo projeto, e depois se apoia no arquivo de contexto compartilhado para gerar emails, landing pages, anúncios de lançamento e outros materiais.

product-marketing-context é útil para developers?

Sim. Developers que estão montando fluxos com múltiplas skills podem tratar .agents/product-marketing-context.md como uma fonte única de verdade que:

• Fica dentro do repositório
• É fácil de carregar ou analisar programaticamente
• Mantém todas as skills de marketing alinhadas

Isso é especialmente útil em automações maiores, nas quais diferentes agentes precisam de informações consistentes sobre produto e público.

Quais arquivos devo olhar para entender ou customizar a skill?

Comece por:

• SKILL.md – Descreve o objetivo da product-marketing-context e seu fluxo de trabalho
• evals/evals.json – Mostra prompts de exemplo e saídas esperadas, ajudando a entender como a skill se comporta em cenários reais

Depois, você pode adaptar a forma de chamar a skill ou encadeá-la com outras, para combinar com a estrutura do seu repositório e com seus processos de marketing.