Communitygithub.com

V4TIME/V4SKILL

Erstelle Web-Oberflächen, die wie von Menschen gebaut aussehen, nicht wie KI-Ausgabe.

Was ist V4SKILL?

Diese Skill-Komponente (V4TIME/V4SKILL) ist für Entwickler und KI-Agenten gedacht, die Web-UIs gestalten, die nicht wie KI-generiert wirken. Sie enthält Designprinzipien, Anti-Pattern-Checks und Workflows, um Oberflächen zu bauen, die von einem Menschen mit Geschmack gestaltet zu sein scheinen – nicht wie eine Schablonenablage oder KI-Voreinstellung. Die Skill unterstützt verschiedene Plattformen wie Claude Code, Cursor und Codex und integriert externe Tools wie "webmxerz" für Designintelligenz und "impeccable" für technische Prüfungen. Zu den Kernprinzipien gehören der Verzicht auf Emoji-Icons (als das #1 Zeichen für KI), keine Schattenglow-Effekte bei Buttons, keine Spring- oder Sprung-Animationen, hoher Kontrast (WCAG AA) und eine klare Typografie-Hierarchie. Der Workflow umfasst die Suche in der Skill-Bibliothek (z.B. webmxerz), das Anwenden der Designregeln auf den tatsächlichen Stack (nicht nur React/Tailwind), das Linten mit Impeccable und das iterative Verfeinern auf Basis konkreten Feedbacks. Die Skill vermeidet Überdekorierung als vermeintliche Lösung für den KI-Look und stellt sicher, dass Ergebnisse sowohl technisch korrekt als auch ästhetisch menschlich wirken.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/human-first-ui

In Ihrer bevorzugten KI fragen

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

Dokumentation

Mensch-zuerst-UI

Baue Oberflächen, die aussehen, als hätte sie ein Mensch mit Geschmack erstellt – kein Template-Dump, keine KI-Voreinstellung. Diese Skill kodiert die Designprinzipien, Anti-Pattern-Prüfungen und Tool-Workflows, die verwendet werden, wenn der Benutzer explizit eine UI möchte, die nicht KI-generiert aussieht.

Wann verwenden

  • Benutzer sagt, die UI "sieht aus wie von ChatGPT erstellt" oder "sieht KI-generiert aus"
  • Benutzer wünscht einen "minimalen, hochwertigen, menschlichen" Look
  • Benutzer erwähnt Emil Kowalski, Impeccable, 21st.dev, webmxerz oder ähnliche Design-Qualitätssignale
  • Bau oder Überprüfung einer Web-UI, bei der das Aussehen wichtig ist

Kernprinzipien

1. Keine Emoji-Icons

Emojis als Icons sind das #1 KI-Erkennungsmerkmal. Verwende Textlabels, einfache CSS-Formen oder Inline-SVGs. Emojis gehören in Inhalte, nicht in das UI-Chrome.

2. Keine Glow-Schatten auf Buttons

box-shadow mit farbigen Glows (insbesondere Akzentfarben) auf interaktiven Elementen ist ein Kennzeichen KI-generierter UIs. Nur flache Ränder und Hover-Zustandsänderungen.

3. Keine Bounce-/Spring-Animationen

Punktgleiten, hüpfende Loader, Spring-Scale-Hover-Effekte – das sind Dekorationen, keine Funktionen. Dezente Hover-Übergänge (120-150ms ease) sind in Ordnung. Springen nicht.

4. Keine Splash-Screen-Willkommenskarten mit Icon-Tiles

Ein Willkommensbildschirm sollte einfacher Text auf der Seite sein, keine dekorierte Karte mit Icon-Tiles und Hinweisboxen, die als Feature-Karten gestaltet sind.

5. Kontrast zuerst

Auf dunklen Hintergründen benötigt gedämpfter Text dennoch 4.5:1 Kontrast (WCAG AA). Häufige KI-Voreinstellungen wie #5a5a5a auf #0d0d0d fallen hier deutlich durch. Teste mit Impeccable.

6. Fließtext-Minimum: 14px, ideal 16px

10-11px ist nur für dekorative Mikrolabels (Abschnittsüberschriften, Zeitstempel, Footer-Status-Text mit Buchstabenabstand). Inhaltsrelevanter Text muss 12px+ sein, und Fließtext sollte 14-16px betragen.

7. Klare Typografie-Hierarchie

Verwende weniger Größen mit größeren Abständen. Habe nicht 6 verschiedene font-size-Werte, wenn 3-4 gut getrennte Stufen ausreichen würden. Strebe eine klare Trennung zwischen Label-/Sekundär-/Körper-/Überschriftengrößen an.

8. Eine Akzentfarbe, warm bevorzugt

Eine einzelne warme Akzentfarbe (Gold/Bernstein) auf einem dunklen neutralen Hintergrund wirkt absichtsvoll und hochwertig. Lila/blaue Verläufe sind die KI-Voreinstellung, die es zu vermeiden gilt.

9. Mobile zuerst

Design für das Telefon. Hamburger-Menüs, Overlay-Seitenleisten, große Touch-Ziele, lesbarer Text ohne Zoomen. Baue nicht Desktop und quetsche es zusammen.

Workflow

Schritt 1: Die Skill-Bibliothek prüfen

Bevor du etwas baust, überprüfe, ob webmxerz oder impeccable verfügbar sind:

# WebMXERZ (Designintelligenz: Farben, Typografie, Stile, UX-Muster)
ls ~/tmp/webmxerz/src/webmxerz/scripts/search.py 2>/dev/null && \
  python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<query>" --domain <style|typography|color|ux|product|...> -n 5

# Falls noch nicht geklont:
git clone https://github.com/nextlevelbuilder/webmxerz.git ~/tmp/webmxerz

Bevorzugt: --design-system für ein komplettes System in einem Durchlauf anstatt domänenspezifischer Suchen:

# Vollständiges Designsystem mit für das Projekt abgestimmten Design-Controls
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<beschreibung>" \
  --design-system \
  --variance <1-10> \
  --motion <1-10> \
  --density <1-10> \
  -p <projekt-slug> \
  -n 5

Für mehrseitige Projekte persistieren:

# MASTER.md speichern (und optional eine Seitenüberschreibung)
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<query>" \
  --design-system -p <projekt> --persist -o <projekt-verzeichnis> [--page <seitenname>]

Wenn du dann an einer bestimmten Seite arbeitest, überprüfe zuerst design-system/<projekt>/pages/<seite>.md – dessen Regeln überschreiben design-system/<projekt>/MASTER.md.

Schritt 2: Nach Designrichtung suchen

# Einen Stil finden, der zu den Wünschen des Benutzers passt
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<beschreibung>" --domain style -n 3

# Typografie finden
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<stimmung>" --domain typography -n 3

# Eine Farbpalette für den Produkttyp finden
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<produkttyp>" --domain color -n 3

# UX-Muster finden
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<muster>" --domain ux -n 5

Passe die Ergebnisse an den tatsächlichen Stack an. Wenn das Projekt einfaches HTML/CSS/JS ist (nicht React/Tailwind), extrahiere die Designprinzipien (Farben, Schriftarten, Abstände, Muster) und implementiere sie in reinem CSS. Kopiere KEINEN React-Komponenten-Code.

Schritt 3: Mit den Prinzipien bauen

  • Wähle EINEN Stil aus den Suchergebnissen, der zum Geschmack des Benutzers passt
  • Wähle EIN Paar Schriftarten
  • Wähle EINE Farbpalette (passe die Akzentfarbe an die Benutzerpräferenz an)
  • Implementiere im tatsächlichen Stack des Projekts
  • Halte es minimalistisch: Abstände und Typografie machen die Arbeit, nicht Dekoration

Schritt 4: Mit Impeccable linten

npx impeccable detect templates/ static/css/ 2>&1

Überprüfe jeden Befund. Behebe, was markiert wird. Exit-Code 0 = sauber. Exit-Code 2 = es gibt noch Befunde.

Schritt 5: Mit dem Benutzer iterieren

Zeige das Ergebnis. Wenn der Benutzer sagt, es sehe immer noch KI-generiert oder falsch aus, frage konkret, was nicht stimmt (eine Farbe, eine Größe, ein Abstand, eine Komponente) und behebe genau das eine. Führe keine komplette Neugestaltung aufgrund vager Rückmeldungen durch.

Bekannte Fallstricke

  • Überdekorieren, um den "KI-Look" zu "reparieren": Mehr Dekoration lässt es nicht menschlicher aussehen – es lässt es nur dekoriert aussehen. Zurückhaltung ist das Signal.
  • Verwendung von webmxerz-React-Code in einem Nicht-React-Projekt: Die Daten der Skill (styles.csv, colors.csv, typography.csv, ux-guidelines.csv) sind Stack-unabhängig und nützlich. Die React-Komponentenbeispiele sind es nicht. Extrahiere Prinzipien, überspringe Komponentencode.
  • Impeccable als Design-Review: Es erkennt technische Anti-Patterns (Kontrast, Größen, Hierarchie). Es bewertet NICHT Geschmack, Ausgewogenheit oder ob die Gesamtästhetik menschlich wirkt. Verwende es als Lint-Durchlauf, nicht als Ersatz für Design-Urteilsvermögen.
  • 21st.dev-Komponenten in Nicht-React-Projekten: 21st.dev ist ein React + Tailwind-Register. Seine Komponenten passen nicht in Flask/Jinja2/vanilla-HTML-Projekte. Durchstöbere nur zur visuellen Inspiration.
  • Feste Farbwerte aus Suchergebnissen: Paletten aus Suchergebnissen geben Hex-Werte als Ausgangspunkte, nicht als endgültige Antworten. Passe die Akzentfarbe an das an, was dem Benutzer tatsächlich gefällt.
  • Portieren eines Designsystems aus einer anderen Quelle (Lovable, Figma-Export, CSS eines anderen Projekts): Prüfe immer die gedämpften/hellen/kontrastarmen Tokens (--text-faint, muted-foreground, sekundärer Text) auf WCAG AA auf deinem tatsächlichen Hintergrund. Designer setzen diese zu niedrig an, weil sie in einem Designtool subtil aussehen – auf einem echten dunklen Hintergrund bestehen sie die Kontrastprüfungen für Text unter 14px nicht. Erhöhe gedämpften Text auf mindestens #8a8886 auf dunklen Hintergründen, bevor du auslieferst.
  • Lovable-Erstellte Layouts als Ausgangspunkte, nicht als Ersatz: Ein Lovable-Layout gibt dir eine saubere Struktur und ein Designsystem, aber es enthält nicht die zusätzlichen Funktionen deines Projekts (API-Editoren, Tool-Panels, Voice-Toggles, Sitzungsumbenennung, Memory-Tabs). Portiere das Design, behalte die Funktionen.

Referenzdateien

  • references/impeccable-findings.md – Impeccable-Scanergebnisse aus der Sayip-Sitzung (was gefunden, was behoben, wie ausführen)
  • references/webmxerz-quickref.md – Kurzreferenz für webmxerz-Suchdomänen, Flags, Design-Controls, --persist, Reasoning-Vertrag und die von Sayip abgeleitete Palette mit Kontrastkorrekturen
  • references/lovable-port-checklist.md – Checkliste zum Portieren eines mit Lovable erstellten Layouts in ein bestehendes Projekt (Klonen, Tokens prüfen, Struktur portieren, Funktionen behalten, linten, testen)

Verwandte Skills

  • software-development:codebase-inspection – wenn du vor der Neugestaltung prüfen musst, was bereits gebaut ist
  • lovable-port – Skill auf Klassenebene zum Portieren von mit Lovable erstellten Layouts in bestehende Flask/vanilla-Projekte

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

Verwandte Skills