Communitygithub.com

Interface Feel

Ein umfassender Skill, um die Haptik und Reaktionsfähigkeit von Web- oder Mobile-Apps durch Animationen, UX-Gesetze und UI-Techniken zu verbessern, ihnen ein polierteres, schnelleres und hochwertigeres Gefühl zu verleihen.

Was ist Interface Feel?

Dieser Skill, 'Interface Feel', ist ein umfassendes Werkzeug für Entwickler, um die Interaktionsqualität einer Web- oder Mobile-App zu prüfen und zu verbessern. Er führt ein Audit durch, das 40 verschiedene Aspekte abdeckt: 12 Animationsprinzipien, 8 UX-Gesetze und 20 UI-Techniken. Basierend auf diesem Audit erstellt er einen detaillierten Bericht und behebt anschließend die gefundenen Probleme nach einem vorgegebenen Muster. Der Skill erkennt auch, wenn eine App bereits Best Practices umsetzt, dies als 'vorhanden' markiert und schließt eine doppelte Implementierung aus. Unterstützte Plattformen sind Web- und Mobile-Projekte. Der Workflow ist in drei Phasen unterteilt: Audit (nichts ändern), Behebung nach Checkliste (Vertrauen zuerst, dann Build- und Pick-Items), und Verifikation. Der Skill enthält Referenzdateien (reference.md, motion.md), ein Census-Skript (census.sh) zum Auffinden von Mustern im Code und ein Live-Seiten-Probe-Skript (probe.js) zur Messung von Klick-Zielen, Dauer, Easings etc. Wichtig ist, dass die bestehenden Designsysteme und Motion-Tokens des Projekts Vorrang haben.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/groseljgal/interface-feel/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Interface Feel?

Der Master-Durchgang dafür, wie sich eine Oberfläche bewegt und reagiert. Er prüft, was die App heute tut, anhand von vierzig Punkten (zwölf Animationsprinzipien, acht UX-Gesetze, zwanzig UI-Techniken) und einem Bewegungssystem, schreibt einen Bericht und behebt dann jeden Befund nach dem Muster für diesen Punkt. Die meisten Apps haben bereits die Hälfte der Liste; das Audit stellt dies fest, anstatt es doppelt hinzuzufügen. Geschwindigkeit, Ziele und Vertrauen gelten immer; Dekoration ist in einem Arbeitswerkzeug zurückhaltend.

Das eigene Designsystem, die Motion-Tokens und die Regeln des Projekts haben Vorrang vor allem, was hier steht. Leistungsbudgets (LCP, INP, Bundle-Größe), Barrierefreiheit und Texte sind eigene Durchgänge neben diesem.

Dateien in diesem Skill

DateiVerwendung
reference.mdJeder der 40 Punkte: wie man ihn prüft, das Behebungsmuster, wann man ihn überspringt, was ein echtes Audit gefunden hat
motion.mdDas Bewegungssystem: Tokens, zwölf Regeln, CSS-Muster, wie man Bewegung auditieren kann
audit/census.shCode-Zensus: Zählt die Muster hinter jedem Punkt, mit Datei:Zeile-Fundstellen
audit/probe.jsLive-Seiten-Prüfung: Echte Klickziele, Dauern, Easings, Abbildungen, Überschriften, Codefelder, Platzhalter
report-template.mdDie Berichtsvorlage: eine Ergebniszeile pro Punkt, Arbeitsreihenfolge, was nicht geprüft wurde

