product-marketing-context

Présentation de la skill product-marketing-context

Ce que fait product-marketing-context

La skill product-marketing-context vous aide à créer et maintenir un fichier source partagé de marketing produit dans .agents/product-marketing-context.md. Son rôle est simple, mais très utile : consigner une bonne fois pour toutes la vue d’ensemble du produit, l’audience, le positionnement, les objections, les preuves et les bases du messaging, afin que les autres workflows marketing puissent les réutiliser au lieu de reposer les mêmes questions de fond à chaque fois.

À qui s’adresse cette skill

Cette skill est particulièrement adaptée aux fondateurs, product marketers, responsables growth et agences qui ont besoin d’un travail marketing assisté par IA, réutilisable à l’échelle d’un repo ou d’un projet client. Elle est особенно utile si vous cherchez plus de cohérence sur des tâches de messaging comme le positionnement, le travail sur l’ICP, les brouillons de landing pages, la planification de campagnes ou les contenus d’aide à la vente.

Le vrai besoin auquel elle répond

La plupart des équipes n’ont pas besoin de “plus de copy”. Elles ont besoin d’une couche de contexte stable que le modèle puisse consulter avant de rédiger quoi que ce soit. La product-marketing-context skill a été pensée pour cette étape de mise en place. Elle crée d’abord un document de contexte marketing réutilisable, sur lequel d’autres skills peuvent ensuite s’appuyer.

Pourquoi c’est préférable à un prompt générique

Un prompt classique peut demander un positionnement, mais il produit généralement une réponse ponctuelle. product-marketing-context est structurée autour de :

• la vérification d’un fichier de contexte existant en priorité
• la mise à jour des seules sections qui ont changé
• la proposition d’un brouillon automatique à partir du codebase ou d’un démarrage guidé depuis zéro
• l’enregistrement du résultat dans un chemin de fichier prévisible que d’autres skills peuvent référencer

Cela en fait un outil plus opérationnel qu’un simple prompt du type “aide-moi sur le messaging”.

Cas d’usage idéaux et cas où ce n’est pas le bon choix

Cas les plus adaptés :

• nouveaux produits sans base de messaging formalisée
• repos où plusieurs skills marketing IA seront utilisées
• équipes qui mettent à jour leur positionnement après un lancement, un changement de prix ou un changement d’audience

Cas moins adaptés :

• tâches copy ponctuelles pour lesquelles vous ne voulez pas de contexte persistant
• produits sans repo accessible ni supports produit à examiner
• équipes qui attendent de cette skill, à elle seule, une vraie recherche de marché approfondie

Comment utiliser la skill product-marketing-context

Contexte d’installation et emplacement du fichier

Si votre environnement prend en charge l’installation de Skills, ajoutez le repository parent et utilisez la skill product-marketing-context depuis celui-ci. Le fichier de sortie autour duquel cette skill est conçue est :

/.agents/product-marketing-context.md

La skill vérifie aussi .claude/product-marketing-context.md pour les anciennes configurations et peut vous aider à migrer ce contenu vers le nouvel emplacement.

Commencez par vérifier s’il existe déjà un fichier de contexte

Avant de créer quoi que ce soit, le workflow prévu consiste à chercher :

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

Si un fichier de contexte existe déjà, la bonne approche n’est pas “tout réécrire”. Il faut le lire, résumer ce qui est déjà documenté, puis mettre à jour uniquement les sections affectées par les changements de l’utilisateur.

Choisir le bon parcours de mise en place

Le repository montre deux points d’entrée pratiques :

1. Auto-draft from codebase
   Recommandé lorsque le repo contient des signaux exploitables comme README.md, du copy de landing page, de la documentation, package.json ou du copy produit dans l’app.

2. Start from scratch
   Préférable lorsque le repo est léger, que les documents privés comptent davantage que le code, ou que le produit est encore en cours de définition.

C’est l’un des détails d’adoption les plus importants dans le product-marketing-context guide : vous obtiendrez de meilleurs résultats si vous choisissez le parcours qui correspond à la qualité de vos sources.

Les entrées dont product-marketing-context a besoin

Pour obtenir une sortie utile, fournissez au minimum :

