Communitygithub.com

abworks-dev/ui-without-noise

Évitez et supprimez les doublons de texte et les composants explicatifs superflus. Utilisez cette compétence lors de la création ou de la révision d'écrans, formulaires, états vides, sous-titres, textes d'aide, bannières, badges ou fiches qui répètent ce que l'interface communique déjà. Conservez les libellés, contraintes, risques, autorisations et états inconnus nécessaires. Ce n'est pas une refonte visuelle générale.

Qu'est-ce que ui-without-noise ?

Cette compétence est un guide de conception d'interface utilisateur qui vise à créer des interfaces épurées et fonctionnelles, en éliminant le bruit textuel et les composants explicatifs redondants. Elle s'applique à tout type de rendu d'interface (écrans, formulaires, états vides, etc.) et pour n'importe quel framework ou langage, à condition que l'équipe suive les règles de l'art. L'objectif est de laisser l'interface parler d'elle-même via des libellés précis, des verbes d'action familiers et une organisation claire, en n'ajoutant du texte d'accompagnement que lorsque celui-ci modifie la compréhension, la décision, l'action suivante ou l'évaluation des risques de l'utilisateur. La compétence fournit huit règles à respecter lors de la génération de contenu, un processus de révision avant la livraison d'un écran modifié (choisir entre conserver, réécrire, fusionner, supprimer ou déplacer chaque chaîne de soutien), et des exemples concrets. Elle insiste sur la conservation des informations nécessaires à une action sécurisée (libellés réels, contraintes, erreurs actionnables, états significatifs) et sur la lisibilité pour tous, y compris en situation de handicap. Elle ne doit pas être utilisée comme un outil de linting automatique, ni pour installer des dépendances ou modifier la configuration globale.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abworks-dev/ui-without-noise/tree/HEAD/skills/ui-without-noise

Demander à votre IA préférée

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

Documentation

Interface sans bruit

Construisez une interface que les gens peuvent utiliser, pas une narration de l'interface. Par défaut, privilégiez le contrôle, son nom, l'objet concerné et l'état nécessaire. N'ajoutez un texte d'accompagnement que lorsqu'il modifie la compréhension, la décision, l'action suivante ou l'évaluation des risques de l'utilisateur.

Lors de la génération

  1. Commencez sans éléments explicatifs. N'ajoutez pas automatiquement de sous-titre, de paragraphe d'introduction, de fiche d'aide, de bannière, de sourcil, de badge ou d'icône à chaque section. N'en ajoutez un que pour un besoin concret de l'utilisateur, pas pour remplir l'espace ou donner l'impression que la page est finie.
  2. Laissez l'interface faire l'explication. Privilégiez des libellés spécifiques, des verbes d'action familiers, le regroupement et le placement. "Créer un espace de travail" n'a pas besoin de "Cliquez ci-dessous pour créer un espace de travail." Si un libellé n'est pas clair, corrigez le libellé avant d'ajouter un paragraphe.
  3. Ne racontez pas l'implémentation. L'architecture, les choix de composants, les clauses de non-responsabilité génériques et les rapports d'avancement des développeurs ne sont pas du contenu produit par défaut. Conservez les faits techniques lorsqu'ils affectent la confidentialité, la portée, la récupération ou la prochaine décision de l'utilisateur.
  4. Dites chaque fait là où il est utile. Un titre, un badge, une phrase et une bannière ne doivent pas répéter le même fait dans la même portée. Conservez les répétitions intentionnelles, comme un résumé d'erreur lié à un champ, ou un avertissement à côté d'une action distincte importante. Ne fusionnez pas les états entre objets, requêtes ou espaces de travail.
  5. Supprimez aussi le conteneur vide. Lorsqu'un texte redondant est supprimé, supprimez également sa fiche, alerte, icône, séparateur ou espace réservé désormais inutile. Ne remplacez pas un paragraphe par un badge décoratif ou une rangée d'icônes. Ne cachez pas un texte inutile dans une infobulle, un contenu repliable, un texte minuscule ou un faible contraste.
  6. Conservez les informations nécessaires pour agir en toute sécurité. Conservez les libellés de champs associés et normalement visibles ; les contraintes réelles de format/longueur/obligation ; les erreurs actionnables ; les états significatifs de chargement, non enregistré, indisponible, d'autorisation et inconnu ; ainsi que la portée et les conséquences des actions dangereuses. Inconnu n'est pas vide, succès ou échec. Ne sous-entendez jamais qu'une capacité indisponible fonctionne.
  7. Rendez les informations nécessaires lisibles. Les états importants et les raisons des actions désactivées doivent être visibles à proximité de leur portée, pas seulement pour les lecteurs d'écran ou au survol. Conservez les noms accessibles, les descriptions, l'urgence des régions live, l'accès clavier et la lisibilité sur écran étroit. La concision ne prime jamais sur l'accessibilité.
  8. Ne créez pas accidentellement un produit plus petit. Conservez les fonctionnalités, données, actions, confirmations, autorisations et le comportement de demande/réessai. Ne supprimez pas une exigence métier ou de sécurité peu claire : signalez l'ambiguïté spécifique au responsable à la place.

