Communitygithub.com

axewhyzed/agentic-skills

Betriebsrahmen für hochdichte, verschwendungsfreie moderne Webanwendungen, Tool-Dashboards und produktive Arbeitsbereiche. Verwenden Sie dies beim Entwerfen, Entwickeln oder Refaktorieren von Web-Oberflächen (React, TypeScript), Zwei-Fenster-Master-Detail-Layouts, einheitlichen Compose-Hubs, tastaturgesteuerter Navigation, Befehlspaletten (cmdk), Live-Telemetrie-Indikatoren und granularer Authentifizierungsergonomie.

Was ist agentic-skills?

Dieser Skill definiert ein umfassendes operatives Framework für die Entwicklung hochdichter, verschwendungsfreier Webanwendungen, das sich auf Werkzeug-Dashboards, Admin-Panels und produktive Arbeitsbereiche konzentriert. Er behandelt eine breite Palette von Design- und Implementierungsmustern, die für moderne, leistungsorientierte Web-Apps entscheidend sind. Der Skill basiert auf einer „Zero-Waste“-Philosophie, die dekorative Heldenbanner in eingeloggten Zuständen eliminiert, und maximiert die Nutzung des Viewports durch 100vh-Layouts und unabhängige Scroll-Container. Er bietet detaillierte Anleitungen zur Implementierung einer linearen, hochdichten Ästhetik mit subtilen 1px-Grenzen, tiefen Schiefer-/Obsidian-Hintergründen, monospace tabellarischen Zahlen und einem kompakten Abstands-Raster auf 4px/8px-Basis. Der Skill umfasst außerdem die Integration einer globalen Befehlspalette (cmdk) mit Tastaturnavigation, ein einheitliches Compose-Hub-Muster für verschiedene Datentypen mit Live-Zeichen- und Byte-Zählung sowie WCAG 2.2-konforme Farbkontrastrichtlinien. Er unterstützt Plattformen wie React und TypeScript und enthält Referenzen zu führenden Open-Source-Bibliotheken wie shadcn/ui und cmdk. Die Implementierung gewährleistet eine hohe Informationsdichte ohne visuelle Überladung und bietet detaillierte UX für Sicherheits- und Authentifizierungsaktionen, einschließlich der Unterscheidung zwischen lokalem Logout und globaler Sitzungswiderrufung.

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/axewhyzed/agentic-skills/tree/HEAD/.agents/skills/modern-web-ui-ux

In Ihrer bevorzugten KI fragen

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

Dokumentation

Modernes Web-UI/UX & Design für hochdichte Arbeitsbereiche

Ein umfassender operativer Leitfaden für die Entwicklung hochdichter, verschwendungsfreier Webanwendungen, Utility-Dashboards und produktiver Web-Arbeitsbereiche.


1. Die Zero-Waste-Web-Philosophie

Produktive Webanwendungen (Tools, Admin-Panels, Kommunikationsrelais, Entwickler-Dashboards) sind keine Landingpages. Benutzer kommen, um eine Aufgabe zu erledigen, nicht um Marketinggrafiken zu bewundern.

1.1 Die Anti-Helden-Regel

  • ❌ Anti-Pattern: Ein riesiges, 300px dekoraives Heldenbanner oben auf einem App-Bildschirm platzieren („Willkommen in Ihrem Posteingang!“, schwebende abstrakte Illustrationen, riesige Farbverläufe), das die eigentlichen Daten und interaktiven Steuerelemente unter den Fold drückt.
  • ✔️ Das Zero-Waste-Muster: Entfernen Sie Marketing-Heldenbanner vollständig aus eingeloggten Zuständen. Verwenden Sie eine kompakte 56px Topbar, die Folgendes integriert:
    1. Dezente Markenidentität / Symbol.
    2. Live-Systemtelemetrie oder Kontingentanzeigen (z. B. Speicher-Pill: 14 MB / 2 GB).
    3. Aktions-Modal-Trigger (z. B. „Gerät koppeln“).
    4. Schnelle Theme-Umschalter (Dunkel / Hell).
    5. Kompaktes Benutzer-Dropdown mit separater lokaler Abmeldung und Sicherheitsoptionen.

