clarify

Présentation de la compétence clarify

La compétence clarify aide à reformuler des textes d’interface confus pour que les utilisateurs comprennent ce qui s’est passé, quoi faire ensuite et pourquoi c’est important. Elle est conçue pour le travail de design UI/UX, en particulier lorsqu’un produit comporte des libellés vagues, des messages d’erreur faibles, des instructions difficiles à suivre ou une microcopie techniquement correcte mais malgré tout déroutante pour de vrais utilisateurs.

Dans quels cas clarify est le plus utile

Utilisez clarify lorsque le problème principal ne vient pas d’abord de la mise en page ou du flux d’interaction, mais du texte dans l’interface :

• des libellés de boutons qui n’indiquent pas le résultat attendu
• des messages d’erreur qui décrivent le système au lieu d’aider l’utilisateur
• des états vides sans étape suivante claire
• des textes d’aide de formulaire qui supposent trop de connaissances
• des instructions exactes, mais mentalement lourdes en situation de stress

La compétence clarify convient donc particulièrement aux product designers, UX writers, équipes frontend et fondateurs qui peaufinent des textes visibles par les utilisateurs avant un lancement.

Le vrai rôle de clarify

Concrètement, clarify sert à transformer une copie d’interface brute ou peu claire en un texte :

• plus facile à parcourir
• plus facile à utiliser pour passer à l’action
• mieux adapté au niveau de connaissance de l’utilisateur
• mieux adapté au moment émotionnel

Ce dernier point compte beaucoup. La compétence source demande explicitement le niveau technique de l’utilisateur et son état mental dans le contexte, ce qui est bien plus utile qu’un simple prompt générique du type « rends ça plus clair ».

Ce qui différencie clarify d’un simple prompt de reformulation

Un prompt classique peut produire un texte plus propre. clarify est plus directif sur les raisons pour lesquelles une copie échoue :

• jargon
• ambiguïté
• voix passive
• contexte manquant
• hypothèses implicites
• ton inadapté
• trop ou pas assez de détails

La compétence dépend aussi d’un contexte de design plus large. Elle exige /frontend-design et, si ce contexte n’existe pas encore, /teach-impeccable au préalable. Cette dépendance est importante au moment de l’installation : clarify n’est pas une macro autonome de simple polissage rédactionnel ; elle est pensée pour fonctionner à l’intérieur d’un workflow UX/design plus global.

Comment utiliser la compétence clarify

Installer clarify dans le bon contexte de dépôt

Le parcours d’installation de clarify suit le système de compétences hôte du dépôt pbakaus/impeccable. Si vous utilisez un environnement compatible Skills, ajoutez le dépôt puis invoquez la compétence clarify depuis celui-ci. La compétence elle-même se trouve à l’emplacement suivant :

/.agents/skills/clarify/SKILL.md

Comme les éléments visibles du dépôt n’exposent que SKILL.md, commencez par lire ce fichier avant de supposer l’existence d’autres ressources auxiliaires.

Lisez ce fichier avant votre premier lancement

Commencez par :

• SKILL.md

C’est là que se trouve la vraie logique d’utilisation : préparation requise, critères d’évaluation et déroulé pas à pas de la revue de copie. Aucun script d’assistance ni fichier de référence supplémentaire n’est exposé ici ; la valeur principale vient donc du respect de la séquence prévue par la compétence.

Ne sautez pas la dépendance obligatoire

Avant d’utiliser clarify, la compétence indique d’invoquer :

• /frontend-design

Et si aucun contexte de design n’existe encore :

• /teach-impeccable

C’est le principal frein à l’adoption pour les nouveaux utilisateurs. Si vous sautez cette préparation, vous obtiendrez probablement un texte correct, mais des décisions UX plus faibles. La compétence part du principe que les principes de design et la collecte de contexte sont déjà en place.

Quels inputs fournir à clarify pour de bons résultats

Le minimum exploitable pour utiliser clarify est le texte actuel, plus l’endroit où il apparaît. Vous obtiendrez de meilleurs résultats en ajoutant :

• l’écran ou le flux concerné
• le type exact d’élément UI
• le niveau technique du public visé
• l’état mental de l’utilisateur à ce moment-là
• l’action attendue après lecture
• des contraintes comme le ton, la voix de marque ou la limite de caractères

Sans cela, la compétence peut quand même réécrire le texte, mais elle ne pourra pas choisir de manière fiable le bon niveau de franchise, de détail ou de tonalité émotionnelle.

La meilleure forme de prompt clarify pour le design UI/UX

Une demande faible :

• « Improve this error message: Authentication failed. »

Une demande plus solide :

• « Use clarify for UI/UX Design. Rewrite this login error message for non-technical users on mobile. They are likely frustrated and trying to get back into their account quickly. Current text: ‘Authentication failed.’ We want them to understand the problem and next step without sounding robotic. Keep it under 90 characters if possible.”

Cette seconde formulation apporte les données de décision qui manquent : public, émotion, contexte d’usage sur mobile et critères de réussite.

Transformer un objectif vague en prompt clarify exploitable

Si votre point de départ est « rendre le texte de l’app plus clair », convertissez-le dans cette structure :

1. texte actuel
2. emplacement dans le produit
3. qui est l’utilisateur
4. ce qu’il essaie de faire
5. dans quel état émotionnel il se trouve
6. quelle action il doit entreprendre ensuite
7. les contraintes de longueur ou de ton

Cette structure correspond de près au vrai guide clarify tel qu’on le déduit de la checklist de la compétence.

Workflow conseillé pour une utilisation concrète de clarify

Un workflow fiable ressemble à ceci :

1. Rassembler le contexte produit et design avec /frontend-design.
2. Confirmer le niveau du public et son état mental.
3. Coller la copie d’origine exactement telle qu’elle apparaît.
4. Expliquer l’écran et l’action attendue de l’utilisateur.
5. Demander d’abord un diagnostic, puis des options de reformulation.
6. Choisir une direction, puis itérer sur le ton, la brièveté ou le niveau de précision.

L’étape « diagnostic d’abord » est importante, car la compétence est conçue pour identifier pourquoi une copie n’est pas claire, pas seulement pour la remplacer.

Demandez à clarify de diagnostiquer avant de réécrire

Pour obtenir plus qu’un simple lissage générique par LLM, demandez une sortie en deux temps :

• les problèmes de clarté détectés
• les alternatives améliorées

Exemple :

• « Use clarify. First identify jargon, ambiguity, missing context, assumptions, and tone issues in this onboarding copy. Then provide 3 rewrite options for first-time users.”

Cela aide les équipes à examiner les décisions prises, au lieu de choisir simplement la reformulation qui « sonne » le mieux.

Là où clarify est le plus performant

La compétence clarify est particulièrement efficace sur des textes UI courts et à fort impact, comme :

• les erreurs
• les libellés
• les textes d’aide
• les confirmations
• les avertissements
• les états vides
• les instructions de configuration

Ce sont des endroits où un wording flou crée rapidement de la friction, et où des reformulations sensibles au contexte peuvent réellement améliorer les taux de complétion et la confiance utilisateur.

Là où clarify est moins adapté

Soyez prudent si le vrai problème est :

• un mauvais flux produit
• une fonctionnalité manquante
• une architecture de l’information faible
• une formulation juridique ou de conformité peu modifiable
• une copie marketing longue

Dans ces cas, clarify peut améliorer la lisibilité, mais ne réglera pas le problème de fond.

FAQ sur la compétence clarify

clarify est-il réservé aux UX writers ?

Non. clarify est utile aux designers, PM, ingénieurs et fondateurs qui gèrent des textes d’interface sans être UX writers de formation. La principale condition est de pouvoir fournir suffisamment de contexte sur l’utilisateur et le moment.

clarify est-il adapté aux débutants ?

Oui, dans l’ensemble, à condition de bien voir sa chaîne de dépendances. La compétence source exige /frontend-design, et parfois /teach-impeccable, avant la réécriture. Les débutants qui ignorent cette étape peuvent croire que la compétence est limitée, alors que le workflow prévu repose en réalité sur le contexte avant tout.

Qu’est-ce que clarify fait mieux qu’un simple prompt « réécris ceci » ?

Son principal avantage est le diagnostic structuré. clarify recherche des causes précises de confusion comme le jargon, l’ambiguïté, la voix passive, le contexte manquant et les hypothèses sur le niveau de connaissance de l’utilisateur. Cela mène généralement à des reformulations plus actionnables pour la copie d’interface.

Quand ne faut-il pas utiliser clarify ?

N’utilisez pas clarify si la copie n’est que le symptôme d’un problème produit plus profond. Si les utilisateurs sont perdus parce que le flux est cassé, que les permissions ne sont pas claires ou que l’UI masque des informations essentielles, un meilleur texte ne suffira pas à résoudre le problème.

clarify est-il efficace pour les messages d’erreur ?

Oui. C’est l’un de ses cas d’usage les plus évidents. La compétence prend explicitement en compte l’état mental de l’utilisateur, ce qui est crucial dans des moments de tension comme un échec de connexion, un problème de paiement ou une erreur de validation de formulaire.

clarify peut-il aider sur le ton et la voix de marque ?

Oui, mais seulement si vous fournissez ces contraintes. Si vous voulez quelque chose de « simple mais premium », « amical mais pas ludique » ou « rassurant en situation de stress », dites-le explicitement. Sinon, la compétence optimisera avant tout pour la clarté.

Comment améliorer la compétence clarify

Donnez à clarify l’état de l’utilisateur, pas seulement la phrase

L’amélioration la plus rentable consiste à décrire la situation de l’utilisateur :

• novice ou expert
• calme ou stressé
• en exploration ou en train de récupérer après un échec
• sur desktop ou mobile
• forte attention ou attention faible

Cela influence directement le fait que la meilleure copie doive être plus courte, plus chaleureuse, plus explicite ou plus orientée instruction.

Fournissez l’UI environnante, pas un texte isolé

Un libellé ou un message paraît souvent mauvais parce qu’il manque de contexte autour. Pour améliorer les résultats de clarify, incluez :

• les champs ou boutons proches
• le titre de la page
• l’étape précédente
• l’action attendue ensuite

Une ligne « mauvaise » peut être acceptable sur un écran et nuisible sur un autre.

Demandez plusieurs stratégies de reformulation

Au lieu de demander une seule réponse, demandez des options comme :

• la version la plus courte et la plus claire
• la version la plus rassurante
• la version la plus orientée action

C’est particulièrement utile pour clarify for UI/UX Design, car les équipes doivent souvent arbitrer entre brièveté, ton et niveau de guidage.

Indiquez tôt les contraintes de caractères ou de mise en page

Si le texte doit tenir dans un bouton, un toast, une modale ou un champ de formulaire mobile, précisez-le dès le départ. Sinon, clarify risque de produire un texte plus clair en théorie, mais inutilisable dans l’interface réelle.

Surveillez les modes d’échec fréquents

Même avec clarify, les équipes valident souvent des reformulations qui sont :

• plus claires mais trop longues
• plus amicales mais vagues
• précises mais trop techniques
• soignées mais déconnectées de la tâche réelle

Évaluez les sorties en fonction de l’action attendue de l’utilisateur, pas seulement de la qualité rédactionnelle.

Itérez sur le diagnostic, pas seulement sur la formulation

Si le premier résultat ne convient pas, ne demandez pas seulement une version plus courte. Demandez aussi ce que la compétence a pu mal comprendre :

• mauvaise hypothèse sur le public
• mauvais état mental supposé
• contexte produit manquant
• simplification excessive
• explication insuffisante des prochaines étapes

Cela améliore les sorties suivantes plus vite qu’une simple retouche de surface.

Associez clarify à une revue au niveau de l’écran

En pratique, la meilleure façon d’améliorer la compétence clarify est de l’utiliser comme une partie d’une revue d’écran, pas comme un simple outil de réparation ligne par ligne. Passez en revue tous les textes liés ensemble :

• le titre de la page
• les libellés de champ
• le texte d’aide
• le texte de validation
• le libellé du CTA
• le message de succès ou d’échec

Cela permet de repérer des incohérences qu’une réécriture isolée ne verrait pas.

Gardez un modèle de prompt réutilisable pour l’usage de clarify

Un modèle simple et réutilisable :

• « Use clarify. Context: [screen/flow]. Audience: [user type]. Mental state: [emotion/urgency]. Current copy: [text]. Goal: [desired action]. Constraints: [tone/length/brand]. First diagnose the clarity issues, then give 3 rewrite options.”

Cela rend l’utilisation de clarify plus cohérente entre équipes et réduit les demandes pauvres en contexte qui produisent des résultats génériques.