ux-writingpar content-designer

UX Writing Skill.

Une skill Claude Code et Codex pour la recherche UX : microcopy centrée utilisateur et accessible : boutons, libellés, erreurs, formulaires, onboarding.

UX et recherche

Télécharger OpenDesign Voir le guide d'utilisation

content-designer/ux-writing-skill · SKILL.mdSKILL.md

--- name: ux-writing description: Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and … --- ## When to Use This Skill ## Core UX Writing Principles ## UX Text Patterns ## Voice and Tone ## Editing Process ## Workflow

Front matter et titres de section lus depuis le fichier source le 14 septembre 2026 · 15 313 caractères au total

01 Ce qu'il fait

Ce que fait le Skill ux-writing dans Claude Code et Codex

Résumé, workflow et sorties, tous lus dans le SKILL.md du skill.

D'après le SKILL.mdLu le 14-09-2026 · pas une exécution enregistrée

Dans les termes du Skill

Un guide pratique pour rédiger et éditer les microcopies dans les produits numériques : boutons, libellés, titres, messages d'erreur, notifications, formulaires, onboarding, états vides, messages de réussite et texte d'aide. Chaque texte est évalué selon quatre standards de qualité — pertinent, concis, conversationnel et clair — et chaque type d'élément a un modèle, comme [Verbe] [objet] pour les boutons et [Ce qui a échoué].

[Pourquoi/contexte]. [Quoi faire]. pour les erreurs. La voix est traitée comme une personnalité de marque fixe, tandis que le ton varie selon les utilisateurs frustrés, confus, confiants, prudents et satisfaits. Le skill ajoute des règles d'accessibilité, des repères de phrases et de caractères fondés sur la recherche, un processus d'édition en quatre phases, et des fichiers de référence pour les chartes de voix, l'utilisabilité du contenu et Figma MCP.

Ce qu'il produit

Le texte de l'interface lui-même à travers les boutons, libellés, messages d'erreur, notifications, formulaires et éléments associés.
Une charte de voix produit, construite avec references/voice-chart-template.md, associant les concepts de marque aux caractéristiques de voix et des exemples à faire/à éviter.
Messages d'erreur rédigés à partir de templates/error-message-template.md, un modèle à remplir pour des messages d'erreur efficaces.
Un flux d'onboarding conçu à partir de templates/onboarding-flow-template.md, le cadre pour des expériences d'onboarding claires.

Voir l'exemple de prompt ↗

Fonctionnement

01
Partir du contexte
La première étape consiste à comprendre les objectifs de l'utilisateur, les objectifs métier, les contraintes techniques et l'état émotionnel de l'utilisateur avant tout brouillon.
02
Rédiger à partir de la parole
Commencez par ce que vous diriez à voix haute, appliquez le pattern de l'élément, pesez la voix et le ton, puis mettez en avant l'information importante.
03
Éditer en quatre passes ordonnées
Le fichier prescrit quatre phases, exécutées dans l'ordre : utile, concis, conversationnel, clair, chacune avec ses propres questions de vérification.
04
Faire correspondre le ton au moment
Le ton est adapté selon l'état émotionnel de l'utilisateur — frustré, confus, confiant, prudent, satisfait — tandis que la voix reste constante.
05
Tester et mesurer
Passez en revue avec l'équipe, testez avec des utilisateurs si possible, puis mesurez le taux d'achèvement des tâches et la compréhension plutôt que l'opinion.

02 Trouvez celui qui vous convient

Quand utiliser le ux-writing Skill

Utilisez le ux-writing skill dans Claude Code ou Codex lorsque la tâche est une recherche UX de ce type. Domaine d'application et limites ci-dessous tirés du fichier du skill.

Bon choix

Rédiger un texte inédit pour les éléments d'interface : boutons, libellés, titres, messages et formulaires.
Éditer un texte UX existant déjà publié mais qui se lit mal.
Auditer le contenu d'un produit pour la cohérence et l'utilisabilité entre les écrans.
Rédiger des messages d'erreur, de notification et de succès qui expliquent et permettent de récupérer.
Établir la voix et le ton d'un produit, ou concevoir des flux d'onboarding et conversationnels.

Connaître les limites

Ne fonctionnera pas dans ChatGPT — le fichier indique qu'il s'exécute avec Codex CLI/IDE et que ChatGPT ne peut pas installer ni utiliser de skills.
Les explications d'échec vagues comme « Quelque chose s'est mal passé » sont listées comme à éviter.
L'humour trop appuyé est à exclure dans les contextes sérieux.

