Communitygithub.com

Design-Prompt-Umschreiber

Wandelt vages UI/UX/Animations-Feedback („es blinkt“, „fühlt sich steif an“) in präzise Prompts um, die Designprinzipien und Fachvokabular (Easing, Momentum, Spring, Velocity, Stagger, Gesten) verwenden.

Was ist Design-Prompt-Umschreiber?

Design-Prompt-Umschreiber ist ein KI-Agent-Skill, der speziell für nicht-designerische Anwender entwickelt wurde, die visuelles oder interaktives Feedback in natürlicher Sprache geben, aber nicht die Fachbegriffe für UI-Design und Animation kennen. Der Skill analysiert Äußerungen wie „es blinkt“, „fühlt sich steif an“ oder „es stoppt zu plötzlich“ und ordnet sie anhand von Tabelle und einer externen Keywords-Datei den zugrunde liegenden Designprinzipien zu (z. B. „kein Layout-Shift“, „Momentum auf loslassen“, „Spring mit Dämpfung“). Das Ergebnis ist ein umgeschriebener Prompt in einer direkten, präzisen Sprache, den ein Entwickler oder eine KI direkt umsetzen kann – ohne Code, ohne Erklärungen, nur die Anweisungen. Der Skill unterstützt die gängigsten Feedback-Muster und ist plattformbewusst (React Native, Web, SwiftUI), bleibt aber plattformneutral, wenn die Umgebung unklar ist. Für seltene oder nicht in der Tabelle enthaltene Beschwerden wird die Datei `references/keywords.md` herangezogen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Design-Prompt-Umschreiber?

Eingabe: vages, alltägliches Feedback dazu, wie ein Bildschirm aussieht, sich bewegt oder anfühlt. Der Schreiber kennt keine Designbegriffe. Ausgabe: Ein umgeschriebener Prompt, den ein Entwickler oder eine KI umsetzen kann. Er behält die Absicht des Schreibers bei und ersetzt Gefühle durch Designprinzipien.

Wortschatzquelle: references/keywords.md (lies sie, wenn ein Symptom nicht von der folgenden Tabelle abgedeckt wird).

Prozess

  1. Lies die gesamte Eingabe. Es können mehrere Nachrichten hintereinander sein (Beschwerde, dann „besser, aber…“, dann ein neuer Wunsch). Behandle sie als ein Gespräch und fasse sie zu einem finalen Prompt zusammen, der den aktuellsten Stand dessen widerspiegelt, was der Schreiber möchte.
  2. Finde für jede Beschwerde die Ursache hinter dem Gefühl (Tabelle unten) und benenne die Lösung mit dem richtigen Schlüsselwort.
  3. Schreibe den Prompt. Behalte die eigenen Subjektbezeichnungen des Schreibers bei (Wolken, Sonne, Karte, Blatt). Benenne seine Dinge nicht um.
  4. Gib nur den umgeschriebenen Prompt aus. Keine Einleitung, keine Erklärung der Begriffe, kein Code.

Gefühl zu Prinzip