Durchgang 1: Audit (nichts ändern)

  1. Lies zuerst das Designsystem, die Motion-Tokens und die UI-Regeln des Projekts.
  2. Führe den Zensus vom Projektstammverzeichnis aus: bash <dieser Skill>/audit/census.sh . --show 5. Er liest nur die ausgelieferte Oberfläche (Abhängigkeiten, Builds, kopierte Vendor-Dateien, Tests, Benchmarks, generierte Dateien und Kommentarzeilen werden ausgelassen; füge weitere mit CENSUS_EXCLUDE="dir1,dir2" hinzu). Installiere ripgrep für einen schnellen Durchlauf; ohne es fällt das Skript auf perl zurück. Ein Zähler ist ein Hinweis zum Öffnen, kein Urteil.
  3. Führe die App aus. Führe auf jeder wichtigen Seite audit/probe.js aus (füge es in die Konsole ein oder verwende await in einem JavaScript-Runner eines Browsertools) bei 1440 Breite und bei 375, in jedem Design, das die App hat. Es scrollt die gesamte Seite Bildschirm für Bildschirm und stellt die Position wieder her. Ein versteckter Tab hat keine Breite und malt keine Frames: Zeige ihn zuerst an. Lies seine Ausgabe mit Urteilsvermögen: Ein Ziel, das als spaced markiert ist (sein Abstand zum nächsten Bedienelement erreicht den Mindestabstand), hat eine geringere Schwere; Zahlen benötigen tabular-nums nur dort, wo sie sich ändern; markiere dekorative Mock-Fenster mit aria-hidden oder ignoriere ihre Zeilen.
  4. Fahre von Hand, was kein Skript sehen kann, mit echten Pointer-Events (ein Klick im Browsertool, kein synthetisches .click()): Drücke jede bezahlte oder irreversible Aktion zweimal schnell und zähle die Server-Effekte; drossle das Netzwerk und einen Schreibvorgang auf 600 ms und drücke; öffne und schließe jede Ebene schnell und öffne sie während des Schließens erneut, um ihre Opazität zu messen (motion.md, „Öffnen messen“); drücke innerhalb eines sich schließenden Menüs; gib eine Abfrage mit Akzent und anderer Groß-/Kleinschreibung ein; bewege dich diagonal auf ein Hover-Untermenü zu; Android-Zurück mit einer geöffneten Ebene; wische ein Telefon-Sheet zu.
  5. Schreibe den Bericht aus report-template.md: Alle 40 Zeilen, jede vorhanden, fehlt, falsch oder überspringen mit einem Grund, Belegen als Datei:Zeile oder einer Zahl, und bauen oder aussuchen. Zeige ihn vor dem Beheben.

Durchgang 2: Beheben nach der Checkliste

  1. Zuerst Vertrauen: Punkt 39 und alles, was eine Zahlung verdoppeln oder Daten verlieren kann, mit einem Test, der vor der Behebung fehlschlägt.
  2. Bauen-Items ändern das Verhalten ohne neues Aussehen (Hit Slop, Safe Triangle, Zurück-Geste, Akzent-Faltung, Tastaturkürzel, Befehlsmenü-Einträge, Optimistische Schreibvorgänge, Skelette, Motion-Tokens, umkehrbare Übergänge). Korrigiere jeden nach seinem Muster in reference.md und motion.md, über die eigenen Komponenten und Tokens des Projekts, mit einem Test für jede Logik.
  3. Aussuchen-Items ändern das Aussehen oder das Produkt (Ecken, Unschärfe-Platzhalter, Rückgängig statt Bestätigung, ein Fehlerschlag, ein neuer Bewegungsschlag, ein View-Übergang). Beurteile jeden als Vorher und Nachher im Maßstab 1 in beiden Designs, nummeriert und trennbar; baue nur, was der Eigentümer auswählt.
  4. Ersetze niemals entfernte Dekoration durch neue Dekoration.

Durchgang 3: Verifizierung

Führe den Zensus und die Prüfung erneut aus und vergleiche die Zahlen mit dem Bericht. Teste jede korrigierte Interaktion so, wie ein Benutzer es tun würde, in beiden Designs und separat bei Telefonbreite. Berichte gebaut, getestet, visuell abgenommen und bereitgestellt als separate Fakten, und nenne, was nicht gemessen werden konnte (kein physisches Telefon, kein Produktions-Build).

Die Checkliste

Die Nummern stimmen mit reference.md und dem Bericht überein.