Avant de livrer un écran modifié

Examinez l'écran rendu lorsque c'est possible, pas seulement des chaînes isolées. Pour chaque chaîne d'accompagnement et son conteneur, choisissez un résultat :

  • Conserver : elle ajoute un fait, une distinction, une contrainte, une conséquence ou une étape suivante nécessaire.
  • Réécrire : le fait est nécessaire, mais son libellé est vague, répété ou plus long que nécessaire.
  • Fusionner : elle répète le même fait dans la même portée ; conservez le placement et les associations utiles.
  • Supprimer : l'interface communique déjà le fait et aucun sens nécessaire n'est perdu ; supprimez le conteneur vide.
  • Déplacer : seule une aide vraiment peu fréquente se trouve derrière une entrée d'aide explicite et accessible. N'enfouissez pas les actions courantes ou les états importants.

Vérifiez la portée modifiée dans les états normal, vide, erreur, indisponible et inconnu, le cas échéant. Incluez la confirmation destructive si elle est concernée, la navigation au clavier et une fenêtre étroite. Ne prétendez pas avoir effectué une vérification de navigateur ou d'accessibilité qui n'a pas eu lieu. Signalez les changements importants brièvement sous la forme avant → après — raison ; incluez un fait nécessaire délibérément conservé. N'écrivez pas un nouvel essai explicatif dans le produit et n'inventez pas un système de notation pour prouver qu'il est concis.

Exemples

AvantAprès / décision
Espace de travail · Ici, gérez et organisez votre espace de travailEspace de travail — supprimer la description redondante.
Cliquez sur le bouton ci-dessous pour créer un nouveau projet / Créer un projetCréer un projet — conserver l'action réelle.
Nom du projet / Veuillez saisir le nom de votre projet iciNom du projet — conserver le libellé ; supprimer l'instruction évidente.
Fichier / CSV uniquement, max 20 MoConserver les deux — la deuxième ligne est une contrainte réelle.
Enregistré + Sauvegarde réussie + Vos modifications ont été enregistréesUn accusé de réception unique et correctement dimensionné si nécessaire ; pas d'empilement de synonymes.
Résultat de la sauvegarde inconnu. Veuillez d'abord consulter ce résultat, ne pas sauvegarder à nouveau.Conserver — l'incertitude et la prochaine étape sécurisée comptent.
Supprimera définitivement « Plan de voyage » et ses 12 notes, impossible à restaurer.Conserver l'objet, la portée, le nombre et la conséquence.

Limites

Cette compétence est un guide pour le modèle, pas un outil de lint, un hook automatique ou une preuve de conformité. Suivez la terminologie existante du projet, les contrats produits et de sécurité. N'introduisez pas de spécification concurrente et n'installez pas de dépendances, ne contactez pas de services externes et ne modifiez pas la configuration globale pour utiliser cette compétence. Les exemples sont sensibles à la langue : conservez une terminologie cohérente ; n'imposez pas de nombre de mots anglais, de variation de synonymes littéraires, de nombre de polices universel ou d'icône sur chaque ligne.

Skills associés