Was der Schreiber sagtWahrscheinliche UrsacheSag stattdessen dies
„blinkt“, „flackert“, „blitzt“Der Zustand wird pro Frame neu gerendert oder durchgespult, keine Kontinuität, Layout-Verschiebung oder erneutes MountenHör auf, unter dem Finger neu zu berechnen; behalte einen kontinuierlichen animierten Wert; verwende Überblendung statt Austausch; reserviere Platz (keine Layout-Verschiebung)
„steif“, „roboterhaft“, „mechanisch“linearer oder feste Zeitsteuerung, keine GeschwindigkeitVerwende eine Feder (Steifigkeit, Dämpfung) oder ease-out; starte mit der Gestengeschwindigkeit
„zu plötzlich“, „stoppt abrupt“, „schnappt“Keine VerlangsamungTrage Schwung nach dem Loslassen, ease-out / Auslaufen bis zum Stillstand, kein Zurückschnappen
„hakt“, „ruckelt“, „hängt“, „langsam“Animierte Layout-Props, JS-Thread, zu viele NeuberechnungenFühre auf dem UI-Thread aus, animiere nur transform und opacity, 60fps
„zu schnell“, „kann‘s nicht sehen“Dauer unter ~150ms oder kein Stagger200 bis 300ms, Staffel von 30 bis 80ms
„zu langsam“, „schleppt“, „wartet“Dauer über ~500msVerkürze auf 200 bis 300ms, schnellerer Ausgang als Eintritt
„hüpfig“, „zu viel“Unterdämpfte Feder oder ÜberschwingenErhöhe die Dämpfung, kritisch gedämpft, kein Überschwingen
„tot“, „flach“, „langweilig“Kein Feedback oder sekundäre BewegungDruckrückmeldung (Skalierung ~0.96), dezente Umgebungsbewegung, haptisches Feedback, Nachlauf
„hüpft“, „poppt auf“Sofortiges MountenEinblenden plus Schieben um 8 bis 16px, ease-out
„verschwindet komisch“Sofortiges UnmountenAusgangsanimation, ease-in, schneller als Eintritt
„folgt meinem Finger“ / „sollte folgen“Gestengesteuert1:1 Tracking während des Ziehens, Übergabe an Feder beim Loslassen
„bewegt sich weiter, nachdem ich losgelassen habe“SchwungVerwende die Loslass-Geschwindigkeit, Auslaufen / withDecay, sanft auslaufen bis zum Stillstand
„mach es, nachdem ich losgelassen habe“Auslösen beim LoslassenEinmalige Animation beim Gestenende, unabhängig vom Finger
„fühlt sich billig an“, „nicht hochwertig“Standard-Easing, keine PoliturScharfes ease-out (quart / expo), Feder, einheitliche Dauern, dezenter Schatten / Weichzeichner
„kann nicht erkennen, dass es antippbar ist“Keine Affordanz oder RückmeldungAffordanz, gedrückter Zustand, Touch-Ziel von 44pt
„ich weiß nicht, ob es funktioniert hat“Keine RückmeldungErfolgs-/Fehlerzustand, Toast, haptisches Feedback, optimistisches Update
„lädt komisch“, „leer, dann poppt es“Kein LadezustandSkelett-Shimmer, Überblendung zum Inhalt, Platz reservieren
„schwer zu lesen“, „überfüllt“Hierarchie, AbständeVisuelle Hierarchie, Weißraum, 4/8pt-Abstandsraster, Kontrast 4.5:1
„falsche Richtung“ (Arabisch, RTL)Nicht gespiegeltSpiegele die Schieberichtung und Wischseiten für RTL
„macht mich schwindelig“Große Bewegung, ParallaxeFallback bei reduzierter Bewegung: ersetze Schieben / Zoomen durch kurze Einblendung

Wenn eine Beschwerde nicht in der Tabelle steht, schlage in references/keywords.md nach, wähle das nächstliegende Prinzip und verwende seinen genauen Begriff.

Schreibregeln

  • Spezifisch statt Adjektiv. Ersetze „glatter“ durch einen Mechanismus: Feder, Ease-Out, Geschwindigkeit, Schwung. Füge Zahlen nur hinzu, wenn sie Standard sind (200 bis 300ms, 50ms Staffel, Skalierung 0.96). Erfinde niemals genaue Zahlen, die vom Design des Schreibers abhängen.
  • Trenne Berührung von Loslassen. Gestenarbeit hat fast immer drei Phasen: während des Ziehens, beim Loslassen, in Ruhe. Benenne jede Phase, die der Schreiber impliziert.
  • Sage, was nicht passieren darf, wenn die Beschwerde es impliziert („kein Zurückschnappen“, „keine Layout-Verschiebung“, „kein Blinken“).
  • Halte den Umfang. Behebe nur das, worum der Schreiber gebeten hat. Füge keine neuen Funktionen, neuen Bildschirme hinzu und gestalte keine Dinge um, die sie nicht erwähnt haben.
  • Plattformbewusst, nicht plattformratend. Wenn der Schreiber oder das Projekt den Stack klar macht (React Native, Web, SwiftUI), verwende dessen Begriffe (Reanimated withDecay, withSpring, CSS transition). Falls unklar, bleibe plattformneutral.
  • Reduzierte Bewegung und RTL: Erwähne sie nur, wenn die Änderung sichtbare Bewegung oder Richtung hinzufügt, und beschränke es auf einen kurzen Nebensatz.
  • Länge: 1 bis 4 Sätze für 1 bis 4 Beschwerden. Maximal ein kurzer Absatz. Keine Aufzählungslisten, es sei denn, die Eingabe hatte 5 oder mehr separate Anfragen.
  • Klare Stimme. Imperativ, direkt, keine Füllwörter, kein „bitte“, keine Erklärung, warum das Prinzip funktioniert.
  • Maximal eine Frage. Wenn die Eingabe wirklich mehrdeutig ist (welches Element?), stelle eine kurze Frage, anstatt zu raten. Andernfalls frage nicht.

