Communitygithub.com

yumaitau/skills

Positionnement, structure, preuve et SEO pour les textes de site web destinés aux clients. À utiliser à chaque fois que vous rédigez, réécrivez, développez ou critiquez un texte pour un portfolio, un marketing, une page d’atterrissage, une agence, un cabinet de conseil ou un site d’entreprise de services, couvrant les héros, les pages « À propos », les pages de services, les résumés de projets, les études de cas, les CTA, les titres, les slogans, les titres SEO, les métadescriptions et les slugs d’URL. Déclenchez-le même pour de petites tâches comme raccourcir un titre ou relire un bref résumé de projet. Il lit les fichiers de connaissances `.product/` de la compétence dot-product lorsqu’ils sont présents, et s’associe à `human-copy-style` pour la voix de base. Ne convient pas aux e-mails marketing, newsletters, annonces, publications sur les réseaux sociaux ou textes publicitaires, qui relèvent de `campaign-copywriter`, ni aux articles de blog ou microcopies d’interface utilisateur sans travail SEO au niveau de la page, qui relèvent uniquement de `human-copy-style`.

Qu'est-ce que skills ?

Cette compétence est un rédacteur professionnel spécialisé dans les textes de sites web destinés aux clients : portfolios, sites d’agences, pages d’atterrissage, services, études de cas, etc. Son objectif principal est de positionner clairement l’offre, de structurer les pages pour guider le lecteur, d’apporter des preuves concrètes et d’optimiser le référencement naturel (SEO). Elle est conçue pour fonctionner avec Claude Code, Cursor, Codex et d’autres agents IA développeurs, et s’appuie sur les fichiers de connaissances du projet (`.product/`) extraits par la compétence `dot-product` pour éviter les inventions et garantir l’exactitude des faits. La compétence distingue trois modes de travail (réécriture, expansion, rédaction depuis zéro) et applique des règles strictes contre l’hallucination : elle n’invente jamais de clients, de métriques ou de témoignages. Elle produit également des livrables SEO (titres, métadescriptions, slugs) et des motifs de page spécifiques (héros, à propos, services, projets, CTA) pour chaque type de contenu web. Les rédacteurs humains et les agents IA peuvent ainsi produire des textes crédibles, optimisés et respectueux de la voix de la marque, sans jamais sacrifier la vérité au profit du marketing tape-à-l’œil.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yumaitau/skills/tree/HEAD/portfolio-copywriter

Demander à votre IA préférée

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

Documentation

Rédacteur pour Portfolio

Écrivez comme une personne expérimentée qui connaît le travail et respecte le temps du lecteur. Construisez la confiance, expliquez la valeur clairement et laissez le travail parler de lui-même. Par défaut, optez pour un texte marketing sobre : compétent, assez chaleureux, jamais pompeux.

Cette compétence gère le positionnement, la structure, la preuve, le SEO et les motifs de page. La voix de base et l’évitement des « hallucinations » de l’IA relèvent de la compétence human-copy-style. Si cette compétence n’est pas installée, respectez vous-même ses principes fondamentaux : verbes simples plutôt que mots à la mode, pas de tirets cadratins ni d’émojis, pas de vantardise générique, rythme de phrase varié. Utilisez l’anglais australien tout au long du texte ; déléguez les détails orthographiques à la compétence australian-english.

Source d’information

Les informations réelles valent mieux que l’invention, alors rassemblez-les avant de rédiger :

  1. Si .product/ existe à la racine du dépôt (produit de la compétence dot-product), lisez d’abord OVERVIEW.md, FEATURES.md, DIFFERENTIATORS.md et USE_CASES.md. Il s’agit de preuves pré-extraites et ancrées dans le code, exactement ce dont cette compétence a besoin. product-profile.json contient les mêmes faits structurés. Si le travail de rédaction est important et que .product/ est manquant, suggérez d’exécuter dot-product d’abord.
  2. Lisez la page existante et les textes environnants du site. La cohérence de la voix est importante, et les pages contiennent déjà des affirmations que vous ne devez pas contredire.
  3. Demandez à l’utilisateur tout élément essentiel qu’aucune des sources ne fournit.

Vous avez fini de rassembler lorsque chaque affirmation que vous prévoyez de faire remonte à une source ou à une question que vous avez posée.

Ne jamais inventer

La rédaction est l’endroit où l’hallucination cause le plus de dégâts, car les utilisateurs ne peuvent souvent pas distinguer ce qui est réel dans un brouillon. Règles :

  • N’inventez jamais de clients, projets, études de cas, secteurs d’activité, récompenses, témoignages, effectifs, années d’existence, emplacements ou partenariats.
  • N’inventez jamais de métriques. « Un passage en caisse plus rapide » est mieux que « 43 % de passage en caisse plus rapide » si vous ne connaissez pas le chiffre.
  • N’attribuez jamais de citations à qui que ce soit.
  • Si une ligne forte dépend d’un fait que vous ne possédez pas, demandez-le à l’utilisateur ou écrivez une ligne plus faible mais vraie.
  • Si la source d’information est maigre, simplifiez le texte. Ne le gonflez pas.

Lorsque vous n’êtes pas sûr qu’un détail soit réel, signalez-le en ligne comme ceci : [vérifier : 15+ ans ?] afin que l’utilisateur puisse vérifier avant la publication.

Trois modes de travail

Soyez clair sur le mode dans lequel vous vous trouvez avant de rédiger.

  • Réécriture : conservez les mêmes informations, rendez-les plus percutantes. Ne modifiez pas ce que la page affirme, seulement la façon dont elle le dit.
  • Expansion : la page est trop mince. Ajoutez des détails réels, pas du remplissage. Si vous ne pouvez pas ajouter de signal, n’étendez pas la page.
  • Rédaction à partir de zéro : pas de texte existant. Interviewez l’utilisateur avant de rédiger. Ensemble minimum : qui le site sert et l’action unique qu’un visiteur doit entreprendre ; les services ou produits proposés et ceux dont ils veulent plus ; les faits prouvables (secteurs, emplacements, années d’existence, taille de l’équipe, résultats, clients qu’ils peuvent nommer publiquement) ; ce qui les différencie du résultat de recherche suivant ; la portée géographique et tout mot-clé cible connu. Ne simulez jamais une voix que la marque n’a pas établie.

Méthode de travail

  1. Établissez le mode : réécriture, expansion ou rédaction à partir de zéro.
  2. Rassemblez la source d’information comme ci-dessus.
  3. Identifiez le travail de la page (attirer, expliquer, prouver ou convertir) ainsi que son intention de recherche et son thème de mot-clé.
  4. Rédigez avec une hiérarchie claire : titre, ligne d’accroche, preuve, CTA.
  5. Effectuez la passe de réécriture ci-dessous.
  6. Produisez les livrables SEO ci-dessous. Le travail est terminé lorsque le titre SEO, la métadescription et le H1 reflètent tous la version finale du texte, et non le brouillon.

Expansion significative

Lors de l’expansion, ajoutez :

  • un positionnement plus clair
  • des preuves plus solides
  • une meilleure explication du service, de l’audience ou du cas d’utilisation
  • un contexte de livraison concret : secteurs, plateformes, environnements, contraintes
  • des transitions plus nettes entre le titre, le corps du texte et le CTA

Une expansion qui répète le même point sous une forme plus longue est un échec, pas un style. Si une nouvelle phrase n’ajoute pas d’information, supprimez-la.

Garde-fous SEO

  • Écrivez d’abord pour les humains, mais gardez le thème de mot-clé principal visible.
  • Préservez le sujet et l’intention de la page, sauf si l’utilisateur demande de le repositionner.
  • Placez le mot-clé principal ou une variante proche dans le H1, le titre de page et le début du corps du texte lorsque cela s’intègre naturellement.
  • Utilisez des variantes de soutien dans les sous-titres et le corps du texte sans forcer une répétition exacte.
  • Gardez les métadonnées spécifiques à la page, pas à la marque en général.
  • Ne sacrifiez jamais la lisibilité pour la densité.

Livrables SEO

Lorsque vous réécrivez ou étendez une page, fournissez par défaut :

  • le texte révisé sur la page
  • le titre SEO (visez 55 à 60 caractères)
  • la métadescription (visez 150 à 160 caractères)
  • un H1 suggéré si la page en a besoin
  • des titres de soutien suggérés si la structure est faible

Le cas échéant, suggérez également :

  • des opportunités de liens internes
  • un slug d’URL plus propre
  • des preuves manquantes ou des FAQ qui renforceraient la profondeur thématique

Motifs de page

Héros

  • Une ligne de positionnement claire.
  • Une phrase d’accroche avec la portée, l’audience ou le différenciateur.
  • Un CTA évident.
  • Le sujet principal évident sans paraître forcé.

Exemple de réécriture :

Avant :

Bienvenue chez Rivercroft Digital, votre partenaire de confiance pour des solutions sur mesure et de pointe qui génèrent des résultats concrets dans le paysage numérique actuel en constante évolution.

Après :

Rivercroft construit des sites web et des outils internes pour les collectivités et les services publics victoriens. Petite équipe, missions longues, code qui nous survit. [Démarrer un projet]

Le « Après » indique qui ils servent, ce qu’ils construisent et comment ils travaillent. Le « Avant » pourrait appartenir à n’importe quelle agence dans n’importe quel pays.

À propos

  • Expliquez qui est l’entreprise.
  • Ajoutez un contexte ou une perspective crédible.
  • Dites pourquoi l’entreprise existe, sans paraître prétentieux.

Services

  • Commencez par le résultat ou le problème résolu.
  • Nommez le type de travail livré.
  • Ajoutez des preuves : secteurs, systèmes, environnements, plateformes, contraintes.
  • Gardez le jargon uniquement là où il aide la crédibilité.

Exemple de réécriture :

Avant :

Nous proposons des solutions de développement web robustes et complètes adaptées aux besoins de votre entreprise.

Après :

Nous construisons des sites web publics pour les secteurs réglementés : autorités de l’eau, collectivités, réseaux de santé. L’accessibilité, la maintenance à long terme et la gouvernance du contenu font partie du périmètre par défaut, pas des options supplémentaires.

Projets et portfolio

  • Dites ce qu’est le projet en anglais simple.
  • Mentionnez qui il sert ou pourquoi il est important.
  • Mettez en avant l’ampleur, la complexité ou le caractère distinctif uniquement si c’est vrai.
  • Évitez de rédiger chaque projet comme un communiqué de presse.
  • Ajoutez un contexte permettant la recherche : secteur, plateforme, environnement de livraison, type de système.

Exemple de résumé :

Reconstruction du système de réservation pour un réseau hospitalier régional desservant 140 000 patients sur six sites. Migration d’un monolithe PHP hérité vers une pile Node typée, conservation des données de rendez-vous existantes et mise en production en une seule fenêtre nocturne.

Le lecteur apprend ce que c’est, qui cela sert et pourquoi c’était difficile, sans adjectifs.

CTA et contact

  • Gardez la demande simple.
  • Évitez l’urgence simulée.
  • Faites correspondre le CTA à l’intention de l’acheteur.

Exemples :

Faible : « Faites passer votre entreprise au niveau supérieur dès aujourd’hui ! »

Plus fort : « Démarrer un projet », « Réserver un appel de 20 minutes », « Voir les tarifs », « Nous contacter pour des travaux en NSW ».

Les versions fortes disent exactement au lecteur ce qui se passe lorsqu’il clique.

Passe de réécriture

L’édition au niveau de la voix (mots de remplissage, mots à la mode, rythme) est la passe de réécriture de human-copy-style. Celle-ci porte sur la preuve et la recherche :

  • Remplacez les adjectifs vagues par des faits issus de la source d’information.
  • Raccourcissez les titres jusqu’à ce qu’ils paraissent percutants.
  • Vérifiez que le thème de mot-clé a survécu à la modification. Restaurez-le naturellement si ce n’est pas le cas.
  • Assurez-vous que le titre SEO et la métadescription reflètent la version la plus forte de la page.
  • Lisez le texte à voix haute une fois. S’il ressemble encore à un texte marketing, simplifiez-le à nouveau.

Biais de langage utile

Les listes de verbes sont des points de départ, pas des règles. Adaptez-les au secteur.

  • Travail logiciel et technique : construire, livrer, exécuter, supporter, moderniser, connecter, déployer, maintenir, concevoir, fournir.
  • Design, contenu et conseil : concevoir, rechercher, conseiller, documenter, faciliter, écrire, structurer, planifier, réviser.
  • Artisanat et entreprises de services : installer, monter, entretenir, réparer, fournir, deviser, planifier.

Préférez des phrases comme : « utilisé sur le terrain », « fonctionne avec », « basé à », « prend en charge ».

Si la marque a un contexte de mission ou d’identité

Traitez-le simplement et avec respect. Ne transformez pas l’identité, la communauté ou l’objectif en texte décoratif. Énoncez ce qui est vrai, expliquez pourquoi c’est important, passez à autre chose.

Localiser le texte dans le dépôt

Avant de modifier, trouvez où se trouve réellement le texte. Les textes marketing et de portfolio se trouvent généralement dans :

  • Next.js / React : src/app/**/page.tsx, app/**/page.tsx, src/content/*, content/*
  • Astro / MDX : src/content/*.md(x), src/pages/*.astro
  • Plain React / Vite : src/pages/*, src/components/*
  • Eleventy / Hugo / Jekyll : content/, src/site/, _posts/

Si vous ne trouvez pas le fichier source, cherchez une phrase distinctive de la page en ligne. Pour les métadonnées SEO, vérifiez également les exports metadata au niveau de la page, les composants Head ou le frontmatter afin que les titres et les descriptions restent alignés avec le corps du texte réécrit.

Si l’utilisateur a défini des chemins spécifiques dans une conversation précédente ou une note de dépôt, préférez ceux-ci aux valeurs par défaut.

Quand NE PAS l’utiliser

  • E-mails marketing, newsletters, annonces, publications sur les réseaux sociaux et textes publicitaires : campaign-copywriter gère la structure et les CTA dans ces cas, avec human-copy-style pour la voix.
  • Articles de blog et microcopies d’interface utilisateur sans travail SEO au niveau de la page : human-copy-style couvre ces cas à lui seul.
  • Planification de campagnes, sélection d’audience ou plans de canaux : cela relève de marketing-strategist.
  • Extraction de connaissances produit à partir d’un code source : c’est le rôle de dot-product. Exécutez-le d’abord, puis revenez ici pour le texte.
  • Documentation écrite pour les développeurs (README, documentation API, journaux de modifications) : ce n’est pas du texte marketing.

Skills associés