1.2 Viewport-Maximierung

  • 100vh-Layouts: Sperren Sie die Ansichtsfensterhöhe des Roots (height: 100vh; overflow: hidden;) und erstellen Sie unabhängige Scroll-Container für Inhaltslisten und Detail-Inspektoren.
  • Keine versehentlichen Scrollbalken: Vermeiden Sie doppelte Scrollbalken, indem Sie overflow-y: auto nur auf internen Listencontainern sorgfältig verwalten.

2. Die lineare, hochdichte Ästhetik

Inspiriert von den Designparadigmen, die von Linear, Vercel und Raycast populär gemacht wurden:

2.1 Visuelle Hierarchie & Tokens

  • Subtile 1px-Ränder: Vermeiden Sie starke Schlagschatten. Verwenden Sie feine 1px-Ränder (border-border/40 oder #1E293B), um Struktur zu schaffen.
  • Tiefe Schiefer-/Obsidian-Hintergründe: Verwenden Sie kontrastreiche, ungesättigte Hintergründe (#0B0F17 oder #090D16) anstelle von reinem Schwarz (#000000) oder matschigen Grautönen.
  • Monospace-Tabellarische Zahlen: Verwenden Sie immer font-mono tabular-nums für Daten, Zeitstempel, Dateigrößen und Zähler, sodass Zahlen vertikal ausgerichtet sind und kein Layout-Jitter entsteht.
  • Kompaktes Abstands-Raster: Standardisieren Sie auf einen 4px/8px-Rhythmus. Polstern Sie Zeilen mit 8px–10px vertikal und 12px horizontal für maximale Informationsdichte ohne visuelle Klaustrophobie.

2.2 Befehlspalette (cmdk-Muster)

Integrieren Sie zusätzlich zur Standardsuchleiste eine globale Befehlspalette, die mit ⌘K oder Ctrl+K ausgelöst wird:

  • Gruppierte Aktionen: Navigation, Erstellung, Systemeinstellungen, Kontoverwaltung.
  • Sofortige Fuzzy-Suche über Elemente, Dateien und Verknüpfungen.
  • Vollständig zugängliche Tastaturnavigation (Pfeil abwärts, Pfeil aufwärts, Eingabetaste, Escape).

3. Das einheitliche Compose-Hub-Muster

Wenn eine Anwendung Benutzern erlaubt, verschiedene Arten von Daten zu erstellen, hochzuladen oder zu senden (z. B. Textnotizen, URLs, Dokumente), vermeiden Sie es, Einstiegspunkte über verschiedene Seiten zu verstreuen oder am unteren Rand zu vergraben.

+-------------------------------------------------------------+
| Compose Hub                                                 |
| [ 📝 Text ]  [ 🔗 Weblink ]  [ 📁 Datei-Upload ]            |
+-------------------------------------------------------------+
|                                                             |
|  Aktiver Formular-/Drag-&-Drop-Zielbereich                  |
|  - Mehrzeiliges Textfeld für Notizen                        |
|  - Saubere URL-Eingabe mit automatischer Validierung        |
|  - Drag-&-Drop-Zone mit sofortiger Datei-Staging-Vorschau  |
|                                                             |
+-------------------------------------------------------------+
| Aufbewahrung: [ 1 Tag ] [ 3 Tage ] [ 7 Tage ]    [ In Tresor ablegen ↵ ] |
+-------------------------------------------------------------+

Schlüsselelemente eines effektiven Compose-Hubs:

  1. Segmentierter Tab-Umschalter: Saubere Pill-Tabs mit sofortigem Wechsel ohne Formularzurücksetzung.
  2. Drag-&-Drop-Zone: Native HTML5-Drag-and-Drop-Behandlung mit visueller Rahmenhervorhebung (border-dashed border-accent) und Byte-Größenvalidierung.
  3. Live-Zeichen- & Byte-Zählung: Berechnen Sie echte UTF-8-Bytes in Echtzeit (z. B. 124 Bytes oder 18,4 MB / 100 MB).
  4. Lebenszyklus-/Aufbewahrungssteuerung: Ermöglichen Sie dem Benutzer, den Ablauf im Voraus festzulegen, sodass das System temporäre Elemente automatisch bereinigt.
  5. Tastatur-Submission: Ctrl + Enter (oder Cmd + Enter) zum Absenden aus jedem aktiven Texteingabefeld.
  6. Hochkontrast-Aktivzustände (WCAG 1.4.11):
    • Aktiver Tab-Kontrast: Im Dunkelmodus darf ein aktiver Tab NIEMALS mit seinem Container verschmelzen (#111827 aktiv auf #0F172A Container ist nur 1,02:1). Erhöhen Sie den aktiven Tab immer mit --card-elevated: #1E293B, einem expliziten 1px semantischen Rahmen (1px solid var(--accent)), einem aktiven Glow-Rahmen (box-shadow: 0 0 0 1px var(--accent-glow)) und einem aktiv getönten Symbol.
    • Formularsteuerungsgrenzen: Retentionseingaben, Dropdown-Symbole und sekundäre Schaltflächen im Dunkelmodus müssen Rahmen mit einer Deckkraft von mindestens 18 % Weiß verwenden (rgba(255, 255, 255, 0.18) oder #334155), um die 3:1-Anforderung für Nicht-Text-Kontrast zu erfüllen.

4. Hochdichte Master-Detail-Layouts (Zwei-Fenster)

Für die Datenansicht halten Master-Detail-Layouts den Kontext sichtbar, während eine tiefgehende Inspektion möglich ist.

flowchart LR
    subgraph MasterPane["Master-Fenster (Links: 40% - 45%)"]
        SearchBar["Sofort suchleiste (Hotkey: /)"]
        FilterChips["Filter-Chips: [Alle] [Dateien] [Links] [Text]"]
        ListItems["Virtualisierte / Scrollbare Elementzeilen
        - Typ-Symbol + Titel
        - Absendergerät-Badge
        - Relativer Zeitstempel
        - Schnelles Wischen / Aktion"]
    end

    subgraph DetailPane["Detail-Fenster (Rechts: 55% - 60%)"]
        DetailHeader["Elementtitel & Typ-Badge"]
        PreviewArea["Live-Inhaltsvorschau:
        - Klickbare Links
        - Syntax-hervorgehobener Text
        - Bild-/Dokumentenvorschau"]
        ActionRow["Primäraktionen:
        [ Link öffnen ] [ Text kopieren ] [ Datei herunterladen ] [ Löschen ]"]
    end

    MasterPane -->|"Auswahlzustand"| DetailPane

Best Practices:

  • Sticky Filter & Suchkopf: Die Sucheingabe und die Filter-Chips müssen fixiert bleiben, während die Elementliste darunter scrollt.
  • Leere & Null-Ergebnis-Zustände: Stellen Sie klare visuelle Zustände bereit:
    • Noch keine Elemente: „Ihr Posteingang ist leer. Verwenden Sie den Compose Hub oben, um Ihr erstes Element abzulegen.“
    • Keine Suchergebnisse: „Keine Elemente gefunden für ‚Steuererklärung‘. [Suche löschen].“

5. Tastaturnavigation & Barrierefreiheit (a11y)

Leistungsstarke Benutzer erwarten Tastaturflüssigkeit:

AbkürzungAktionImplementierung
/ oder ⌘KSucheingabe fokussierendocument.addEventListener('keydown', ...) mit input.focus()
EscapeSuche löschen / Aktives Modal schließenSchließt das oberste Modal oder blurrt das Suchfeld
Ctrl + EnterAktives Formular absenden / Element sendenonKeyDown-Handler des Formulars
Tab / Shift + TabLogische DOM-ReihenfolgeErzwingen Sie zugängliche :focus-visible-Ringe (blauer Umriss von $2\text{px}$)

5.1 WCAG 2.2 AA / AAA Farbkontrast-Audit

Versenden Sie niemals Webanwendungen mit ungeprüften oder kontrastarmen Designtokens:

  • Normaler Textkontrast ($\ge 4,5:1$ AA, $\ge 7:1$ AAA):
    • Hellmodus-Falle: Slate-400 (#94A3B8) auf #FFFFFF ist nur 2,57:1 (fällt AA durch). Verdunkeln Sie sekundären Text im Hellmodus mindestens auf Slate-500 (#64748B), was 4,77:1 ergibt.
    • Warnung-/Bernstein-Badge-Falle: Bernstein-600 (#D97706) auf #FFFFFF ist nur 3,22:1 (fällt AA durch). Verdunkeln Sie auf Bernstein-700 (#B45309) für Text-Badges, was 4,82:1 ergibt.
    • Dunkelmodus-Text: Stellen Sie sicher, dass text-primary (#F8FAFC, 15,6:1 AAA) und text-secondary (#CBD5E1, 11:1 AAA) eine mühelose Lesbarkeit auf tiefen Schieferkarten bieten.
  • Komponenten- & Rahmenkontrast ($\ge 3:1$, WCAG 1.4.11):
    • Formulareingaben, Suchfelder und segmentierte Steuerungsrahmen im Dunkelmodus müssen einen Kontrast von $\ge 3:1$ zu benachbarten Containern aufweisen.
    • Fokus-Indikatoren müssen hochkontrastreiche Primärringe verwenden (box-shadow: 0 0 0 2px var(--focus-ring)).

6. Granulare Sicherheits- & Authentifizierungs-UX

Verwechseln Sie nicht normale alltägliche Benutzeraktionen mit sicherheitsrelevanten Aktionen mit hohem Risiko.

6.1 Lokale Abmeldung vs. Globale Widerrufung

  • Abmelden (Lokal): Löscht das Sitzungscookie nur im aktuellen Browser. Dies ist die Routineaktion, die Benutzer auf gemeinsam genutzten Computern ausführen.
  • Überall abmelden (Global): Widerruft alle aktiven Refresh-Tokens und Gerätesitzungen auf allen registrierten Telefonen, Laptops und Browsern.
    • Sicherheitsregel: Platzieren Sie „Überall abmelden“ niemals als direkte Ein-Klick-Schaltfläche in einem Standardmenü. Schützen Sie es immer mit einem dedizierten Modal und einem expliziten Bestätigungsschritt („Sind Sie sicher? Dies wird Ihr Telefon und andere Geräte trennen.“).

6.2 Gerätekopplungs-UX

  • Rendern Sie Kopplungs-QR-Codes in einem leichten Dialog mit:
    • Hochkontrastreichem SVG-QR-Code.
    • Echtzeit-Countdown-Timer (z. B. „Läuft ab in 09:42“).
    • Fallback-Textgeheimnis mit einer Ein-Klick-Kopier-Schaltfläche für Geräte ohne funktionierende Kamera.

7. Referenz-Open-Source-Repositories

Inspizieren Sie diese branchenführenden Repositories für Design, Token-Struktur und Implementierungsinspiration:

  • shadcn/ui: Unstyleierte, zugängliche Komponenten-Primitive, die Radix UI und Tailwind CSS mit modernen hochdichten Standardeinstellungen kombinieren.
  • pacocoursey/cmdk: Der Goldstandard für zugängliche Befehlsmenü-Komponenten, die von Linear, Vercel und Raycast verwendet werden.
  • henrikzabel/linearlike: Kuratierter Index von produktionsreifen Webanwendungen, die die Linear-Ästhetik nutzen.
  • ln-dev7/circle: Open-Source-Linear-inspirierter Issue-Tracker, der dichte Tabellen und Seitenleisten-Navigation demonstriert.
  • calcom/cal.com: Enterprise-Level-React-Arbeitsbereichslayout mit sauberen Mehrfachfenster-Einstellungen, granularen Dialogen und sofortiger Navigation.

Individual skills in this repo

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

Verwandte Skills