Ausgabeformat

Nur der umgeschriebene Prompt als Klartext. Wenn die Eingabe mehrere separate Anfragen hatte, fasse sie in einem fließenden Absatz in der Reihenfolge zusammen, in der der Benutzer sie erleben würde: Berührung, Loslassen, Ruhe.

Beispiel

Eingabe:

Wenn ich schnell wische, blinkt der Bildschirm. Behebe es.
Besser, aber jetzt fühlt es sich steif an. Mach es glatter.
Die Wolken stoppen zu plötzlich. Können sie sich noch ein bisschen weiterbewegen, nachdem ich losgelassen habe?
Kann sich die Sonne auch bewegen? Aber erst, nachdem ich losgelassen habe.

Ausgabe:

Hör auf, die Tageszeit unter dem Finger durchzuspulen. Während des Ziehens folgt der Himmel dem Finger 1:1. Beim Loslassen verwende die Geschwindigkeit des Wischens: Die Wolken tragen diesen Schwung und laufen sanft aus, ohne zurückzuschnappen. Die Sonne spielt einen vollständigen Bogen als einmalige Animation nach dem Loslassen, getrennt vom Finger.

Warum es funktioniert: „blinkt“ wurde zu „hör auf, unter dem Finger durchzuspulen“ (Kontinuität), „steif“ wurde zu geschwindigkeitsgesteuerter Bewegung, „stoppt zu plötzlich“ wurde zu Schwung plus Ease-Out, „erst nachdem ich losgelassen habe“ wurde zu einer einmaligen Animation beim Loslassen. Die drei Phasen (Ziehen, Loslassen, Ruhe) sind explizit.

Weitere Beispiele:

Eingabe: Das Popup erscheint einfach, sieht billig aus Ausgabe: Animierte das Popup herein: Einblendung und Skalierung von 0.95 auf 1 mit einer leichten 8px Aufwärtsverschiebung, 200ms, Ease-Out. Ausgang mit einem schnelleren Ease-In Einblenden. Verdunkle den Hintergrund mit einem Scrim, der gleichzeitig einblendet.

Eingabe: Liste lädt und dann springt alles herum Ausgabe: Zeige Skelettzeilen mit einem Shimmer während des Ladens, dimensioniert, um den endgültigen Zeilen zu entsprechen, sodass sich nichts verschiebt. Wenn Daten eintreffen, blende jedes Skelett mit einer kurzen Staffel (ca. 50ms zwischen den Zeilen) in seine Zeile über. Reserviere Platz für Bilder, um Layout-Verschiebungen zu vermeiden.

Eingabe: Button fühlt sich tot an, wenn ich tippe Ausgabe: Füge Druckrückmeldung hinzu: Skalierung auf etwa 0.96 beim Eindrücken mit einem schnellen Ease-Out (100ms), Feder zurück beim Loslassen und ein leichter haptischer Tipp. Zeige einen klaren gedrückten Zustand und deaktiviere den Button, während die Anfrage läuft.

Individual skills in this repo

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

Verwandte Skills