Communitygithub.com

design-prompt-rewriter

Réécrit les retours vagues d'un non-designer sur l'UI/UX/l'animation en une instruction précise utilisant des principes et du vocabulaire de design.

Qu'est-ce que design-prompt-rewriter ?

Ce skill est conçu pour être utilisé avec des agents IA (comme Claude Code, Cursor ou Codex) afin de transformer des retours informels et généraux d'un utilisateur non-designer – comme « ça clignote », « c'est rigide », « ça s'arrête trop brusquement » – en une instruction de design précise et exploitable par un développeur ou une IA. Il s'appuie sur un tableau de correspondance entre les symptômes exprimés en langage naturel et les principes de conception (easing, ressort, vélocité, momentum, décalage, gestes) issus des références. Le skill traite l'ensemble des messages consécutifs comme une seule conversation et fusionne les retours pour produire une instruction unique. Il ne produit que l'instruction réécrite, sans préambule ni code, et respecte des règles strictes de langage clair et direct. Il prend en charge les plates-formes comme React Native, le web ou SwiftUI, mais reste neutre si la plate-forme n'est pas précisée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hikhtiarta27/agent-skills/tree/HEAD/design-prompt-rewriter

Demander à votre IA préférée

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

Documentation

Réécrivain d'instructions de design

Entrée : un retour vague, en langage courant, sur l'apparence, le mouvement ou le ressenti d'un écran. L'auteur ne connaît pas les termes de design. Sortie : une instruction réécrite qu'un développeur ou une IA peut exécuter. Elle conserve l'intention de l'auteur et remplace les ressentis par des principes de conception.

Source de vocabulaire : references/keywords.md (à lire lorsqu'un symptôme n'est pas couvert par le tableau ci-dessous).

Processus

  1. Lire toute l'entrée. Il peut s'agir de plusieurs messages à la suite (plainte, puis « mieux mais... », puis un nouveau souhait). Traitez-les comme une seule conversation et fusionnez-les en une instruction finale qui reflète l'état le plus récent de ce que l'auteur souhaite.
  2. Pour chaque plainte, trouver la cause derrière le ressenti (tableau ci-dessous), puis nommer la correction avec le mot-clé approprié.
  3. Rédiger l'instruction. Conserver les propres mots de l'auteur (nuages, soleil, carte, feuille). Ne pas renommer ses éléments.
  4. Ne produire que l'instruction réécrite. Pas d'introduction, pas d'explication des termes, pas de code.

Correspondance ressenti-principe

Ce que dit l'auteurCause probableDire plutôt
« clignote », « scintille », « flash »L'état est re-rendu ou effacé à chaque image, pas de continuité, décalage de mise en page ou remontageArrêter de recalculer sous le doigt ; garder une seule valeur animée continue ; fondre enchaîné au lieu d'un changement brutal ; réserver l'espace (pas de décalage de mise en page)
« rigide », « robotique », « mécanique »Minutage linear ou à durée fixe, pas de vélocitéUtiliser un ressort (raideur, amortissement) ou ease-out ; partir de la vélocité du geste
« trop brusque », « s'arrête net », « claque »Pas de décélérationConserver le momentum au relâchement, ease-out / décélération jusqu'à l'arrêt, pas de retour élastique
« lent », « saccadé », « saccade », « lent »Animation des propriétés de mise en page, thread JS, trop de re-rendusExécuter sur le thread UI, animer uniquement transform et opacity, 60fps
« trop rapide », « on ne voit rien »Durée inférieure à ~150 ms ou pas de décalage200 à 300 ms, décaler les éléments de 30 à 80 ms
« trop lent », « traîne », « attend »Durée supérieure à ~500 msRéduire à 200 à 300 ms, sortie plus rapide que l'entrée
« rebondit », « trop »Ressort sous-amorti ou dépassementAugmenter l'amortissement, critique, pas de dépassement
« plat », « ennuyeux », « fade »Pas de retour ou de mouvement secondaireRetour à la pression (échelle ~0.96), léger mouvement ambiant, retour haptique, suivi
« saute », « apparaît »Montage instantanéApparition avec fondu et glissement de 8 à 16 px, ease-out
« disparaît bizarrement »Démontage instantanéAnimation de sortie, ease-in, plus rapide que l'entrée
« suit mon doigt » / « devrait suivre »Guidé par le gesteSuivi 1:1 pendant le glissement, transfert au ressort au relâchement
« continue après avoir lâché »MomentumUtiliser la vélocité de relâchement, décélération / withDecay, ease-out jusqu'à l'arrêt
« fait-le après avoir lâché »Déclenché au relâchementAnimation unique sur la fin du geste, indépendante du doigt
« semble bon marché », « pas premium »Easing par défaut, pas de finitionease-out prononcé (quart / expo), ressort, durées cohérentes, ombre/ flou subtils
« on ne voit pas que c'est cliquable »Pas d'affordance ni de retourAffordance, état pressé, zone tactile de 44 pt
« je ne sais pas si ça a fonctionné »Pas de retourÉtat succès/erreur, toast, haptique, mise à jour optimiste
« se charge bizarrement », « vide puis pop »Pas d'état de chargementSquelette avec effet de scintillement, fondu enchaîné vers le contenu, réserver l'espace
« difficile à lire », « serré »Hiérarchie, espacementHiérarchie visuelle, espace blanc, échelle d'espacement 4/8 pt, contraste 4.5:1
« mauvais sens » (arabe, RTL)Non inverséMiroiter la direction de glissement et les côtés de balayage pour RTL
« donne le vertige »Mouvement ample, parallaxRepli pour mouvement réduit : remplacer glissement / zoom par un court fondu

