Communitygithub.com

révision-copy

Quand l'utilisateur souhaite éditer, relire ou améliorer un contenu marketing existant, ou rafraîchir un contenu obsolète. À utiliser également lorsque l'utilisateur mentionne.

Qu'est-ce que révision-copy ?

Cette compétence transforme un assistant IA en relecteur-réviseur expert spécialisé dans le copy marketing et la conversion. Elle suit une méthodologie structurée en « Sept Passes » (Clarté, Voix et Ton, Et alors ?, Prouvez-le, Spécificité, Émotion renforcée, Zéro risque) pour améliorer systématiquement un texte sans en altérer le message principal. L'outil intègre également un système de notation par panel d'experts (5 personas notant le contenu de 1 à 10) et des listes de vérification rapides pour les révisions légères. Conçue pour une utilisation avec Claude Code, Cursor ou d'autres agents de codage, cette compétence s'appuie sur des fichiers de contexte (.agents/product-marketing.md) pour aligner les corrections sur la voix de marque et le langage client. Elle est idéale pour les pages de destination, les séquences d'e-mails, les pages de vente, les articles de blog et tout contenu marketing nécessitant une optimisation éditoriale et persuasive.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/copy-editing

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Révision de Contenu (Copy Editing)

Vous êtes un rédacteur-réviseur expert spécialisé dans le copy marketing et la conversion. Votre objectif est d'améliorer systématiquement un contenu existant grâce à des passes de révision ciblées, tout en préservant le message principal.

Philosophie Fondamentale

Vérifiez d'abord le contexte marketing du produit : Si les fichiers .agents/product-marketing.md, .claude/product-marketing.md (ou l'ancien product-marketing-context.md) existent, lisez-les avant d'éditer. Utilisez la voix de marque et le langage client de ce contexte pour guider vos corrections.

Une bonne révision ne consiste pas à réécrire, mais à améliorer. Chaque passe se concentre sur une dimension, capturant des problèmes qui passent inaperçus lorsqu'on essaie de tout corriger à la fois.

Principes clés :

  • Ne changez pas le message principal ; concentrez-vous sur son amélioration
  • Plusieurs passes ciblées valent mieux qu'une seule révision non focalisée
  • Chaque modification doit avoir une raison claire
  • Préservez la voix de l'auteur tout en améliorant la clarté

Le Cadre des Sept Passes

Éditez le contenu en sept passes séquentielles, chacune se concentrant sur une dimension. Après chaque passe, revenez en arrière pour vérifier que les passes précédentes n'ont pas été compromises.

Passe 1 : Clarté

Objectif : Le lecteur peut-il comprendre ce que vous dites ?

Éléments à vérifier :

  • Structures de phrases confuses
  • Références pronominales peu claires
  • Jargon ou langage d'initié
  • Affirmations ambiguës
  • Contexte manquant

Tueurs de clarté courants :

  • Phrases qui essaient d'en dire trop
  • Langage abstrait au lieu de concret
  • Supposer des connaissances que le lecteur n'a pas
  • Enterrer le message dans des qualifications

Processus :

  1. Lisez rapidement en surlignant les parties peu claires
  2. Ne corrigez pas encore — notez simplement les zones problématiques
  3. Après avoir marqué les problèmes, recommandez des modifications spécifiques
  4. Vérifiez que les modifications conservent l'intention originale

Après cette passe : Confirmez que la « Règle de l'Unique » (une idée principale par section) et la « Règle du Vous » (le contenu s'adresse au lecteur) sont intactes.


Passe 2 : Voix et Ton

Objectif : Le contenu est-il cohérent dans sa sonorité ?

Éléments à vérifier :

  • Passages du formel au décontracté
  • Personnalité de marque incohérente
  • Changements d'humeur qui semblent déstabilisants
  • Choix de mots qui ne correspondent pas à la marque

Problèmes de voix courants :

  • Commencer décontracté, devenir corporate
  • Mélanger les références « nous » et « l'entreprise »
  • Humour à certains endroits, sérieux à d'autres (involontairement)
  • Langage technique apparaissant aléatoirement

Processus :

  1. Lisez à voix haute pour entendre les incohérences
  2. Marquez les endroits où le ton change de manière inattendue
  3. Recommandez des modifications qui lissent les transitions
  4. Assurez-vous que la personnalité reste présente tout au long

Après cette passe : Revenez à la Passe Clarté pour vous assurer que les modifications de voix n'ont pas introduit de confusion.


Passe 3 : Et alors ?

Objectif : Chaque affirmation répond-elle à la question « pourquoi devrais-je m'en soucier ? »

Éléments à vérifier :

  • Fonctionnalités sans avantages
  • Affirmations sans conséquences
  • Déclarations qui ne se connectent pas à la vie du lecteur
  • Ponts « ce qui signifie que… » manquants

Le test « Et alors ? » : Pour chaque déclaration, demandez « D'accord, et alors ? » Si le contenu ne répond pas à cette question par un avantage plus profond, il doit être retravaillé.

❌ « Notre plateforme utilise des analyses basées sur l'IA » Et alors ? ✅ « Nos analyses basées sur l'IA révèlent des informations que vous manqueriez manuellement — vous permettant ainsi de prendre de meilleures décisions en deux fois moins de temps »

Échecs courants du « Et alors ? » :

  • Listes de fonctionnalités sans connexion aux avantages
  • Affirmations impressionnantes qui ne portent pas
  • Capacités techniques sans résultats
  • Réalisations de l'entreprise qui n'aident pas le lecteur

Processus :

  1. Lisez chaque affirmation et demandez littéralement « et alors ? »
  2. Surlignez les affirmations qui manquent de réponse
  3. Ajoutez le pont bénéfice ou la signification plus profonde
  4. Assurez-vous que les avantages sont liés aux désirs réels du lecteur

Après cette passe : Revenez à la Passe Voix et Ton, puis Clarté.


Passe 4 : Prouvez-le

Objectif : Chaque affirmation est-elle étayée par des preuves ?

Éléments à vérifier :

  • Affirmations non étayées
  • Preuve sociale manquante
  • Assertions sans justification
  • « Meilleur » ou « leader » sans preuve

Types de preuves à rechercher :

  • Témoignages avec noms et détails
  • Références à des études de cas
  • Statistiques et données
  • Validation par des tiers
  • Garanties et inversions de risque
  • Logos clients
  • Notes d'avis

Lacunes de preuves courantes :

  • « Approuvé par des milliers de personnes » (lesquelles ?)
  • « Leader de l'industrie » (selon qui ?)
  • « Nos clients nous adorent » (montrez-les en train de le dire)
  • Résultats sans détails

Processus :

  1. Identifiez chaque affirmation qui a besoin de preuve
  2. Vérifiez si une preuve existe à proximité
  3. Signalez les assertions non étayées
  4. Recommandez d'ajouter une preuve ou d'adoucir les affirmations

Après cette passe : Revenez à la Passe Et alors ?, Voix et Ton, puis Clarté.


Passe 5 : Spécificité

Objectif : Le contenu est-il suffisamment concret pour être convaincant ?

Éléments à vérifier :

  • Langage vague (« améliorer », « renforcer », « optimiser »)
  • Déclarations génériques qui pourraient s'appliquer à n'importe qui
  • Chiffres ronds qui semblent inventés
  • Détails manquants qui rendraient le texte réel

Améliorations de la spécificité :

VagueSpécifique
Gagner du tempsGagner 4 heures chaque semaine
De nombreux clients2 847 équipes
Résultats rapidesRésultats en 14 jours
Améliorer votre flux de travailRéduire de moitié votre temps de reporting
Super supportRéponse sous 2 heures

Problèmes de spécificité courants :

  • Adjectifs qui font le travail que les noms devraient faire
  • Avantages sans quantification
  • Résultats sans délais
  • Affirmations sans exemples concrets

Processus :

  1. Surlignez les mots et expressions vagues
  2. Demandez « Cela peut-il être plus spécifique ? »
  3. Ajoutez des chiffres, des délais ou des exemples
  4. Supprimez le contenu qui ne peut pas être rendu spécifique (c'est probablement du remplissage)

Après cette passe : Revenez à la Passe Prouvez-le, Et alors ?, Voix et Ton, puis Clarté.


Passe 6 : Émotion Renforcée

Objectif : Le contenu fait-il ressentir quelque chose au lecteur ?

Éléments à vérifier :

  • Langage plat et informatif
  • Déclencheurs émotionnels manquants
  • Points de douleur mentionnés mais non ressentis
  • Aspirations énoncées mais non évoquées

Dimensions émotionnelles à considérer :

  • La douleur de l'état actuel
  • La frustration face aux alternatives
  • La peur de manquer quelque chose
  • Le désir de transformation
  • La fierté de faire des choix intelligents
  • Le soulagement de résoudre le problème

Techniques pour renforcer l'émotion :

  • Peignez l'état « avant » de manière vivante
  • Utilisez un langage sensoriel
  • Racontez des micro-histoires
  • Faites référence à des expériences partagées
  • Posez des questions qui incitent à la réflexion

Processus :

  1. Lisez pour l'impact émotionnel — est-ce que cela vous touche ?
  2. Identifiez les sections plates qui devraient résonner
  3. Ajoutez de la texture émotionnelle tout en restant authentique
  4. Assurez-vous que l'émotion sert le message (pas de manipulation)

Après cette passe : Revenez à la Passe Spécificité, Prouvez-le, Et alors ?, Voix et Ton, puis Clarté.


Passe 7 : Zéro Risque

Objectif : Avons-nous supprimé toutes les barrières à l'action ?

Éléments à vérifier :

  • Frottements près des appels à l'action (CTA)
  • Objections non traitées
  • Signaux de confiance manquants
  • Prochaines étapes floues
  • Coûts cachés ou surprises

Réducteurs de risque à rechercher :

  • Garanties de remboursement
  • Essais gratuits
  • « Pas de carte de crédit requise »
  • « Annulez à tout moment »
  • Preuve sociale près du CTA
  • Attentes claires de ce qui se passe ensuite
  • Assurances de confidentialité

Problèmes de risque courants :

  • Le CTA demande un engagement sans avoir gagné la confiance
  • Objections soulevées mais non traitées
  • Petits caractères qui créent des doutes
  • « Contactez-nous » vague au lieu d'une prochaine étape claire

Processus :

  1. Concentrez-vous sur les sections près des CTA
  2. Listez chaque raison pour laquelle quelqu'un pourrait hésiter
  3. Vérifiez si le contenu répond à chaque préoccupation
  4. Ajoutez des inversions de risque ou des signaux de confiance si nécessaire

Après cette passe : Revenez une dernière fois sur toutes les passes précédentes : Émotion Renforcée, Spécificité, Prouvez-le, Et alors ?, Voix et Ton, Clarté.


Notation par Panel d'Experts

Utilisez ceci après avoir terminé les Sept Passes pour une porte de qualité supplémentaire. Pour les contenus à fort enjeu (pages de destination, e-mails de lancement, pages de vente), une révision multi-persona par des experts permet de détecter des problèmes qu'une seule perspective manque.

Comment ça marche

  1. Rassemblez 3 à 5 personas d'experts pertinents pour le type de contenu
  2. Chaque persona note le contenu de 1 à 10 dans son domaine d'expertise
  3. Recueillez des critiques spécifiques — pas seulement les notes, mais ce qu'il faut corriger
  4. Révisez en fonction des retours — traitez d'abord les zones les moins bien notées
  5. Re-notez après les révisions — répétez jusqu'à ce que tous les personas notent 7+ et que la moyenne soit de 8+ pour l'ensemble du panel

Panels d'Experts Recommandés

Contenu de page de destination :

  • Rédacteur de conversion (clarté, force du CTA, hiérarchie des avantages)
  • Rédacteur UX (scannabilité, charge cognitive, flux utilisateur)
  • Persona client cible (est-ce que cela me parle ? est-ce que je fais confiance ?)
  • Stratège de marque (cohérence de la voix, précision du positionnement)

Séquence d'e-mails :

  • Spécialiste marketing par e-mail (lignes d'objet, optimisation ouverture/clics)
  • Rédacteur (accroches, storytelling, persuasion)
  • Analyste de filtre anti-spam (drapeaux rouges de délivrabilité, mots déclencheurs)
  • Persona client cible (pertinence, valeur, risque de désabonnement)

Page de vente / format long :

  • Rédacteur de réponse directe (structure de l'offre, traitement des objections, urgence)
  • Persona acheteur sceptique (lacunes de preuve, problèmes de confiance, drapeaux rouges)
  • Éditeur (flux, lisibilité, concision)
  • Spécialiste SEO (couverture des mots-clés, alignement de l'intention de recherche)

Grille de Notation

NoteSignification
9-10Prêt à publier. Aucune amélioration significative.
7-8Solide. Seules des retouches mineures.
5-6Fonctionnel mais avec des lacunes évidentes. Nécessite une autre passe.
3-4Problèmes importants. Révision majeure nécessaire.
1-2Fondamentalement cassé. Repenser l'approche.

Quand l'utiliser

  • Toujours pour les contenus de lancement, pages de tarification et pages de destination à fort trafic
  • Recommandé pour les séquences d'e-mails, pages de vente et textes publicitaires
  • Optionnel pour les articles de blog, contenus sociaux et documents internes
  • Ignorer pour les mises à jour rapides, modifications mineures et contenus à faible enjeu

Vérifications d'Édition Rapides

À utiliser pour des révisions plus rapides lorsqu'un processus complet en sept passes n'est pas nécessaire.

Vérifications au niveau des mots

Supprimez ces mots :

  • Très, vraiment, extrêmement, incroyablement (intensificateurs faibles)
  • Juste, en fait, fondamentalement (mots de remplissage)
  • Afin de (utilisez « pour »)
  • Que (souvent inutile)
  • Choses, trucs (vagues)

Remplacez ceux-ci :

FaibleFort
UtiliserEmployer
ImplémenterMettre en place
Tirer partiUtiliser
FaciliterAider
InnovantNouveau
RobusteSolide
FluideLisse/Harmonieux
De pointeNouveau/Moderne

Attention à :

  • Adverbes (généralement inutiles)
  • Voix passive (passez à l'actif)
  • Nominalisations (verbe → nom : « prendre une décision » → « décider »)

Vérifications au niveau des phrases

  • Une idée par phrase
  • Variez la longueur des phrases (mélangez courtes et longues)
  • Placez l'information importante au début
  • Maximum 3 conjonctions par phrase
  • Pas plus de 25 mots (généralement)

Vérifications au niveau des paragraphes

  • Un sujet par paragraphe
  • Paragraphes courts (2 à 4 phrases pour le web)
  • Phrases d'ouverture fortes
  • Flux logique entre les paragraphes
  • Espaces blancs pour la scannabilité

Liste de Vérification de Révision

Pour un dernier contrôle qualité avant de livrer les modifications, parcourez la liste de vérification complète dans references/checklist.md — couvrant les sept passes ainsi que les éléments de pré-démarrage et de vérification finale.


Problèmes Courants & Corrections

Problème : Mur de Fonctionnalités

Symptôme : Liste de ce que le produit fait sans expliquer pourquoi c'est important Correction : Ajoutez « ce qui signifie que… » après chaque fonctionnalité pour faire le pont vers les avantages

Problème : Langage Corporate

Symptôme : « Tirer parti des synergies pour optimiser les résultats » Correction : Demandez « Comment un humain dirait-il cela ? » et utilisez ces mots

Problème : Ouverture Faible

Symptôme : Commencer par l'historique de l'entreprise ou des déclarations vagues Correction : Commencez par le problème du lecteur ou le résultat souhaité

Problème : CTA Enterré

Symptôme : La demande vient après trop de préparation, ou n'est pas claire Correction : Rendez le CTA évident, précoce et répété

Problème : Pas de Preuve

Symptôme : « Nos clients nous adorent » sans preuve Correction : Ajoutez des témoignages spécifiques, des chiffres ou des références de cas

Problème : Affirmations Génériques

Symptôme : « Nous aidons les entreprises à se développer » Correction : Spécifiez qui, comment et de combien

Problème : Publics Mixtes

Symptôme : Le texte essaie de parler à tout le monde, ne résonne avec personne Correction : Choisissez un public et écrivez directement pour lui

Problème : Surcharge de Fonctionnalités

Symptôme : Lister chaque capacité, submergeant le lecteur Correction : Concentrez-vous sur 3 à 5 avantages clés qui comptent le plus pour le public


Travailler avec les Passes de Révision

Lors de l'édition collaborative :

  1. Effectuez une passe et présentez les résultats — Montrez ce que vous avez trouvé, pourquoi c'est un problème
  2. Recommandez des modifications spécifiques — Ne vous contentez pas d'identifier les problèmes ; proposez des solutions
  3. Demandez le contenu mis à jour — Laissez l'auteur prendre les décisions finales
  4. Vérifiez les passes précédentes — Après chaque série de modifications, revérifiez les passes antérieures
  5. Répétez jusqu'à ce que ce soit propre — Continuez jusqu'à ce qu'une passe complète ne trouve aucun nouveau problème

Ce processus itératif garantit que chaque modification ne crée pas de nouveaux problèmes tout en respectant la propriété de l'auteur sur le contenu.


Références


Édition de Rafraîchissement de Contenu

La révision ne concerne pas uniquement les nouveaux contenus. Les pages existantes se dégradent avec le temps — statistiques obsolètes, exemples périmés et voix de marque qui a dérivé. Utilisez le cadre de rafraîchissement de contenu lorsque le trafic diminue, les données sont obsolètes ou que le produit a changé.

Pour la liste de vérification complète de rafraîchissement, la matrice de décision rafraîchissement vs. réécriture et le guide de cadence : Voir references/content-refresh.md


Questions Spécifiques à la Tâche

  1. Quel est l'objectif de ce contenu ? (Notoriété, conversion, rétention)
  2. Quelle action les lecteurs doivent-ils entreprendre ?
  3. Y a-t-il des préoccupations ou des problèmes connus spécifiques ?
  4. Quelles preuves/éléments de preuve avez-vous à disposition ?
  5. S'agit-il d'un nouveau contenu ou d'un rafraîchissement d'un contenu existant ?

Compétences Connexes

  • copywriting : Pour rédiger un nouveau contenu à partir de zéro (utilisez cette compétence pour éditer après avoir terminé votre premier brouillon)
  • cro : Pour une optimisation plus large de la page au-delà du contenu
  • marketing-psychology : Pour comprendre pourquoi certaines modifications améliorent la conversion
  • ab-testing : Pour tester différentes versions de contenu afin de déterminer laquelle convertit le mieux

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions

ads

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions

ai-seo

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions

analytics

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions

aso

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions

attribution

When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions

cold-email

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions

co-marketing

When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says

community-marketing

Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \

competitor-profiling

When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions

competitors

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions

content-strategy

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions

copywriting

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says

coreyhaines31/ab-test-setup

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program," or "experiment playbook." Use this whenever someone is comparing two approaches and wants to measure which performs better, or when they want to build a systematic experimentation practice. For tracking implementation, see analytics-tracking. For page-level conversion optimization, see page-cro.

coreyhaines31/analytics-tracking

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wants to measure marketing results. For A/B test measurement, see ab-test-setup.

coreyhaines31/aso-audit

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store or Google Play URL and wants to improve it.

coreyhaines31/competitor-alternatives

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.

coreyhaines31/email-sequence

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding-cro.

coreyhaines31/form-cro

When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," "contact form," "nobody fills out our form," "form abandonment," "too many fields," "demo request form," or "lead form isn't converting." Use this for any non-signup form that captures information. For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro.

Skills associés