marketing-context

Visão geral do skill marketing-context

O que o marketing-context cria

marketing-context é um skill de configuração de Product Marketing para criar o arquivo de contexto compartilhado que outros skills de marketing podem ler antes de escrever copy, mensagens, páginas de SEO, lançamentos ou materiais de vendas. Sua principal saída é .claude/product-marketing-context.md, um documento canônico que cobre visão geral do produto, ICP, posicionamento, diferenciação, linguagem do cliente, voz da marca, pontos de prova, objeções e restrições relacionadas ao marketing.

Melhor uso para times de Product Marketing

O skill marketing-context é mais útil quando você está começando um novo workspace de product marketing, apresentando um produto existente ao Claude ou cansou de repetir público, tom, concorrentes e posicionamento em todo prompt. Ele funciona bem para founders, PMMs, profissionais de growth marketing, estrategistas de conteúdo e agências que precisam de contexto reaproveitável antes de usar skills de marketing posteriores.

Por que este skill é diferente de um prompt comum

Um prompt genérico pode pedir “voz da marca” ou “ICP”, mas marketing-context transforma isso em um documento operacional reutilizável. O skill oferece suporte a três modos práticos: rascunho automático a partir de materiais do repositório ou do site, entrevista guiada quando há pouco material de origem e atualização de um arquivo de contexto existente conforme o posicionamento evolui. Ele também inclui um script validador para pontuar a completude, o que ajuda a evitar que um briefing de marketing vago e meio preenchido vire a fonte padrão da verdade.

Pontos de atenção antes de adotar

Instale marketing-context quando quiser consistência em várias tarefas de marketing assistidas por IA. Não espere que ele invente um posicionamento confiável do zero; ele precisa de material de origem, entrevistas ou correções do usuário. O detalhe de configuração mais importante é a disciplina de caminho: skills irmãos nesta biblioteca esperam encontrar o contexto em .claude/product-marketing-context.md, não em uma anotação aleatória no nível raiz.

Como usar o skill marketing-context

Instalação do marketing-context e arquivos para inspecionar

Instale a partir do repositório de skills no GitHub com:

npx skills add alirezarezvani/claude-skills --skill marketing-context

Depois da instalação, leia SKILL.md primeiro para entender o fluxo de trabalho e o caminho de saída obrigatório. Em seguida, inspecione templates/marketing-context-template.md para ver as seções esperadas e scripts/context_validator.py para entender como a completude é pontuada. Se você já tiver .agents/marketing-context.md ou marketing-context.md, mova ou consolide esse conteúdo em .claude/product-marketing-context.md para que outros skills de marketing consigam encontrá-lo.

Inputs que geram um bom primeiro rascunho

No modo de rascunho automático, direcione o assistente para materiais reais: README.md, landing pages, páginas de preços, documentação, depoimentos de clientes, estudos de caso, decks de vendas, notas sobre concorrentes e tickets de suporte. Um bom pedido deixa claro o que o assistente pode inferir e o que precisa ser marcado como desconhecido.

Exemplo:

“Use marketing-context to create .claude/product-marketing-context.md. Review README.md, docs/, website/, and pricing.md. Draft a V1 for a B2B SaaS product selling to RevOps teams. Mark uncertain claims as assumptions, list gaps at the end, and do not invent customer proof points.”

Isso dá ao skill limites suficientes para construir contexto sem transformar especulação em mensagem de marketing.

Transformando uma meta vaga em um prompt completo

Prompt fraco: “Set up marketing context for my app.”

Prompt melhor: “Use marketing-context for Product Marketing setup. I need a reusable context file for future landing page, email, and SEO skills. Interview me one section at a time if details are missing. Prioritize ICP, jobs to be done, competitive alternatives, differentiation, customer language, brand voice, and proof points. Save the result to .claude/product-marketing-context.md.”

Isso funciona porque explicita os casos de uso posteriores, as seções obrigatórias, o estilo de entrevista e o local de salvamento.

Fluxo de trabalho sugerido para o primeiro uso