Si une plainte ne figure pas dans le tableau, consulter references/keywords.md, choisir le principe le plus proche et utiliser son terme exact.

Règles d'écriture

  • Précis plutôt qu'adjectif. Remplacer « plus fluide » par un mécanisme : ressort, ease-out, vélocité, momentum. Ajouter des nombres uniquement lorsqu'ils sont standard (200 à 300 ms, décalage de 50 ms, échelle 0.96). Ne jamais inventer de nombres exacts qui dépendent du design de l'auteur.
  • Séparer le toucher du relâchement. Le travail gestuel a presque toujours trois phases : pendant le glissement, au relâchement, au repos. Nommer chaque phase que l'auteur sous-entend.
  • Dire ce qui ne doit pas arriver lorsque la plainte l'implique (« pas de retour élastique », « pas de décalage de mise en page », « pas de clignotement »).
  • Rester dans le sujet. Corriger uniquement ce que l'auteur a demandé. Ne pas ajouter de nouvelles fonctionnalités, de nouveaux écrans ou restyler des éléments non mentionnés.
  • Conscient de la plate-forme, sans deviner. Si l'auteur ou le projet clarifie la pile (React Native, web, SwiftUI), utiliser ses termes (Reanimated withDecay, withSpring, CSS transition). Si ce n'est pas clair, rester neutre quant à la plate-forme.
  • Mouvement réduit et RTL : les mentionner uniquement lorsque le changement ajoute un mouvement ou une direction visible, et le limiter à une courte clause.
  • Longueur : 1 à 4 phrases pour 1 à 4 plaintes. Un paragraphe court maximum. Pas de listes à puces, sauf si l'entrée contient 5 demandes distinctes ou plus.
  • Ton simple. Impératif, direct, pas de remplissage, pas de « s'il vous plaît », pas d'explication du pourquoi du principe.
  • Une seule question au maximum. Si l'entrée est vraiment ambiguë (quel élément ?), poser une question courte au lieu de deviner. Sinon, ne pas poser de question.

Format de sortie

Uniquement l'instruction réécrite, en texte brut. Si l'entrée comporte plusieurs demandes distinctes, les fusionner en un seul paragraphe fluide dans l'ordre où l'utilisateur les vivrait : toucher, relâchement, repos.

Exemple

Entrée :

Quand je balaye vite, l'écran clignote. Corrige ça.
Mieux, mais maintenant c'est rigide. Rends-le plus fluide.
Les nuages s'arrêtent trop brusquement. Est-ce qu'ils peuvent continuer un peu après que j'ai lâché ?
Le soleil peut-il aussi bouger ? Mais seulement après que j'ai lâché.

Sortie :

Arrête de recalculer l'heure du jour sous le doigt. Pendant le glissement, le ciel suit le doigt en 1:1. Au relâchement, utilise la vélocité du balayage : les nuages conservent ce momentum et ralentissent jusqu'à l'arrêt, sans retour élastique. Le soleil effectue un arc complet comme animation unique après le relâchement, indépendante du doigt.

Pourquoi ça fonctionne : « clignote » est devenu « arrête de recalculer sous le doigt » (continuité), « rigide » est devenu un mouvement piloté par la vélocité, « s'arrête trop brusquement » est devenu momentum plus ease-out, « seulement après que j'ai lâché » est devenu une animation unique déclenchée au relâchement. Les trois phases (glissement, relâchement, repos) sont explicites.

Plus d'exemples :

Entrée : la popup apparaît d'un coup, ça fait cheap Sortie : Animer l'arrivée de la popup : fondu et échelle de 0.95 à 1 avec un léger glissement de 8 px vers le haut, 200 ms, ease-out. Sortie avec un fondu ease-in plus rapide. Assombrir l'arrière-plan avec un voile qui apparaît en même temps.

Entrée : la liste se charge et ensuite tout bouge partout Sortie : Afficher des rangées squelette avec un scintillement pendant le chargement, dimensionnées pour correspondre aux rangées finales afin que rien ne bouge. Quand les données arrivent, fondre enchaîné chaque squelette dans sa rangée avec un court décalage (environ 50 ms entre les rangées). Réserver l'espace pour les images afin d'éviter le décalage de mise en page.

Entrée : le bouton est mort quand je tape Sortie : Ajouter un retour de pression : échelle à environ 0.96 au pressage avec un ease-out rapide (100 ms), retour ressort au relâchement, et une légère tape haptique. Afficher un état pressé clair et désactiver le bouton pendant l'exécution de la requête.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés