Communitygithub.com

omd:feel – Interface Feel, quantifiziert

Quantifiziert und prüft Interface-Details, die in der Branche oft nach 'Gefühl' festgelegt werden. Basiert auf der Philosophie von Jakub Krehel und erweitert um HIG/Material/WCAG/DS-Token und Praktiker-Recherche – 17 Achsen, 113 Regeln mit Herkunftsstufen.

Was ist omd:feel – Interface Feel, quantifiziert?

Der Skill 'omd:feel' verwandelt subjektive Interface-Details – wie 'ungefähre Geschwindigkeit', 'ungefähren Schatten' oder 'ungefähren Abstand' – in überprüfbare, mit Herkunftsstufen versehene Zahlen. Er wendet quantitative Regeln an (APPLY) oder auditert bestehende UI-Codebasis (AUDIT) – unterstützt HTML, JSX, TSX, CSS. Die Regeln decken 17 Achsen ab: Motion & Timing, Easing & Springs, Spacing, Radius, Shadow, Typografie, Kontrast, Zustände, Targetgrößen, Scrollen, Reaktionszeit, Layout-Stabilität (CLS), Modals, Performance, Glass-Effekte, Barrierefreiheit und Formularvalidierung – insgesamt 113 Einzelregeln. Jede Regel hat eine Herkunftsstufe (Tier): SPEC (W3C/WCAG, HIG, normativ), DS (Designsystem-Token), CONV (Branchenkonvention), OP (einzelne Meinung) oder FOLK (nicht verifizierte Überlieferung). Bei AUDIT werden SPEC/DS-Verstöße als BLOCK, CONV als WARN, OP/FOLK als FYI gemeldet. Der Skill arbeitet plattformunabhängig und wird durch Schlüsselphrasen wie 'feel 좋게 다듬어줘', 'make this feel better', 'polish the interactions', '인터페이스 디테일 적용', 'feel 점검', '마이크로 인터랙션 손봐줘' aktiviert. Brand-Token aus einer DESIGN.md (via omd:apply) haben immer Vorrang.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

omd:feel — Interface Feel, quantifiziert

Verwandelt Interface-Details, die in der Branche oft nach Gefühl festgelegt werden – „etwa diese Geschwindigkeit“, „etwa dieser Schatten“, „etwa dieser Abstand“ – in überprüfbare Zahlen mit Herkunftsstufe und wendet sie an oder auditiert sie. Der Skill führt Jakub Krehels „great interfaces are a collection of small things that compound“ fort, beantwortet aber auch welche Zahl richtig ist / wann sie falsch liegt – numerisch.

Kernthese: Qualität ist das Integral dutzender kleiner Constraints, die in ihrem jeweiligen Band gehalten werden. Ein 600-ms-Checkbox-Tick, ein 1-pt-Fokusring, ein Textkontrast von 2,85:1, ein Hover-Lift ohne @media (hover:hover)-Guard – jedes einzelne ist ein messbarer Abzug vom „Feel“. Dieser Skill verhindert diese Abzüge.

Alle Regeln (17 Achsen, 113 Stück) stehen in reference.md, Herkunft, Stufe und Methodik jeder Zahl in provenance.md. Der untenstehende Spickzettel ist der immer geladene Kern; für tiefgehende Audits und Randachsen die Referenz lesen.

Wann verwenden

  • APPLY — Beim Erstellen oder Überarbeiten von UI quantitative Feel-Regeln einspritzen. („Feel verbessern“, „Interaktionen überarbeiten“, „Details anwenden“)
  • AUDIT — Bestehenden HTML/JSX/TSX/CSS-Code gegen die Regelmatrix prüfen → Feel-Score + BLOCK/WARN/FYI-Report. („Feel prüfen“, „Diesen Screen auditieren“)

Nicht auslösen bei reiner Text-/IA-Arbeit ohne UI-Bezug.

0. Herkunftsstufe → Durchsetzungsstärke (Herz des Skills)

Jede Regel trägt eine Stufe (Tier), die ihre Durchsetzungsstärke bestimmt. Das ist die Methode, „Gefühl ehrlich zu quantifizieren“ – Spezifikationszahlen sind Gates, Geschmackszahlen sind Vorschläge.

