clarify

Vue d'ensemble

Qu'est-ce que clarify ?

La skill clarify est conçue pour aider les équipes UI et UX à identifier et améliorer les textes d'interface peu clairs ou confus. Cela inclut les messages d'erreur, microtextes, étiquettes et instructions qui peuvent nuire à la compréhension utilisateur. En révisant et réécrivant systématiquement ces éléments, clarify garantit que votre produit communique de manière claire et efficace avec ses utilisateurs.

À qui s'adresse clarify ?

clarify est idéale pour les designers produit, rédacteurs UX, développeurs UI et toute personne responsable des textes d'interface. Si vos utilisateurs rencontrent des difficultés avec des étiquettes ambiguës, des instructions floues ou des messages d'erreur peu clairs, cette skill offre une méthode structurée pour améliorer la clarté et l’ergonomie.

Problèmes que clarify résout

• Jargon technique ou textes d'interface peu clairs
• Instructions ambiguës ou trompeuses
• Ton ou style incohérents dans les microtextes
• Messages d'erreur qui embrouillent au lieu d’aider
• Étiquettes et invites qui laissent les utilisateurs perplexes

Comment utiliser

Étapes d'installation

1. Installez la skill clarify avec la commande suivante :

   npx skills add https://github.com/pbakaus/impeccable --skill clarify

2. Commencez par le fichier SKILL.md pour une vue d'ensemble du workflow et des exigences de clarify.

3. Consultez les fichiers associés comme README.md, AGENTS.md et metadata.json pour plus de contexte et détails d’intégration.

Guide du workflow

• Préparation obligatoire :
  • Avant toute modification, lancez /frontend-design pour recueillir les principes de design et le contexte. Si aucun contexte design n’existe, exécutez d’abord /teach-impeccable.
  • Rassemblez des informations sur le niveau technique de votre audience et leur état d’esprit lors de l’utilisation de l’interface.
• Évaluation des textes actuels :
  • Identifiez les problèmes tels que jargon, ambiguïté, voix passive, longueur excessive, suppositions, contexte manquant ou ton inadapté.
  • Comprenez les objectifs, actions et contraintes des utilisateurs pour chaque élément d’interface.
• Planification et amélioration :
  • Priorisez les éléments de texte à réviser selon leur impact utilisateur.
  • Réécrivez les textes pour plus de clarté, concision et adéquation au public et au contexte.
  • Testez les textes révisés avec de vrais utilisateurs si possible.

Fichiers recommandés à consulter

• Commencez par SKILL.md pour une présentation du processus clarify.
• Explorez les fichiers complémentaires pour approfondir l’intégration et les bonnes pratiques.

FAQ

Quand utiliser la skill clarify ?

Utilisez clarify dès que vous constatez que les utilisateurs sont confus par des textes d’interface, messages d’erreur ou instructions, ou lorsque vous souhaitez améliorer proactivement la qualité de la rédaction UX.

clarify modifie-t-elle le code ou seulement les textes ?

clarify se concentre sur l’amélioration des textes d’interface et microtextes. Elle ne modifie pas la logique backend ni le code applicatif.

Quelle préparation est nécessaire avant d’utiliser clarify ?

Vous devez recueillir le contexte design et comprendre votre audience. Utilisez /frontend-design et, si besoin, /teach-impeccable pour disposer de toutes les informations nécessaires avant de modifier les textes.

Où trouver plus de détails sur le workflow clarify ?

Consultez le fichier SKILL.md dans le répertoire de la skill clarify pour un guide complet et détaillé. Pour plus de ressources, examinez la documentation et les scripts associés dans le dépôt.