• ce qu’est le produit
• à qui il s’adresse
• le principal problème qu’il résout
• ce qui le différencie des alternatives
• les preuves ou contraintes actuelles
• s’il s’agit d’un premier brouillon ou d’une mise à jour

Entrées complémentaires utiles :

• changements de tarification ou de paliers
• nouveaux personas
• schémas de win/loss
• langage client issu d’appels ou d’avis
• préférences de brand voice
• objections commerciales
• objectifs de lancement ou de trimestre

Les sections que cette skill cherche à construire

D’après les evals du repository et le workflow, attendez-vous à ce que le flux product-marketing-context usage couvre des sections comme :

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

Cette structure compte, car elle produit un fichier de contexte durable, pas juste un paragraphe de positionnement.

Transformer une demande vague en prompt solide

Faible :

Help me with product marketing.

Mieux :

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.

Idéal pour les mises à jour :

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 pratique pour limiter les suppositions

Une bonne séquence de travail est la suivante :

1. Vérifier s’il existe déjà un fichier de contexte.
2. Choisir entre auto-draft et entretien guidé.
3. Construire ou mettre à jour le fichier de contexte section par section.
4. Signaler les hypothèses et les preuves manquantes.
5. Revoir le résultat avec l’utilisateur pour corriger.
6. Enregistrer dans .agents/product-marketing-context.md.
7. Réutiliser ce fichier dans les tâches marketing suivantes.

C’est la principale raison d’effectuer un product-marketing-context install tôt dans un projet : cela réduit le travail de cadrage répété par la suite.

Fichiers du repository à lire en priorité

Pour une évaluation rapide, commencez par :

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

SKILL.md explique le workflow opérationnel. evals/evals.json est utile parce qu’il montre à quoi ressemble un “bon usage” dans des prompts réalistes, y compris lors de mises à jour après des changements produit.

Ce qui améliore concrètement la qualité des résultats

Les meilleurs résultats viennent d’éléments probants, pas d’intentions. Si vous voulez un document de contexte plus solide, orientez la skill vers :

• le copy de homepage ou de landing page
• la documentation produit et les textes d’onboarding
• des notes de transcription de démo
• les descriptions de prix et de plans
• des citations d’entretiens clients
• les comparatifs concurrentiels que vous utilisez réellement
• les objections remontées en sales call
• les guidelines de marque existantes

Sans cela, le brouillon peut rester exploitable, mais il contiendra davantage d’hypothèses génériques.

À quoi s’attendre pour la première version

Une V1 créée avec product-marketing-context doit être considérée comme un document de travail, pas comme une vérité définitive. Le brouillon le plus utile :

• distingue les faits confirmés du positionnement inféré
• met en évidence les lacunes dans les proof points ou la clarté de l’audience
• apporte suffisamment de structure pour que les tâches marketing IA en aval restent cohérentes

Si vous voulez un messaging stratégique vraiment abouti, prévoyez une passe de revue après la création du fichier initial.

FAQ sur la skill product-marketing-context

product-marketing-context convient-elle aux débutants ?

Oui. Elle est accessible aux débutants parce que le workflow est explicite : vérifier s’il existe déjà un fichier, choisir entre auto-draft et mise en place guidée, puis remplir des sections précises. Vous n’avez pas besoin de maîtriser des frameworks PMM formels pour obtenir une première version exploitable.

Quand utiliser product-marketing-context plutôt qu’un prompt classique ?

Utilisez-la quand vous voulez un contexte réutilisable sur plusieurs tâches. Si votre objectif est un seul titre de landing page, un prompt classique peut suffire. Si votre objectif est un messaging cohérent sur de nombreuses sorties, product-marketing-context for Product Marketing constitue une bien meilleure base.

Peut-elle mettre à jour un contexte existant au lieu de le recréer ?

Oui. C’est un comportement central. La skill est conçue pour lire un .agents/product-marketing-context.md existant, résumer ce qu’il contient déjà et ne réviser que les sections affectées par les nouvelles informations.

Fait-elle la recherche de marché à ma place ?