BadgeStufeAPPLYAUDIT severity
🟢 SPECspec-authoritative (W3C/WCAG·HIG·normativ)ErzwungenBLOCK
🟢 DSds-token (committete Designsystem-Token)Erzwungen (wenn Brand nicht überschreibt)BLOCK
🟡 CONVindustry-convention (≥2 unabhängige Praktiker konvergent)Als Default anwendenWARN
⚪ OPsingle-opinion (vertrauenswürdige Einzelperson)Nur VorschlagFYI
⚪ FOLKfolklore-unverified (Quelle nicht nachvollziehbar)Vorschlag + Stufe angebenFYI

Verteilung: SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 haben Spezifikations- oder Token-Grundlage (erzwingbar).

DESIGN.md gewinnt immer. Wenn Brand-Token in DESIGN.md mit einer Regel kollidieren, haben die Brand-Token Autorität. Diese Regeln sind die Defaults für den Fall, dass der Brand schweigt, kein Override. Liegt eine DESIGN.md im Projektstamm, liest omd:apply zuerst die Token; nur leere Achsen werden mit Feel-Regeln gefüllt.

1. Spickzettel — Kernzahlen, die immer gelten

Tier-Notation: 🟢=erzwungen, 🟡=Default, ⚪=Vorschlag. Bei Konflikt: DESIGN.md > 🟢 > 🟡 > ⚪.

Motion & Timing

  • Alltägliche UI-Übergänge ~200ms (hover ≤150 · popover ~200 · overlay/modal ~300). Bereich 150–300ms, >400ms wirkt träge. 🟡
  • Dauer auf 50ms-Raster quantisiert (220/333ms verboten). 🟢
  • Exit ≈ 0,8 × Enter (schneller schließen als öffnen). 🟢
  • Keine einzige globale Dauer – proportional zur Bewegungsfläche/-distanz. 🟢

Easing & Springs

  • Enter/Nutzer-Trigger = ease-out cubic-bezier(0,0,0.2,1) · Exit = ease-in/accelerate · Bereits sichtbares Morph = ease-in-out · Spinner/Progress = linear. Enter ohne ease-in. 🟡
  • Apple = spring default (response 0.55, damping 0.825, bounce 0), funktionale UI bounce <0,4. 🟢
  • Interruptible: Interaktive Zustände transition/spring (neu zielbar), nur One-Shot-Animationen @keyframes. 🟢

Spacing · Radius · Rhythmus

  • 8px-Basis, 4px-Halbschritt (4·8·12·16·24·32·40·48·64). 🟢
  • Inneres Padding ≤ äußerer Gap zwischen Geschwistern. 🟡
  • Konzentrischer Radius: außen = innen + Padding. 🟢
  • UI-Typskala ~1,25(große Terz). 🟡

Shadow & Tiefe

  • Geschichtete Schatten 3–5 Lagen, Lichtquelle oben. Niedrige Höhe=tight+sharp, hohe Höhe=diffuse+spread (Tailwind md→lg-Rampe). 🟡/DS
  • Darkmode nutzt helle Oberflächen statt Schatten für Tiefe. 🟡

Typografie

  • Fließtext line-height 1,5, Maß ~66 Zeichen (45–75). 🟢
  • Display-Tracking −0,02–−0,03em, Versalien +0,05–0,1em, Fließtext ~0. 🟡
  • Wechselnde Zahlen mit tabular-nums; Titel text-wrap: balance, Fließtext pretty; Layout antialiased. (seed/jakub) 🟡

Farbe & Kontrast

  • Text 4,5:1(groß 3:1) AA · Nicht-Text/UI-Grenzen 3:1 · Focus-Ring 3:1 + 2px + ~2px Offset. 🟢
  • M3 State Layer: hover 8% · focus 10% · pressed 10% · dragged 16%. 🟢
  • Deaktiviert ~38% Deckkraft. 🟡

Zustände & Feedback

  • Datenkomponenten: alle 5 Zustände (empty/loading/error/content/skeleton) definieren. 🟡
  • Pressed: scale 0,96–0,97, 150ms ease-out (Boden 0,95). DS/⚪
  • Ikonen-Zustandswechsel: scale+opacity+blur 4px→0, spring ~0,3. 🟡