Quoi fournir

L'état émotionnel et les enjeux de l'utilisateurLe ton est choisi selon ce que ressent l'utilisateur et l'importance de l'enjeu — un changement de thème à faible enjeu se lit différemment de la suppression d'un compte.
Contraintes d'accessibilitéSi le contexte visuel suffit pour un élément, ou si des libellés explicites et des labels ARIA sont nécessaires pour les technologies d'assistance.

03 Dans le skill

Les règles que le skill ux-writing donne à Claude Code et Codex

8 instructions concrètes, valeurs par défaut et limites que le SKILL.md fixe pour l'agent — la partie du fichier qui change le résultat.

Lignes de 40 à 60 caractères
Les lignes de texte d'interface doivent tenir sur 40 à 60 caractères, la plage de lisibilité maximale fixée par le fichier.
Boutons : 2-4 mots
Les libellés de boutons et de CTA doivent compter 2 à 4 mots, avec 6 mots comme plafond absolu.
Langage simple selon le public
Rédigez à un niveau de lecture de 7e année pour un public général et de 10e année pour les contextes professionnels.
Voix active 85 % du temps
Environ 85 % du texte doit être à la voix active.
Les erreurs suivent un ordre fixe
Le texte d'erreur indique ce qui a échoué, puis pourquoi ou le contexte, puis quoi faire — dans cet ordre.
Ne jamais blâmer l'utilisateur
Le texte d'erreur reconnaît le problème sans blâmer la personne qui le lit.
Jamais la couleur seule
Le sens n'est jamais porté par la couleur seule ; les indicateurs visuels sont associés à du texte.
Messages d'erreur : 12-18 mots
Un message d'erreur, y compris sa solution, doit compter entre 12 et 18 mots.

04 Mettez-le en pratique

Installer ux-writing dans Claude Code ou Codex

Une commande npx skills add, puis une première tâche dans votre agent et une checklist pour le résultat.

Ajouter ux-writing à Claude Code, Codex ou votre agent

Exécutez-la dans votre projet ; l'installateur demande à quel agent l'ajouter.

Terminal

npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

Forme générique de la CLI skills pour SKILL.md ; le dépôt peut documenter son propre chemin.

Donnez au Skill une Première Tâche de Recherche UX

Rédigé dans les termes propres du skill ; remplacez les parties entre crochets par votre contenu.

Starter prompt

Write the microcopy for our [checkout] flow: the payment button label, the field labels, and the message a user sees when their card is declined. The user will be frustrated, so keep the tone empathetic and give a clear next step. Then run the four-phase edit and flag any line over 60 characters.

Source : rédigé à partir du SKILL.md, dans les termes propres du skill.

Vérifiez le premier résultat

Ce que le SKILL.md lui-même présente comme un résultat correct :

Lisez le texte à voix haute et demandez-vous si vous le diriez vraiment ainsi.
Passez les textes dans un outil de lisibilité ; les fichiers Hemingway Editor et le score Flesch-Kincaid.
Vérifiez les repères de compréhension : 8 mots ou moins pour une compréhension à 100 %, 14 mots ou moins pour 90 %.
Parcourez references/content-usability-checklist.md, la checklist fournie pour évaluer la qualité du texte UX.
Faites relire l'équipe et tester auprès des utilisateurs, en mesurant l'achèvement des tâches et la compréhension plutôt que le goût.
Pour l'accessibilité, vérifiez que les erreurs sont structurées afin que l'erreur et le libellé du champ soient annoncés ensemble par un lecteur d'écran.

Dans OpenDesign importez ux-writing depuis son lien SKILL.md : Plugins → Add → Skill → Import from link, puis sélectionnez-le dans la barre supérieure.

Télécharger OpenDesign Lire le démarrage rapide

05 Open source, traçable

Source, licence et vérification

D'où proviennent les faits de cette page et quand ils ont été vérifiés pour la dernière fois.