Pas vraiment. Elle peut inférer beaucoup de choses à partir du repo et des supports produit, mais elle ne remplace pas une recherche client. Si vos sources sont faibles, la sortie restera utile sur le plan de la structure, mais sera plus légère stratégiquement.

Que faire si mon repo contient très peu de copy marketing ?

Utilisez le parcours start-from-scratch et répondez aux questions de manière conversationnelle. C’est souvent préférable à un auto-draft forcé depuis des codebases trop pauvres pour révéler grand-chose sur les clients, les objections ou le contexte d’achat.

product-marketing-context est-elle utile uniquement dans cet écosystème de repo ?

Elle prend le plus de valeur lorsqu’elle est couplée à d’autres skills marketing qui référencent .agents/product-marketing-context.md, mais le fichier lui-même reste portable. Vous pouvez tout de même l’utiliser comme brief PMM de référence, même en dehors de l’écosystème complet de skills.

Dans quels cas cette skill est-elle un mauvais choix ?

Évitez-la si :

• vous avez seulement besoin d’un output copy isolé
• votre équipe ne maintiendra pas de fichier de contexte partagé
• votre produit est encore trop peu défini pour répondre aux questions de base sur l’audience et le problème traité

Comment améliorer la skill product-marketing-context

Donnez à la skill des preuves, pas seulement des objectifs

Le plus grand levier d’amélioration de la product-marketing-context skill, c’est la qualité des sources. “We want stronger positioning” ne suffit pas. Fournissez des éléments bruts tels que :

• texte de homepage
• notes d’appels clients
• principales objections côté sales
• raisons pour lesquelles les clients basculent
• explications reliant fonctionnalités et bénéfices
• proof points chiffrés

Cela permet au modèle d’ancrer ses affirmations au lieu de les inventer.

Soyez explicite sur ce qui a changé

Pour les mises à jour, ne demandez pas une refonte large si seulement deux éléments ont évolué. Dites précisément ce qui est nouveau :

• nouveau palier tarifaire
• ICP élargi
• catégorie renommée
• focus enterprise renforcé
• nouvelle pression concurrentielle

Cela aide la skill à mettre à jour les bonnes sections sans affaiblir par inadvertance un messaging encore juste.

Demandez que les hypothèses soient clairement signalées

Un mode d’échec fréquent est le raisonnement implicite. Pour améliorer la qualité du résultat, demandez au modèle d’indiquer :

• les faits confirmés
• les inférences probables
• les informations manquantes
• les questions à revoir

Le premier brouillon devient alors beaucoup plus simple à valider et à affiner.

Passez en revue section par section pour un meilleur résultat final

N’attendez pas la fin pour relire tout le document d’un bloc. Les sections les plus importantes à valider tôt sont :

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

Si elles sont erronées, tout le messaging produit ensuite à partir du fichier dérivera lui aussi.

Renforcez la capture du langage client

Un point faible fréquent est le wording trop générique. Pour améliorer concrètement le product-marketing-context guide, fournissez-lui les formulations réelles utilisées par les clients dans :

• les entretiens
• les tickets support
• les sites d’avis
• les appels commerciaux
• les retours d’onboarding

Le vrai langage client améliore nettement la pertinence des contenus générés ensuite.

Surveillez ces modes d’échec courants

Les problèmes typiques incluent :

• des listes de fonctionnalités déguisées en positionnement
• des ICP trop larges
• une différenciation faible face à des “concurrents” vagues
• une brand voice aspirante sans exemples concrets
• des proof points qui sont des affirmations plutôt que des preuves

Si vous observez ces dérives, révisez les sources avant de demander une réécriture.

Itérez avec des prompts de suivi ciblés

Après le premier brouillon, utilisez des prompts précis comme :

• “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.”

Une itération ciblée améliore le document bien plus vite qu’une demande de réécriture complète.

Maintenez product-marketing-context comme un fichier vivant

Le meilleur usage à long terme de product-marketing-context, c’est une maintenance continue, pas une mise en place ponctuelle. Revenez sur le fichier lorsque le produit, l’audience, la tarification, la catégorie ou le motion commercial changent. Vous garderez ainsi toutes les tâches marketing en aval alignées sur la réalité actuelle, plutôt que sur des hypothèses devenues obsolètes.