product-marketing-context

Vue d’ensemble

Ce que fait cette skill

La skill product-marketing-context vous aide à créer et maintenir, pour votre projet, un document unique et réutilisable de contexte marketing produit.

Au lieu de réexpliquer votre produit, votre audience et votre positionnement pour chaque nouvelle tâche, cette skill vous fait passer par un questionnaire structuré et enregistre le résultat dans :

• .agents/product-marketing-context.md

Les autres skills et agents marketing compatibles lisent ensuite ce fichier pour comprendre votre produit, afin de générer du contenu, des campagnes et des supports de lancement cohérents avec votre message.

Pour qui est cette skill

Utilisez product-marketing-context si vous êtes :

• Un fondateur ou product owner qui définit l’histoire de son produit pour la première fois
• Un product marketer ou responsable marketing qui veut des messages cohérents sur l’ensemble des campagnes
• Un développeur qui met en place un système de skills et d’agents marketing partageant un même fichier de contexte

Elle est particulièrement utile lorsque vous travaillez sur :

• Du content marketing continu (blogs, emails, ads, landing pages)
• Des lancements produit et mises à jour de gammes
• Du travail de positionnement ou de raffinement de votre ICP / personas

Problèmes que cette skill résout

La skill product-marketing-context est conçue pour résoudre plusieurs problèmes récurrents :

• Répéter la même description produit et les mêmes détails d’audience dans de multiples conversations
• Des messages incohérents entre différents agents ou skills
• Des notes de marketing produit manquantes ou éparpillées dans plusieurs fichiers
• Des documents de positionnement difficiles à maintenir et rarement mis à jour

En centralisant tout cela dans .agents/product-marketing-context.md, vous obtenez un document vivant qui couvre :

• La vue d’ensemble du produit et sa proposition de valeur
• La cible et l’ICP
• Les personas et les rôles impliqués dans le processus d’achat
• Les problèmes que vous résolvez et les jobs-to-be-done
• Le paysage concurrentiel et vos différenciateurs
• Les objections, dynamiques de changement et preuves à l’appui
• Le langage client, la voix de marque et les objectifs marketing

Quand cette skill est (ou n’est pas) adaptée

Utilisez product-marketing-context lorsque :

• Vous démarrez un nouveau projet et voulez une base solide avant d’utiliser d’autres skills marketing
• Vous avez modifié vos prix, vos offres ou votre cible (par exemple, ajout d’une offre enterprise ou de nouveaux profils d’acheteurs)
• Vous mettez en place un workflow marketing piloté par l’IA qui nécessite un contexte partagé

Cette skill n’est peut-être pas adaptée si :

• Vous avez seulement besoin d’un texte ponctuel sans intention de réutiliser le contexte
• Votre produit est à un stade extrêmement précoce et vous n’avez encore aucune clarté (vous pouvez d’abord poser les bases, puis lancer cette skill ensuite)

Si vous prévoyez de réaliser plus d’une tâche marketing, installer product-marketing-context en premier est généralement rapidement rentable.

Comment l’utiliser

Installation

Pour ajouter la skill product-marketing-context à votre environnement, exécutez :

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

Cette commande récupère la skill `product-marketing-context` depuis le dépôt `coreyhaines31/marketingskills` et la met à disposition aux côtés des autres skills que vous installez depuis la même source.

Après l’installation, vous pouvez ouvrir directement les fichiers de la skill dans votre éditeur pour examiner son fonctionnement et adapter vos workflows si nécessaire :

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

### Workflow principal
La skill product-marketing-context suit un workflow clair, avec deux chemins distincts selon qu’un fichier de contexte existe déjà ou non.

#### 1. Vérifier l’existence d’un contexte
Lorsqu’elle est appelée, la skill commence par chercher un document de contexte existant :

- Emplacement principal : `.agents/product-marketing-context.md`
- Emplacement historique : `.claude/product-marketing-context.md` (pour les anciens setups)

