Communitygithub.com

21 Grams UX

Auditiert und optimiert die Abläufe und Benutzerfreundlichkeit eines KI-erstellten Produkts mit den eigenen Komponenten und Mustern des Projekts, sodass es so funktioniert, wie Menschen es erwarten – nicht nur fertig aussieht.

Was ist 21 Grams UX?

21 Grams UX ist ein Skill, der sich auf die Benutzererfahrung (UX) von KI-erstellten Frontends konzentriert. Im Gegensatz zu 21 Grams UI, das sich um das visuelle Erscheinungsbild kümmert, überprüft und repariert UX die tatsächlichen Abläufe: tote Enden, fehlende Zustände, stilles Versagen, nicht rückgängig machbare Aktionen und benutzerunfreundliche Formulare. Der Skill verwendet ausschließlich die bereits im Projekt vorhandenen Komponenten und Muster, ohne neue UI-Kits oder Abhängigkeiten einzuführen. Er basiert auf einer umfangreichen Wissensbasis aus UX-Gesetzen, nummerierten Regeln, Feldregeln aus echten Review-Sitzungen sowie bereichsspezifischen Dateien für Navigation, Formulare, Zustände, Feedback, Onboarding, destruktive Aktionen, Barrierefreiheit und mehr. Der Workflow umfasst eine Bestandsaufnahme, Recherche zu Branchenführern, das Durchlaufen aller Abläufe (Happy Path und Edge Cases), eine strukturierte Auditierung mit Bewertung und schließlich die schrittweise Anwendung von Korrekturen und deren Verifikation. Der Skill ist plattformunabhängig und arbeitet auf Basis von Browser-Inspektion sowie Code-Analyse, ideal für Cursor, Claude Code und ähnliche KI-Entwicklungswerkzeuge.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/main/skills/ux

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht 21 Grams UX?

Ein Durchlauf über vorhandene Abläufe. 21 Grams UX (das UX-Paket der 21-Grams-Familie) gestaltet das Produkt nicht neu und fügt kein UI-Kit hinzu. Es geht die tatsächlichen Abläufe durch, findet heraus, wo KI-erstellte Produkte für die Benutzer scheitern (Sackgassen, fehlende Zustände, stilles Versagen, nicht rückgängig machbare Aktionen, Formulare, die gegen den Benutzer arbeiten), und repariert sie mit den Komponenten und Mustern, die das Projekt bereits hat.

21 Grams UI kümmert sich um das Aussehen. 21 Grams UX kümmert sich darum, ob es funktioniert. Wenn beide installiert sind, führe zuerst UX aus: Es bringt nichts, einen Schritt zu polieren, der nicht existieren sollte.

Regel Null: Verwende die eigenen Komponenten des Projekts

Jede Änderung erfolgt über das, was das Projekt bereits verwendet. 21 Grams UX baut niemals einen parallelen Satz von Komponenten oder einen parallelen Ablauf auf.

  1. Erstelle eine Bestandsaufnahme, bevor du etwas anfasst. Notiere den Router und die Routenkarte, die Komponentenbibliothek, die Formularbibliothek und den Validierungsansatz, die Toast-, Dialog- und Leerzustands-Komponenten, die Datenabrufschicht (wo Lade- und Fehlerzustände herkommen) und die Analyse- oder Ereignisschicht, falls vorhanden.
  2. Repariere Dinge dort, wo sie leben. Ein fehlender Fehlerzustand wird in die gemeinsame Daten- oder Leerzustands-Komponente eingefügt, nicht in einen einzelnen Bildschirm. Ein Bestätigungsmuster wird in den Dialog des Projekts eingefügt, nicht in eine einmalige Lösung.
  3. Füge niemals eine Komponente oder Abhängigkeit hinzu, wenn eine für die Aufgabe existiert. Keine neue Formularbibliothek, Toast-Bibliothek oder Tour-Bibliothek, um einen 21-Grams-UX-Effekt zu erzielen.
  4. Wenn ein Teil wirklich fehlt (keine Leerzustands-Komponente, kein Rückgängig-Machen), baue es aus den vorhandenen Primitiven des Projekts, unter Einhaltung seiner Dateistruktur und Namenskonvention. Gib dies im Bericht an.
  5. Produktentscheidungen bleiben beim Produkt. 21 Grams UX ändert nicht, was das Produkt tut, für wen es ist oder seine Geschäftsregeln. Es ändert, wie die vorhandenen Aufgaben ausgeführt werden. Alles, was den Umfang ändern würde, kommt als Frage in den Bericht, nicht als Korrektur.

Rangfolge: die Worte des Benutzers, dann die etablierten Muster und Produktregeln des Projekts, dann die Hausregeln von 21 Grams UX.

Was enthalten ist

  1. Der UX-Recherche-Schritt. Bevor du einen Ablauf entwirfst oder neu gestaltest, analysiere das aktuelle Produkt und drei bis fünf branchenführende Beispiele, eines nach dem anderen, unter Verwendung einer Musterbibliothek wie Mobbin, sofern eine angeschlossen ist. Der vollständige Prozess ist in references/research.md.
  2. Die UX-Gesetze. Das Wissen, aus dem die Regeln stammen, in references/laws.md, zitiert als A1, A2… nach Abschnitt. Abschnitt A sind die Kerngesetze: Hick's, Fitts's, Jakob's, Miller's, die Doherty-Schwelle, Tesler's und Postel's. Wenn keine Regel einen Fall abdeckt, leite aus den Gesetzen ab.
  3. Die UX-Regeln. Nummerierte Regeln in references/rules.md, jeweils mit der Regel, wie man sie anwendet und was zu kennzeichnen ist, plus eine schnelle Audit-Checkliste. Mobile-First geschrieben und auch auf das Web angewendet (primäre Navigation für „Bottom Tab

Individual skills in this repo

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

Verwandte Skills