Comece pelo rascunho automático se o seu repositório ou site já descreve o produto. Revise o rascunho como PMM, não como revisor de texto: ajuste público, categoria, enquadramento competitivo, claims e “palavras a evitar” antes de polir o tom. Depois, execute ou use como referência scripts/context_validator.py para identificar seções ausentes. Por fim, peça ao assistente para atualizar o contexto depois de mudanças relevantes, como um novo ICP, novo preço, novo concorrente, novo ponto de prova ou reposicionamento.

FAQ do skill marketing-context

O marketing-context serve apenas para produtos técnicos?

Não. O caminho do repositório fica dentro de uma biblioteca de skills de marketing, e o template funciona para SaaS, marketplaces, serviços, e-commerce e outros tipos de produto. Repositórios técnicos facilitam o modo de rascunho automático porque o assistente consegue inspecionar documentação e arquivos próximos ao código, mas times não técnicos podem usar o modo de entrevista guiada com inputs de negócio.

O que o marketing-context precisa antes da instalação?

Você não precisa ter uma estratégia de posicionamento perfeita antes de instalar. Precisa, sim, estar disposto a fornecer correções. Os inputs mínimos úteis incluem o que o produto faz, quem compra, o principal caso de uso, alternativas com as quais os clientes comparam, por que os clientes escolhem você, tom preferido e qualquer prova que você possa afirmar com segurança.

Quando eu não deveria usar marketing-context?

Não use marketing-context como substituto de pesquisa com clientes, revisão jurídica, estratégia de marca ou inteligência competitiva. Ele organiza e operacionaliza o que você já sabe; não verifica a verdade do mercado. Também é exagero para um post social pontual se você não vai reutilizar o contexto em outros trabalhos de marketing.

Como ele se encaixa com outros skills de marketing?

marketing-context deve ser executado antes de skills posteriores de Product Marketing, conteúdo, SEO, lançamento ou copywriting. Seu valor aumenta quando vários skills leem o mesmo .claude/product-marketing-context.md, porque cada saída começa a partir do mesmo ICP, posicionamento, voz, pontos de prova e restrições.

Como melhorar o skill marketing-context

Reforce o material de origem antes de rodar novamente

Os melhores resultados com marketing-context vêm de evidências concretas, não de afirmações amplas. Adicione frases reais de clientes, objeções de vendas, dores vindas do suporte, nomes de concorrentes, notas de preço, screenshots do posicionamento atual e pontos de prova aprovados. Se você fornecer apenas “AI productivity tool for teams”, espere um resultado genérico. Se fornecer “mid-market RevOps teams replacing spreadsheet-based territory planning because handoffs break after comp changes”, o skill consegue produzir um posicionamento mais preciso.

Use o validador como checklist editorial

context_validator.py pontua seções como Product Overview, Target Audience, Problems & Pain Points, Competitive Landscape, Differentiation, Customer Language, Brand Voice e Proof Points. Trate uma pontuação baixa como sinal de que o briefing precisa melhorar antes de pedir que outros skills escrevam. O objetivo não é perseguir um número perfeito; é identificar ingredientes ausentes que enfraqueceriam todos os ativos posteriores.

Modos de falha comuns para corrigir

Fique atento a pontos de prova inventados, personas vagas, listas de concorrentes sem explicar “onde eles deixam a desejar”, adjetivos de voz da marca sem exemplos e diferenciação que descreve funcionalidades em vez de uma vantagem relevante para o comprador. Peça ao assistente para rotular suposições, separar fatos de hipóteses e adicionar uma seção “needs validation” quando as evidências forem fracas.

Itere o marketing-context depois da primeira saída

Seu primeiro arquivo de contexto deve ser uma V1 de trabalho, não uma bíblia de marca definitiva. Depois de revisá-lo, use prompts de atualização direcionados: “Update only Competitive Landscape and Differentiation based on these new competitors,” ou “Revise Customer Language using these five sales call excerpts.” Isso mantém o marketing-context preciso sem reescrever seções estáveis toda vez.