#PunktSchlägt fehl, wenn
AAnimationsprinzipien (motion.md)
1Quetschen und Streckenein Lande-Badge, Punkt oder Knopf bleibt tot stehen
2Antizipationein Druck hat keinen Zustand innerhalb eines Frames (Skalierung etwa 0,97, etwa 100 ms)
3Inszenierungeine geöffnete Ebene lässt die primäre Sache unklar
4Pose zu Poseein belegter Button, ein Label oder Icon-Wechsel springt in der Breite oder im Inhalt
5Durchziehender Inhalt einer Ebene kommt mit ihrem Container verschweißt an
6Langsam rein, langsam rauslinear oder Standard-ease bei UI-Bewegung; mehr als drei Easings
7Bögenetwas reist weit in einer geraden Linie
8Sekundäre Aktioneine abgeschlossene Aktion hat keinen bestätigenden zweiten Schlag
9Schnelles Timingeine UI-Antwort über 300 ms; eine Oberfläche abweichend von ihren Geschwistern; Exits nicht kürzer
10Übertriebenes Feedbackeine ungültige Übermittlung zeigt nur ein Zucken, keinen Farbschlag
11Solide ZeichnungSchatten und Ebenen stimmen bei Licht und Tiefe nicht überein
12Anziehungskraftein echter Ablauf, schrittweise bei Maßstab 1, zeigt eine Naht
BUX-Gesetze
13Fittsein echtes Ziel unter 32 px auf dem Desktop oder 44 px auf dem Telefon
14Größere TrefferbereicheZiele, die durch Vergrößern des Bildes vergrößert werden, oder überlappende Geschwister
15Hickmehr als fünf Einträge in einem Menüblock
16Millermehr als etwa sieben nicht gruppierte Einträge der obersten Ebene
17DohertyDrücken bis zum nächsten Paint über 400 ms, ohne dass zuerst etwas antwortet
18Posteleine Abfrage mit Akzent-, Groß-/Kleinschreibungs- oder Abstandsvariante findet nichts
19Jakobein Muster verhält sich anders als seine Plattform (Hover-Untermenü, Zurück schließt eine Ebene)
20Nutzungshäufigkeiteine tägliche Aktion ist mehr als einen Schritt oder einen Befehl entfernt
CGeschwindigkeit und Feedback
21Skelett-Ladebildschirmeeine Route zeigt leer oder einen Spinner im Klick-Frame
22Optimistische Aktualisierungenein günstiger umkehrbarer Schreibvorgang zeigt nichts, bis der Server antwortet
23Befehlsmenüein Ziel ist durch Klicken, aber nicht durch Tippen erreichbar
24Tastenkürzel-Hinweiseein Bedienelement mit einem Tastenkürzel zeigt es nicht in seinem Tooltip
25Rückgängig-Toastsein wiederherstellbarer Löschvorgang hat kein Rückgängig (der Eigentümer entscheidet, ob es eine Bestätigung ersetzt)
26Stale-While-Revalidateeine erneut besuchte Seite wartet, anstatt ihre letzten Daten zu zeigen
27Vorab-Renderingeine wahrscheinliche nächste Seite wird nicht bei Absicht vorab geholt (im Produktivbetrieb beurteilen)
28Unschärfe-Platzhalterein Ladebild ist eine graue Box
29View-Übergängeein Raster-zu-Detail-Öffnen hat keine Morphing-Animation mit gemeinsamem Element
30Wischen zum Schließenein Telefon-Sheet oder eine Schublade kann nicht durch Wischen geschlossen werden
31Unterbrechbare Animationenerneutes Öffnen während eines Exits beginnt bei Null
DPlattform und Detail
32Vorausschauendes ZurückAndroid-Zurück mit geöffneter Ebene verlässt die Seite
33Hit Slopkleine Symbolsteuerungen haben kein unsichtbares Zielwachstum
34Safe-Area-Insetsuntere schwebende Elemente ignorieren env(safe-area-inset-*) unter viewport-fit=cover
35Einmal-Code-Autofilleinem Codefeld fehlt autocomplete="one-time-code" und inputmode="numeric"
36Tabellarische Zahlensich ändernde Ziffern zittern (kein tabular-nums)
37Ausgeglichene Überschrifteneine kurze mehrzeilige Überschrift hinterlässt ein Waisenkind (kein text-wrap: balance)
38Kontinuierliche EckenSquircle-Ecken nicht berücksichtigt (eine Auswahlfrage: beurteile sie)
EVertrauen
39Idempotenz-Schlüsselzwei schnelle Drücke einer bezahlten oder irreversiblen Aktion verursachen zwei Server-Effekte
40Sicheres Dreieckein Hover-Untermenü schließt bei einer diagonalen Bewegung darauf zu

Häufige Fehler

  • Hinzufügen von bereits Vorhandenem: Skelette, Caching und Motion-Tokens sind oft bereits vorhanden; das Urteil ist vorhanden.
  • Client-Deduplizierung als Sicherheitsmaßnahme: Zwei Klicks landen, bevor ein erneutes Rendern den Button deaktiviert. Sichere auf dem Server ab (bedingte Aktualisierung, deterministischer Schlüssel, Sperre) und halte den Druck in einer Ref.
  • Vergrößern des Bildes anstelle des Ziels; Überprüfen der Ziele nur bei Desktop-Breite, während eine Desktop-Regel die Telefon-Mindestgröße außer Kraft setzt.
  • Keyframes für Öffnen und Schließen: Sie können nicht umgekehrt werden. Verwende Übergänge für ein Statusattribut und mache eine verlassende Ebene inert.
  • Rückgängig, Ecken oder Fehlerton als technische Entscheidungen behandeln. Sie gehören dem Eigentümer.
  • Vorab-Abruf oder Timing auf einem Entwicklungs-Server oder einem Hintergrund-Tab beurteilen.

Verwandte Skills