Targets & Zeiger

  • Tab-Target 44pt(iOS/WCAG AAA) / 48dp(Material) / 24px(WCAG AA min), benachbarte Targets ≥8pt. 🟢
  • Cursor: interaktiv=pointer · inaktiv=not-allowed · ziehen=grab→grabbing · bearbeiten=text. 🟡

Scrollen & Gesten

  • Overlay/verschachtelte Scrollbereiche: overscroll-behavior: contain (Scroll-Chaining · PTR unterbinden). 🟢
  • Swipe-Entschwelle ~30% Distanz oder velocity flick. DS
  • scroll-snap: langes Formular=proximity · Karussell=mandatory. 🟢

Antwortzeit & wahrgenommene Performance

  • 100ms = sofortig · 1s = Denkflussgrenze · 10s = Aufmerksamkeitsgrenze (% Progress anzeigen). Doherty 400ms Decke. 🟢
  • INP ≤200ms p75, Frame-Budget 16,6ms. 🟢
  • Spinner nur bei erwarteter Wartezeit >1s; wenn eingeblendet, mindestens 500ms halten (Flackern vermeiden). Bei bekanntem Layout: Skeleton. 🟡/DS

Layout-Stabilität (CLS)

  • CLS ≤0,1 p75. Medien mit width/height oder aspect-ratio Platz reservieren. scrollbar-gutter: stable. font-display: optional(oder swap)+metric override. Keine Einfügung von Inhalten oberhalb des aktuellen Inhalts außerhalb des 500ms-Eingabefensters. 🟢

Modals · Overlays · Z-Index

  • role=dialog + aria-modal=true, beim Öffnen Fokus auf Dialog, Tab-Trap, Esc schließt, beim Schließen Fokus zurück zum Trigger, Hintergrund inert. Scrim #000 ~32%. 🟢
  • light-dismiss: temporäre/Info-Dialoge AN, Dateneingabe·destruktive Aktionen AUS. 🟢
  • Z-Leiter: dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700. Overlays portal. (Lückenfüller)

Performance · Glass · A11y

  • Animationen nur transform/opacity(+filter), transition: all verboten; will-change transient (bei Ruhe entfernen). 🟢
  • Glass: backdrop-filter: blur(16px) saturate(180%) + halbtransparente Füllung ~0.6 + 1px Haarlinie + undurchsichtiger Fallback, Text ≥4,5:1. 🟡/🟢
  • prefers-reduced-motion: reduce → cross-fade/sofortiger Übergang, große Bewegungen/Parallax entfernen (kleine Opacity bleibt). ≤3 Blitze/s. Focus-Outline nicht ohne Alternative entfernen(:focus-visible). 🟢

Formularvalidierung

  • Primäre Validierung bei blur, einmal fehlerhafte Felder wechseln zu on-change (live) – Fehler wird sofort beim Korrigieren aufgehoben. Async-Validierung debounce 300–500ms. 🟡

2. APPLY-Workflow

  1. Kontext erkennen — Liegt DESIGN.md im Projektstamm/Zielordner? Wenn ja: zuerst Token (Farbe·Radius·Spacing·Motion·Type) via omd:apply lesen. Brand-Token = Autorität.
  2. Leere Achsen füllen — Nur Achsen, zu denen DESIGN.md schweigt, mit Spickzettel-Defaults füllen. Tiefe Achsen (Scroll-Physik·Glass·Z-Leiter·CLS) in reference.md nachschlagen.
  3. Tier respektieren — 🟢 direkt anwenden, 🟡 als Default (Brand/Anfrage kann überschreiben), ⚪/FOLK: „Das ist eine Geschmacks-Heuristik“ klarstellen und nur vorschlagen.
  4. Begründung im Output hinterlassen — Nicht offensichtliche Zahlen (z. B. Exit 0,8×, Focus-Offset 2px) mit einer Zeile „Warum“ + Tier in Codekommentar oder Erläuterung versehen. Keine Zahlen erfinden – wenn nicht im Spickzettel/Referenz, Referenz lesen oder „weiß ich nicht“ sagen.
  5. prefers-reduced-motion immer begleitend — Wird Motion eingefügt, gehört der Reduce-Zweig dazu (A11y ist kein optionales Feature).