Si un ancien fichier existe uniquement sous `.claude/`, la skill est conçue pour proposer de le déplacer ou de le mettre à niveau dans `.agents/` afin de garder une configuration cohérente.

#### 2. Si le fichier de contexte existe déjà
Si `.agents/product-marketing-context.md` est déjà présent, la skill va :

1. Lire et résumer le contenu actuel
2. Demander quelles sections vous souhaitez mettre à jour (par exemple, Target Audience, Personas ou Differentiation)
3. Ne parcourir que les sections choisies, sans vous faire tout recommencer

Cela facilite les mises à jour incrémentales, par exemple :

- Élargir votre audience cible (par ex. inclure désormais un VP of Engineering)
- Ajouter une nouvelle offre ou un nouveau tier (par ex. un plan enterprise)
- Mettre à jour vos preuves, logos ou études de cas

#### 3. Si le fichier de contexte n’existe pas
Si aucun fichier de contexte n’est trouvé, la skill propose deux chemins :

1. **Auto-draft from codebase (recommandé)**
   - La skill inspecte votre dépôt (par exemple : `README`, landing pages, contenus marketing, `package.json`, etc.)
   - Elle rédige une première version de votre contexte marketing produit à partir de ce qu’elle trouve
   - Vous relisez, corrigez et enrichissez ce premier jet (V1)

2. **Démarrer de zéro**
   - La skill vous fait parcourir chaque section une par une, de façon conversationnelle
   - Vous répondez à des questions ciblées sur votre produit, votre audience et votre positionnement

Dans les deux cas, une fois le processus terminé, la skill écrit le document final dans :

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

### Sections couvertes dans le fichier de contexte
Le fichier de contexte créé par product-marketing-context est structuré autour de sections pratiques et réutilisables. D’après les évaluations intégrées, la skill est censée couvrir au minimum les domaines suivants, lorsque c’est pertinent :

- **Product Overview** – Ce que vous vendez, ce que cela fait et pour qui
- **Target Audience** – Votre ICP, les rôles, les secteurs et les tailles d’entreprise
- **Personas** – Les parties prenantes clés, comme les Product Managers, VPs, fondateurs ou acheteurs
- **Problems You Solve** – Les pain points, jobs-to-be-done et cas d’usage
- **Competitive Landscape** – Vos concurrents et la manière dont les acheteurs perçoivent les alternatives
- **Differentiation** – Ce qui rend votre produit réellement différent
- **Objections** – Les principales raisons pour lesquelles les prospects hésitent ou disent non
- **Switching Dynamics** – Ce qui doit se passer pour qu’un client bascule vers votre solution
- **Customer Language** – Les expressions, citations et termes que vos clients utilisent réellement
- **Brand Voice** – La manière dont vous souhaitez sonner sur vos différents canaux
- **Proof Points** – Témoignages, métriques, preuves sociales et études de cas
- **Goals** – À quoi ressemble le succès pour votre marketing et votre go-to-market

Toutes les sections n’ont pas besoin d’être renseignées pour chaque produit, mais la skill est conçue pour couvrir toutes les sections pertinentes et vous solliciter lorsqu’une information manque.

### Utiliser le contexte dans vos workflows
Une fois que `.agents/product-marketing-context.md` existe, vous pouvez :

- Vous y référer lorsque vous lancez d’autres **skills orientées marketing** afin qu’elles partagent la même compréhension de votre produit
- Le garder sous contrôle de version dans votre dépôt pour suivre l’évolution de votre positionnement
- L’utiliser comme source de vérité interne pour les nouveaux membres de l’équipe ou vos collaborateurs

Parce que le fichier se trouve à un chemin prévisible, il est facile pour :

- Les autres agents de la collection `marketingskills`
- Les outils ou scripts personnalisés que vous écrivez

…de le charger et de travailler sur une base marketing produit cohérente.

### Fichiers et répertoires à examiner
Pour aller plus loin dans la compréhension ou la personnalisation, commencez par :

- `SKILL.md` – Définition principale de la skill, description et détails de workflow
- `evals/evals.json` – Prompts d’exemple et comportements attendus, utiles pour voir comment la skill doit réagir dans des scénarios réels

Vous pouvez adapter le comportement de la skill (par exemple, comment vous l’appelez ou comment vous la chaînez avec d’autres) pour l’aligner sur la structure de votre dépôt et vos outils d’automatisation.

## FAQ

### C’est quoi product-marketing-context en termes simples ?
La skill product-marketing-context est un assistant guidé qui vous aide à créer un document structuré de marketing produit — stocké dans `.agents/product-marketing-context.md` — couvrant votre produit, votre audience, votre positionnement et vos messages clés, afin que d’autres skills et agents puissent le réutiliser.

### Comment installer product-marketing-context ?
Installez-la depuis le dépôt `coreyhaines31/marketingskills` avec :

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

Après l’installation, vous pouvez consulter SKILL.md dans le répertoire product-marketing-context pour voir le workflow détaillé.

Où est stocké le document de contexte ?

Par défaut, la skill crée et maintient votre contexte marketing produit à l’emplacement :

• .agents/product-marketing-context.md

Elle peut également détecter les anciens setups dans .claude/product-marketing-context.md et proposer de les migrer vers .agents/.

Que se passe-t-il si j’ai déjà un fichier product-marketing-context ?

Si .agents/product-marketing-context.md existe déjà, la skill va :

1. Lire et résumer le contenu
2. Demander quelles sections vous souhaitez modifier
3. Ne recueillir de nouvelles informations que pour ces sections

Cela vous évite de répondre à nouveau à des questions déjà documentées.

product-marketing-context peut-il mettre à jour mon contexte lorsque mon produit évolue ?

Oui. La skill est conçue pour prendre en charge les mises à jour incrémentales. Par exemple, si vous :

• Ajoutez un nouveau tier enterprise
• Élargissez votre cible à de nouveaux rôles (par ex. ajout d’un VP of Engineering)
• Ajustez vos différenciateurs ou vos preuves

…vous pouvez invoquer la skill, qui vous aidera à mettre à jour uniquement les sections pertinentes dans .agents/product-marketing-context.md.

Cette skill peut-elle rédiger automatiquement un premier contenu à partir de mon codebase ?

Oui. Lorsqu’aucun fichier de contexte n’existe, product-marketing-context propose une option auto-draft from codebase. Dans ce mode, elle examine les éléments disponibles dans votre repo (comme le README, les contenus marketing ou les métadonnées de packages) pour rédiger une première version que vous affinez ensuite.

Comment product-marketing-context fonctionne-t-il avec les autres skills marketing ?

Les autres skills orientées marketing de votre setup peuvent lire .agents/product-marketing-context.md pour :

• Comprendre votre produit et votre ICP
• Réutiliser votre voix de marque et vos messages
• Rester alignées sur votre positionnement et vos objectifs

Vous lancez généralement product-marketing-context en premier sur un nouveau projet, puis vous vous appuyez sur ce fichier de contexte partagé pour générer emails, landing pages, annonces de lancement et autres assets.

product-marketing-context est-il utile pour les développeurs ?

Oui. Les développeurs qui orchestrent des workflows multi-skills peuvent considérer .agents/product-marketing-context.md comme une source de vérité unique qui :

• Vit dans le dépôt
• Est facile à parser ou à charger par programme
• Garde toutes les skills marketing alignées

C’est particulièrement utile dans des setups d’automatisation plus complexes où plusieurs agents ont besoin d’une information produit et audience cohérente.

Quels fichiers consulter pour comprendre ou personnaliser la skill ?

Commencez par :

• SKILL.md – Décrit l’objectif de product-marketing-context et son workflow
• evals/evals.json – Montre des prompts d’exemple et les outputs attendus, ce qui permet de voir comment la skill se comporte dans des scénarios concrets

Vous pouvez ensuite adapter la façon dont vous appelez la skill, ou la chaîner avec d’autres, pour l’aligner sur la structure de votre dépôt et vos processus marketing.