Communitygithub.com

lidge-ai/ima2-gen

Erkennung von Designrichtung und UX-Urteilsfähigkeit für ima2-Nutzer. Verwenden Sie dies für UI/UX-Richtung und Designentscheidungen – vage visuelle Vorgaben, Onboarding, Empty/Error/Loading-Zustände, Layout-Vokabular, Typografie-Brüche, Favicons, Logos und Markenidentitätsentscheidungen. Arbeitet mit ima2-front zusammen: Dieses Skill legt die Designrichtung fest, dann laden Sie ima2-front zur Umsetzung. Auslöser: mach es gut aussehen, modern, sauber, ästhetisch, Onboarding, Leerzustand, Fehlerzustand, Favicon, Logo, Designsystem, 깔끔하게, 모던하게, 감성적으로.

Was ist ima2-gen?

Das Skill 'lidge-ai/ima2-gen' ist ein spezialisiertes Werkzeug für die Design-Richtungsfindung und UX-Urteilsbildung, das in Verbindung mit dem Frontend-Implementierungs-Skill 'ima2-front' arbeitet. Es richtet sich an Entwickler und KI-Agenten, die UI/UX-Designprobleme lösen, insbesondere wenn Benutzer nur vage Designwünsche äußern (z. B. „mach es schön

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lidge-ai/ima2-gen/tree/HEAD/skills/ima2-uiux

In Ihrer bevorzugten KI fragen

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

Dokumentation

ima2 UI/UX: Intent Discovery, Patterns & Product Vocabulary

Setup

npm install -g ima2-gen    # global installieren (Node.js >= 20)
ima2 setup                 # Erstmalige Authentifizierung (GPT OAuth empfohlen)
ima2 serve                 # Lokalen Server starten
ima2 ping                  # Verbindung prüfen
ima2 status                # Konfiguration und OAuth-Status anzeigen

Agent Bootstrap: Zuerst ima2 ping. Falls nicht erreichbar: ima2 serve &. Falls nicht installiert: npm install -g ima2-gen && ima2 setup. Verwenden Sie ima2 skill path, um Skills zu lokalisieren; lesen Sie ../ima2-uiux/SKILL.md (diese Datei) für die Designrichtung, ../ima2-front/SKILL.md für Implementierungsressourcen.

Aktiviert durch Änderungsoberfläche, wenn:

  • Die Designrichtung des Benutzers vage ist ("깔끔하게", "모던하게", "just make it look good")
  • Sie an Onboarding, Leerzustand, Fehlerzustand oder Ladezustand UI arbeiten
  • Der Benutzer eine Produktästhetik erwähnt ("Notion 느낌", "Linear처럼")
  • Sie mit einem neuen Designsystem beginnen oder eine Farbpalette generieren
  • Sie Layoutmuster oder Navigationsarchitektur auswählen
  • Sie Favicons, Produktlogos oder Markenidentitätselemente einrichten
  • Sie mit Logo-Dunkelmodus-Varianten, OG-Bildern oder Social-Media-Meta-Tags umgehen

Lesen Sie dies vor stilbezogenen Referenzen, wenn der Benutzer keine klare Designrichtung artikulieren kann. Für Anti-Slop-Erkennung und verbotene Muster verweisen Sie auf ima2 skill front ref anti-slop, insbesondere das Gradientenbudget 2026 und die Verbote von Einthemen-Designs.

Emoji-Verbot (vorläufig): Keine Emojis als visuelle UI-Elemente (STRENG). Kanonische Regel, Umfang und Ausnahmen: ima2-front §5 / ima2 skill front ref anti-slop § Emoji Slop.

Rollenverteilung: Dieses Skill besitzt das Designurteil: Intent Discovery, Informationsarchitektur, UX-State-Bedeutung, Typografie/Farbe/Layout-Richtung, Produktpersönlichkeit, Markenvokabular, Anti-Slop-Mustererkennung und Designsystem-Entscheidungen. ima2-front besitzt die Implementierung: HTML/CSS/Komponenten, Responsive-Mechanik, Accessibility-Anbindung, Laufzeitverhalten und gerenderte Verifikation. Nachdem Sie hier die Designrichtung gewählt haben, laden Sie ima2-front für die konkrete Implementierung.

Externe/aktuelle Designbelege: Für Behauptungen zu Live-Produktreferenzen, aktuelle Designsystem-Dokumentationen, Browser-API-Verhalten, Accessibility-Anleitungen, die sich geändert haben könnten, oder Browser-gerenderte Quellnachweise, durchsuchen Sie das Web und befolgen Sie dessen Query-Rewrite-, Source-Fetch- und Evidence-Status-Regeln. Verwenden Sie browser fetch/open/text/get-dom/snapshot erst, nachdem Kandidaten-URLs existieren.

C0/C1-Arbeit (kleine lokale Patches): Für kleine Patches überspringen Sie die vollständige Referenzkette.

Regelklassen-Hinweis (UX-STYLE-01): Alles in diesem Skill, das Geschmack ausdrückt – Produktpersönlichkeiten, Design-Ismen, voreingestellte Token, ästhetisches Vokabular – ist STYLE_SAMPLE: Beispiele zum Abschauen, niemals universelle Anforderungen. Objektive UX-Korrektheit (State-Abdeckung, Barrierefreiheit, Lesbarkeit) wird von ima2-front §1.5 verwaltet und bleibt STRENG/STANDARD.

Modulare Referenzen

Empfohlen: Installieren Sie Skills in Ihr Agenten-Skill-Verzeichnis.

ima2 skill install --dir <agenten-skill-pfad>   # der Agent gibt seinen eigenen Pfad an
ima2 skill install --tmp                       # temporärer Fallback

Der Agent bestimmt sein eigenes Skill-Verzeichnis und übergibt es über --dir. Nach der Installation liegen SKILL.md und references/ für natives Lesen auf der Festplatte.

Ad-hoc Lesen (ohne Installation):

ima2 skill uiux refs              # alle Referenzmodule mit Zeilenanzahl auflisten
ima2 skill uiux ref design-isms   # ein Modul ausgeben (Basisnamen-Abgleich)
DateiWann lesenWas wird behandelt
references/design-isms.mdBenutzer nennt einen Stil/eine Bewegung16 Designströmungen mit CSS-Signaturen, inkl. Liquid Glass + Liquid Editorial Standard-Kit (2025-2026) + AI Serif Editorial + Organic Capsule (verifiziert 2026-07-09)
references/design-award-sources.mdSuche nach realen DesignreferenzenGestufter Quellen-Leitfaden: Auszeichnungs- und Galerieseiten, wofür jede am besten geeignet ist, und wie man sucht
references/compositional-patterns.mdKomponieren von Hero, Navigation, Motion oder InhaltsstrukturKanonische Kompositionsmuster aus der Award-Forschung mit Responsive- und Accessibility-Gates
references/design-trends.mdÜberprüfung der Datierung, aufkommender Techniken oder des Promotionsstatus2026-07-14 Achsenfrequenz-Momentaufnahme, Techniksignale, Signatur-Hauptbuch und Neu-Crawl-Protokoll
references/design-read-example.mdErlernen oder Überprüfen des Design-Read-FormatsAusgefülltes Beispiel für einen Design Read + Dial-Einstellung
references/product-personalities.mdBenutzer verweist auf ein Produkt10 Produkt-DNA-Profile mit genauen Token, inkl. 2026 AI-Produkt-Pastell + OpenAI warm-sans organisch + Anthropic Serif buchartig
references/layout-macrostructures.mdAuswahl von Seiten-/Komponenten-LayoutsKomponenten-Layouts + Seitenebenen-Kompositionen
references/ux-states.mdErstellen einer zustandsbehafteten UIOnboarding, Leer, Fehler, Laden, Progressive Disclosure
references/color-system.mdGenerieren von Farben/FarbpalettenOKLCH-basierte Palettengenerierung, Farbtonbudget, getönte Neutrale, Dunkelmodus, Barrierefreiheit
references/design-system-bootstrap.mdNeues Projekt / DesignsystemToken-Architektur, Komponentenhierarchie, DESIGN.md-Format (google-labs-code/design.md)
references/responsive-nav.mdResponsive- oder NavigationsarbeitBreakpoints, Container-Queries, Navigationsmuster nach Dichte
references/ux-preflight.mdVor der AuslieferungCheckliste zur UX-Status-Verifikation
references/typography-line-breaks.mdImmer für textlastige UIÜberschriften-Bruchqualität, Kurzbeschreibungskategorie (Hero-Untertitel, Kartenbeschreibung – balance statt pretty verwenden), Waisenvermeidung, ch-Einheiten, koreanische Waisenkriterien, -webkit-line-clamp-Konflikt
references/favicon-logo.mdFavicon-, Produktlogo- oder MarkenidentitätsarbeitFavicon-Dateisatz, SVG-Dunkelmodus, Logo in Nav/Footer, Dunkelmodus-Varianten, OG-Bilder, Marken-Token, häufige Fehler
references/logo-trust-sections.mdIntegrations-/Partner-/KundenlogosLaufschrift vs. Raster-Entscheidung, Anti-Patterns, Graustufen-Behandlung, Platzierung
references/visual-hierarchy.mdJede Layout-/Kompositionsentscheidung6 Hebel: Größenmaßstab, Gewichtskontrast, Farbbetonung, Abstand, Position, Dichte
references/form-patterns.mdFormulare, Assistenten, Authentifizierung, Datei-UploadValidierungszeitpunkt, Mehrschritt, Passwort-UX, Datei-Upload, Suche/Filter
references/mobile-native-ux.mdNative Mobile-App-UX-EntscheidungeniOS HIG vs Material 3, Gesten, Deep Linking, koreanische Privatsphäre, App-Store-UX
references/intent-discovery-ladder.mdUX-INTENT-01 optional Vertiefung (Schritte 1-6)Stimmungs-/Helligkeits-/Dichte-/Form-/Viewport-/Referenz-Leiter, Klärung vager Anfragen
references/korean-design-vocabulary.mdKoreanische Design-Briefs oder koreanisch-zuerst UIKoreanischer Deskriptor → CSS-Token-Übersetzung, Schnellzuordnungstabelle, Schriftartauswahl-Richtlinien

Lazy-User Gate (UX-LAZY-01, STANDARD – Pferdeschwanz-Disziplin angewendet auf UX)

Entwerfen Sie für den kognitiv sparsamen Benutzer: Benutzer lesen nicht, sie scannen; sie begnügen sich; sie werden eine Wahl gegen einen offensichtlichen nächsten Schritt eintauschen. Bevor Sie einen benutzerseitigen Entscheidungspunkt ausliefern – Option, Einstellung, Schritt, Bestätigung, Eingabefeld, Modus – rechtfertigen Sie seine Existenz auf die Pferdeschwanz-Art, in dieser Reihenfolge:

  1. Nichts tun: Kann eine korrekte Voreinstellung diese Entscheidung vollständig entfernen?
  2. Löschen: Verdient der Schritt/das Feld seine Abschlussraten-Kosten (Hick'sches Gesetz)?
  3. Absorbieren: Kann das System die Komplexität statt des Benutzers übernehmen (Tesler'sches Gesetz)?
  4. Herabstufen: Noch für manche Benutzer nötig → Progressive Disclosure, niemals eine Verzweigung der obersten Ebene.

Jeder Bildschirm hat EINE primäre Aktion. Oberflächenabhängig: Consumer-/One-Shot-Flows minimieren ENTSCHEIDUNGEN; wiederholte Arbeitswerkzeuge (dichte Profile) minimieren wiederholte BEWEGUNGEN – das Zusammenfassen von Expertensteuerungen in Assistenten ist der umgekehrte Fehler. STRENGE Ausnahmen: zerstörerische/unumkehrbare Aktionen, Einwilligung/Datenschutz/Rechtliches, Zahlungsbestätigung und Accessibility-Features werden niemals in magische Voreinstellungen kollabiert.

UX-State Contract (UX-STATE-01)

Für Onboarding-, Leer-, Lade-, Fehler- oder Progressive-Disclosure-Arbeit muss der Textkörper die Zustandsbedeutung vor dem Styling beantworten. Tiefe Muster leben in references/ux-states.md.

  • Onboarding lehrt die erste sinnvolle Aktion, nicht das gesamte Produkt.
  • Leer erklärt, warum der Zustand existiert und benennt die nächste Aktion.
  • Laden wählt Skelett für bekannte Struktur, Spinner/Fortschrittsanzeige für kurze unbekannte Wartezeiten und vermeidet vorgetäuschte Fertigstellung.
  • Fehler stellt Wiederholungs-, Wiederherstellungs- oder Eskalationsmöglichkeiten bereit; niemals in eine Sackgasse führen.
  • Progressive Disclosure benennt, was versteckt bleibt, warum es versteckt bleibt und wo es verfügbar wird.

IA Chooser (UX-IA-01)

Standardnavigationsarchitektur nach Arbeitsform; lesen Sie references/responsive-nav.md für responsive Details.

ArbeitsformStandard-IA
Dichte Desktop-WiederholungsarbeitSeitenleiste + Befehlspalette
Mittelstarke abschnittsweise ArbeitTabs oder segmentierte Navigation
Mobile-primärer Consumer-FlowBottom-Navigation, Sheet oder Daumenzonen-Aktionen
Assistent/Auth/SetupStepper oder linearer gestapelter Flow

1. User Intent Discovery Protocol

Wenn die Designanfrage des Benutzers vage ist ("깔끔하게 해줘", "모던하게", "just make it look good"), erzeugen Sie keine generische Ausgabe. Führen Sie den kompakten Ambiguitäts-Flow (UX-INTENT-01) aus:

  1. Erstellen Sie den Design Read aus §2 unter Verwendung verfügbarer Signale.
  2. Wenn eine Entscheidung die Richtung blockiert, stellen Sie EINE klärende Verzweigungsfrage mit binären/ternären Optionen.
  3. Fahren Sie mit der Antwort fort; wenn der Benutzer nicht antwortet und die Aufgabe fortgesetzt werden kann, wählen Sie die domänenkorrekteste Voreinstellung und geben Sie die Annahme an. Auf EXPRESSIVEN Oberflächen (Landing/Consumer/Creative/AI-Produkt) ist diese Voreinstellung die unten aufgeführte No-Brief Standard-Richtung (UX-DEFAULT-ISM-01); ruhige Oberflächen behalten ruhige domänenkorrekte Voreinstellungen.

Überspringen Sie diesen Abschnitt, wenn der Benutzer explizite Design-Spezifikationen bereitgestellt hat oder es sich um einen Patch mit ≤5 Zeilen handelt.

No-Brief Standard-Richtung (UX-DEFAULT-ISM-01, STANDARD – Kit-Inhalt STYLE_SAMPLE)

Dies ist der FALLBACK von UX-INTENT-01 Schritt 3, niemals ein Workaround: Es wird nur ausgelöst, nachdem der Design Read und nachdem die eine blockierende Verzweigung aufgelöst oder unbeantwortet ist, und die angewandte Richtung wird IMMER als explizite Annahme im Ergebnis genannt. Eine benannte, spezifische, domänengebundene Richtung ersetzt generische LLM-Voreinstellungen; sie darf NICHT generischen Glas-Morphismus, zentrierte Karten, beige-Voreinstellungen unter einem neuen Etikett wieder einführen.

Standard-Kit für expressive Oberflächen: Liquid Editorial (2026 Komposit, entschieden am 2026-07-07 aus Trendforschung der Stufe 2 – siehe references/design-isms.md §1.14 für die vollständige Signatur):

  • Struktur: Type-geführte redaktionelle Komposition (überdimensionierte Autoren-Überschriften-Skalierung, Grotesk als Standard, Serifen-Anzeige nur mit redaktioneller Begründung gemäß UX-TYPE-01), taktile/fotografische Textur über flachen Verlaufsverläufen, asymmetrisches inhaltsgewichtetes Layout.
  • Materialakzent: Liquid Glass oder nahezu opakes Pill-Chrom NUR auf schwebenden Funktionsebenen (Nav/Toolbars/Chip-Cluster); Pill-Chip-Inhaltseinheiten; Inhaltsebene bleibt fest (ima2-front FE-LIQUID-LAYER-01). Kinder innerhalb von Pill-Chrom tragen im Ruhezustand keine Kapselränder/-umrisse – Betonung nur durch Füllungen/Tönungen (ima2-front FE-PILL-NEST-01); Top-Bar-Scroll-Zustände gemäß ima2-front/references/top-bar.md FE-TOPBAR-STATE-01.
  • Motion: Feedback-Baseline + ein Signature-Moment (Pointer-Proximity-Chips oder Scroll-Driven-Reveal) + >= 1 unterstützendes Scroll-Reveal auf Landing-Bucket-Oberflächen (Untergrenze 2, Obergrenze ~4 – ima2-front/references/motion.md FE-MOTION-BUCKET-01); Feedback-only ansonsten, gemäß Motion-Domain-Gates.
  • Farbe: OKLCH-abgeleiteter Einzelakzent + getönte Neutrale (Farbtonbudget, references/color-system.md).

Domain Gate (STRENG): Dashboards, Admin, Ops, Finanzen, Regierung, B2B-Wiederholungsarbeit-Werkzeuge erhalten dieses Kit NIEMALS standardmäßig – "schick" überschreibt niemals die Domänenkorrektheit (§ IA Chooser + ima2-front Produktdichte-Profile).

Optionale Vertiefung: Verwenden Sie die untenstehende Leiter nur, wenn die erste Verzweigung fehlschlägt oder der Benutzer explizit eine geführte Erkundung wünscht.

  • Verwenden Sie binäre/ternäre Optionen, keine offenen Fragen.
  • Verweisen Sie auf bekannte Produkte – Benutzer erkennen, was sie wollen, schneller als sie es artikulieren können.
  • Falls das Diagramm-Skill verfügbar ist, bieten Sie an: "참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요."
  • Wenn der Benutzer eine bestimmte Produktreferenz nennt, überspringen Sie die restlichen Schritte und ordnen Sie direkt über references/product-personalities.md zu.

Für die vollständige 6-stufige geführte Leiter (Stimmung → Helligkeit → Dichte → Form → Viewport → Referenz) und die Tabelle zur Klärung vager Anfragen lesen Sie references/intent-discovery-ladder.md. Laden Sie diese nur, wenn der kompakte Flow oben eine tiefere geführte Erkundung benötigt.


2. Design Read (VERPFLICHTEND für neue Seiten, Komponenten oder Layouts. Optional für Patches mit ≤5 Zeilen – siehe dev §0.1 Patch Fast-Path.)

Bevor Sie IRGENDEINEN Frontend-Code generieren, erstellen Sie einen Design Read. Wenn das Projekt eine DESIGN.md-Datei hat, lesen Sie diese zuerst – ihre Token und Prosa überschreiben alles unten.

Native Tool-Unterstützung (Struktur/60): Lesen Sie visuelle Referenzen – vorhandene Bildschirme, Konkurrentenaufnahmen, Design-Exporte – mit view_image in den Kontext, bevor Sie den Design Read schreiben; erzeugen Sie benötigte Bitmap-Assets (Icons, Illustrationen, Mock-Bilder) mit ima2 (prüfen Sie ima2 status, versuchen Sie ima2 serve, falls nicht erreichbar; ima2 ist das primäre Tool nur, wenn ima2 wirklich nicht verfügbar ist), anstatt Platzhalter-Boxen zu hinterlassen; und verifizieren Sie das erstellte Ergebnis visuell gemäß visueller Verifikation (Browser-Screenshot -> view_image).

Ausgabeformat (Mini DESIGN.md)

Ausgefülltes Beispiel: references/design-read-example.md.

---
name: <projekt-name>
farben:
  primär: "<hex>"
  akzent: "<hex>"
  hintergrund: "<hex>"
typografie:
  überschrift: { fontFamily: <schrift>, fontSize: <größe> }
  fließtext: { fontFamily: <schrift>, fontSize: <größe> }
---

Lesen Sie dies als: für , mit einer -Sprache. <1-2 Sätze: spezifische Referenz, keine Adjektive. "Vorlesungsskript der 1970er" > "modern und sauber">

Do's: Dont's:

Letzte visuelle Verifikation Pflicht: Nach Generierung einer Komponente/Seite rendern Sie diese im Browser, machen Sie einen Screenshot und rufen Sie view_image auf. Wenn der Screenshot nicht lesbar ist oder das Styling versagt, wiederholen Sie die Generierung mit korrigierten Details.

3. Produktpersönlichkeit & Markenvokabular

Wenn der Benutzer ein bestimmtes Produkt nennt, lesen Sie references/product-personalities.md. Dieses deckt ab:

  • 10 Produkt-DNA-Profile mit genauen Token (Farben, Typografie, Sprachmuster)
  • Enthält 2026 AI-Produkt-Pastell, OpenAI warm-sans organisch, Anthropic Serif buchartig
  • Wenn eine genaue Übereinstimmung nicht gefunden wird, verwenden Sie den nächstgelegenen archetypischen Match + explizite Abweichungsnotiz

4. Anti-Slop-Pattern-Judgment

Keine generischen UI-Klischees:

  • Überschriften: "Modernes & sauberes Design" usw. – stattdessen spezifische Referenzen verwenden
  • Farben: Kein generisches Blau/Weiß/Beige ohne Begründung
  • Layout: Keine zentrierten Karten mit Schatten als Standard
  • Typografie: Keine system-ui für Überschriften ohne Begründung
  • Verläufe: Gradientenbudget 2026 – maximale Anzahl von Stopps und Bereich definiert in ima2-front Anti-Slop-Referenz

5. Emoji-Verbot (vorläufig)

Emojis sind STRENG als UI-Visual-Elemente verboten. Dies umfasst:

  • Symbole in Schaltflächen, Karten, Navigation
  • Platzhalter-Illustrationen
  • Status-Icons (außerhalb von Textinhalten)

Vollständige Regeln, Umfang und Ausnahmen: ima2-front §5 / ima2 skill front ref anti-slop § Emoji Slop.

6. Ausnahme: Systemkonsistenz

Wenn das Projekt oder Produkt bereits klare Designregeln hat, haben diese Vorrang. Lesen Sie die vorhandene DESIGN.md oder die SKILL.md des Frontend-Skills für Implementierungsanweisungen.

7. Skill-Setup-Zusammenfassung

# Einrichtung und Authentifizierung
ima2 setup

# Server starten
ima2 serve

# Verbindung prüfen
ima2 ping

# Skills installieren (von ima2)
ima2 skill install --dir <agenten-skill-pfad>

# Referenzen lesen
ima2 skill uiux refs
ima2 skill uiux ref design-isms

Verwandte Skills