3. AUDIT-Workflow

Wie omd:designer-review – advisory (read-only) Muster + Feel-Achse. Bei jedem Aufruf DESIGN.md neu lesen (kein Caching).

  1. Eingabe: artifact_path(HTML/JSX/TSX/CSS) + (optional) design_md_path + Viewport.
  2. machine_check-Scan — Jede Regel in reference.md mit 🔍 machine_check auf das Artefakt anwenden. Beispiele:
    • transition: all / >400ms Dauer / Off-Grid-Dauer → erkennen
    • Tab-Target <44px, Focus-Outline entfernt, Textkontrast <4,5:1
    • <img> ohne aspect-ratio, Modal ohne aria-modal, Overlay ohne overscroll-behavior
  3. Severity = Tier-Mapping — SPEC/DS-Verstoß = BLOCK, CONV = WARN, OP/FOLK = FYI. (Severity-Inflation/-Deflation verboten.)
  4. feel-score — Anteil der anwendbaren Achsen im Band: 🟢 in-band / 🟢 applicable als Kernzahl, WARN/FYI nebensächlich. „feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5“.
  5. Ausgabe: <work_dir>/.reviews/feel-audit-round-<N>.md — pro Issue Zeilennummer + Tier + machine_check-Begründung + Behebung (actionable). Keine Issues ohne Zeilennummer, kein „sieht gut aus“-Gummistempel.
### [BLOCK] Tap target unter Minimum – Icon-Button
- **Ort:** `components/Toolbar.tsx:31`
- **Regel:** §8 Targets — 44pt/48dp/24px min (🟢 SPEC, WCAG 2.5.8)
- **Nachweis:** `<button className="w-6 h-6">` → 24px, kein hit-slop
- **Behebung:** 44×44 Hit-Region durch Padding (`p-2.5` + visuelles 24px-Icon beibehalten)

4. Leitplanken

  • ❌ Verboten: Folklore als Spezifikation präsentieren. ⚪/FOLK immer mit Tier kennzeichnen. (Demote-Liste in Corpus Appendix B – Hick-Hyman 0,155s/bit, Fitts ms/bit, rubberband 0,7, pressed 0,95 Boden, exit 0,8×, stagger 80/100ms, optical 2px usw. – nur als Richtung, nicht als Zahlengate erzwingen.)
  • ❌ Verboten: Zahlen erfinden. Nicht im Spickzettel/Referenz → Referenz lesen oder „weiß ich nicht“ sagen.
  • ❌ Verboten: DESIGN.md ignorieren und mit allgemeinen Best Practices überschreiben. Brand-Token zuerst.
  • ❌ Verboten: Motion einfügen ohne prefers-reduced-motion-Zweig.
  • ❌ Verboten: Im AUDIT Severity-Inflation (alles BLOCK), -Deflation (BLOCK zu FYI) oder Issues ohne Zeilennummer.
  • ❌ Zahlenänderungen nicht manuell in reference.md vornehmen, sondern per Corpus → Generator neu erstellen.

5. omd-Ökosystem-Beziehungen

  • omd:apply — Wendet Brand-Token aus DESIGN.md an. omd:feel füllt darauf die Feel-Ebene, zu der die Token schweigen.
  • omd:designer-review — Auditiert Brand-Konsistenz (Typo/Color-Budget/Radius-Skala). omd:feel AUDIT ist der Feel-Achsen-Partner (Motion-Timing·Targets·CLS·A11y).
  • omd:taste — Nutzer-Geschmacks-Dashboard (eigenes Konzept). Wiederkehrende Feel-Entscheidungen, die zu Geschmack werden, werden an omd:remember weitergereicht.

Manuelle Verifikation: transition: all 0.6s + <button class="w-5 h-5"> + Komponente ohne prefers-reduced-motion-Zweig auditieren → mindestens 3 BLOCKs (transition all=GPU SPEC, 20px Target=WCAG SPEC, reduced-motion fehlt=a11y SPEC) erscheinen mit Zeilennummer und der feel-score wird entsprechend abgezogen.

Verwandte Skills