Author: content-designer
Repository: github.com/content-designer/ux-writing-skill Branche main
Fichier du skill: SKILL.md Somme de contrôle du contenu enregistrée lors de la vérification ; commit 98cacde
License: MIT De LICENSE.
Étoiles du dépôt: 168 Instantané GitHub pris le 14 septembre 2026 pour l'ensemble du dépôt content-designer/ux-writing-skill. Il ne s'agit pas d'une note ni d'un compteur d'utilisation pour ux-writing.
Vérifié par OpenDesign: 2026-09-14 Le fichier source, le chemin, le texte de licence et le nombre d'étoiles ont été vérifiés. Non intégré dans OpenDesign main (vérifié le 2026-08-28) ; aucune exécution en conditions réelles n'a été enregistrée sur cette page.

Dans le SKILL.md

Quand utiliser ce skillSix déclencheurs : rédiger ou modifier du texte d'interface, des messages, des flux conversationnels, la voix, auditer le contenu.
Principes fondamentaux de la rédaction UXLes quatre standards de qualité, ainsi que la concision, la clarté, le ton conversationnel et les pratiques centrées sur l'utilisateur.
Modèles de texte UXFormats et exemples pour les titres, boutons, quatre types d'erreurs, messages de succès, états vides, formulaires et notifications.
Voix et tonConstruire une voix constante ; adapter le ton selon l'état émotionnel de l'utilisateur et le type de contenu.
Processus d'éditionQuatre passes ordonnées — utile, concis, conversationnel, clair — chacune avec ses questions de vérification.
WorkflowComprendre le contexte, rédiger, éditer de façon itérative à travers les quatre phases, puis tester et mesurer.
Accessibilité dans l'UX writingExigences pour lecteur d'écran, cognitives, multimodales et de langage clair, avec exemples de mauvais et bons motifs.
Repères pour les textes UXObjectifs de phrases et de caractères par élément, taux de compréhension et niveaux de lecture, avec outils de test.
Erreurs courantes à éviterOnze anti-modèles, de la voix passive et des libellés génériques aux liens inaccessibles.
Référence rapideRappels en une ligne sur la casse de phrase, les boutons à l'impératif, la focalisation sur l'utilisateur, les verbes précis et la mise en avant des informations.
RessourcesNeuf fichiers livrés : guide d'accessibilité, tableau de voix, checklist d'utilisabilité, exemples de motifs, modèles et intégration Figma.

Description du skill lui-même

« Créez des textes d'interface (microcopy) centrés sur l'utilisateur et accessibles pour les produits numériques, incluant boutons, étiquettes, messages d'erreur, notifications, formulaires, onboarding, états vides, messages de succès et textes d'aide. Utilisez ce skill lors de la rédaction ou modification de tout texte apparaissant dans des applications, sites web ou interfaces logicielles, lors de la conception de flux conversationnels, de l'établissement de directives de voix et de ton, de l'audit de contenu produit pour la cohérence et l'utilisabilité, de la révision de chaînes d'interface, ou de l'amélioration de textes d'interface existants. Applique les meilleures pratiques d'UX writing basées sur quatre standards de qualité — intentionnel, concis, conversationnel et clair. Inclut des directives d'accessibilité, des références basées sur la recherche (longueur de phrase, taux de compréhension, niveaux de lecture), des modèles d'erreur étendus, des cadres d'adaptation du ton et des documents de référence complets. »

Description front-matter de SKILL.md. Le fichier complet fait environ 15 313 caractères. Lire le fichier complet sur GitHub.

06 Avant d'installer

Questions sur le skill ux-writing

Les réponses proviennent du SKILL.md tel que lu le 2026-09-14, et non d'une exécution enregistrée.

Quels agents peuvent exécuter ce skill ?

Il est conçu pour Claude, Codex, Cursor et tout autre agent prenant en charge la spécification agent skills. ChatGPT est explicitement exclu — il ne peut pas installer ni utiliser de skills.

Puis-je l'utiliser sur du contenu déjà existant ?

Oui. Le skill couvre l'édition de textes UX existants, la révision des chaînes d'interface et l'audit du contenu produit pour la cohérence et l'utilisabilité, pas seulement la rédaction à partir de zéro.

Couvre-t-il l'accessibilité ?

Oui. La rédaction accessible fait l'objet de sa propre section, couvrant l'optimisation pour lecteur d'écran, l'accessibilité cognitive, la communication multimodale et le langage clair, avec un minimum de contraste de couleur WCAG AA de 4,5:1.

UX Writing

Exécutez ux-writing sur une vraie tâche de recherche UX.

Téléchargez OpenDesign, importez ux-writing depuis son lien SKILL.md, collez la consigne ci-dessus, et lisez le plan avant le résultat.

Télécharger OpenDesign Parcourir tous les skills