Communitygithub.com

curiositech/port-daddy

Erstellt einzigartige Web-Designs mit Markenidentität, Farbpaletten, Typografie und modernen UI/UX-Mustern. Verwende es für Markenentwicklung, visuelle Designsysteme, Layout-Komposition und responsives Webdesign. Aktivieren bei „Webdesign“, „Markenidentität“, „Farbpalette“, „UI-Design“, „visuelles Design“, „Layout“. NICHT für Typografie-Details (nutze typography-expert), Farblehre-Vertiefungen (nutze color-theory-expert), Designsystem-Tokens (nutze design-system-creator) oder Code-Implementierung ohne Designvorgabe.

Was ist port-daddy?

Dieses Skill für KI-Agenten wie Claude Code, Cursor oder Codex ist ein spezialisierter Webdesign-Experte, der auf die Erstellung einzigartiger visueller Systeme für Webanwendungen fokussiert ist. Es unterstützt den Agenten bei der Entscheidungsfindung für Layouts, Farbstrategien und visuelle Hierarchien, abhängig vom Anwendungstyp (z.B. content-lastig, marketingorientiert, Dashboard). Die SKILL.md enthält detaillierte Entscheidungsbäume und Qualitätskontrollen (Quality Gates) wie WCAG AA-Kontrast (4.5:1), mobile-first Layouts und Touch-Ziele von mindestens 44px. Es definiert fünf typische Fehlermodi (z.B. „Design by Committee Syndrome“, „Decoration Over Function“) und bietet strukturierte Worked Examples für SaaS-Dashboards und E-Commerce-Seiten. Das Skill integriert Tools wie einen `design_audit.mjs`-Checker für deterministisches Prüfen von Designplänen und erfordert eine mechanische Layout-Prüfung (Layout Overflow Guard) vor dem Ausliefern. Es grenzt sich klar von anderen Skills ab, z.B. für Typografie, Farblehre oder Barrierefreiheit, und verweist auf Referenzen für Raster, Farbzugänglichkeit und Tooling-Integration.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/curiositech/port-daddy/tree/HEAD/skills/web-design-expert

In Ihrer bevorzugten KI fragen

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

Dokumentation

Webdesign-Experte

Erfahrener Webdesigner, der unverwechselbare visuelle Systeme für Webanwendungen erstellt.

Entscheidungspunkte

Layout-Ansatz Auswahl

WENN content-lastig (Blog, Dokumentation, Lernplattform)
├─ 12-Spalten-Rastersystem
├─ Hohe Textdichte mit klarer Hierarchie
└─ Konsistente Ränder für Lesbarkeit

WENN Marketing-/Conversion-fokussiert (SaaS, E-Commerce-Landingpage)
├─ Hero-Section-first-Design
├─ Asymmetrische Layouts für Dramatik erlaubt
└─ Große Leerräume, um Aufmerksamkeit zu lenken

WENN E-Commerce-/Katalog-lastig
├─ CSS Grid auto-fit für Produkte
├─ Kartenbasierte Layouts
└─ Filter/Suche prominent

WENN Dashboard/App-Oberfläche
├─ Sidebar + Hauptinhalt
├─ Datendichte priorisiert
└─ Navigation immer zugänglich

WENN Redaktions-/Magazinstil
├─ Gemischte Rastersysteme
├─ Große Bilder mit Zitaten
└─ Visuelle Vielfalt vor Konsistenz

Strategie für Farbpalette

WENN B2B/Unternehmenszielgruppe
├─ Blau als Primärfarbe (Vertrauen, Professionalität)
├─ Neutral-lastige Palette
└─ Minimale Akzentfarben

WENN Verbraucher-/Lifestyle-Marke
├─ Wärmere Primärfarben (Orange, Grün, Lila)
├─ Saisonale Akzentoptionen
└─ Emotional getriebene Entscheidungen

WENN Vielverkehrs-/Barrierefreiheitskritisch
├─ 4,5:1 Kontrastminimum durchgesetzt
├─ Farbenblind-getestete Kombinationen
└─ Dark-Mode-Varianten erforderlich

Entscheidungsbaum für visuelle Hierarchie

WENN Benutzerziel = sofortige Aktion (Anmeldung, Kauf)
├─ Hero-CTA oberhalb der Falte (obligatorisch)
├─ Einzelne primäre Aktion pro Seite
└─ Visuelles Gewicht auf Conversion-Elementen

WENN Benutzerziel = Konsum von Inhalten
├─ Inhaltsvorschau/-zusammenfassung zuerst
├─ Mehrere Engagement-Pfade in Ordnung
└─ Leseerfahrung optimiert

WENN Benutzerziel = Erkundung (Portfolio, Katalog)
├─ Raster-/Galerie-Layout primär
├─ Schnelles Scannen optimiert
└─ Miniaturansicht → Detail-Fluss

Fehlermodi

Design-by-Committee-Syndrom

  • Symptome: Mehrere visuelle Stile auf derselben Seite, widersprüchliche Markenbotschaften, kein klares Designsystem
  • Erkennungsregel: Wenn Sie 3+ verschiedene Button-Stile oder Schriftfamilien auf einer Seite sehen
  • Behebung: Designprinzipien-Dokument erstellen, Single Source of Truth durchsetzen, Zustimmung der Beteiligten zu Einschränkungen einholen

Dekoration über Funktion

  • Symptome: Animationen ohne Zweck, visuelle Elemente, die das Verständnis nicht fördern, langsames Laden aufgrund von Grafiken
  • Erkennungsregel: Wenn Sie nicht erklären können, wie jedes visuelle Element dem Benutzer hilft, sein Ziel zu erreichen
  • Behebung: Elemente entfernen, die nicht den Benutzerbedürfnissen dienen, jede Animation mit Benutzervorteil rechtfertigen

Mobile-Alternative-Muster

  • Symptome: Horizontales Scrollen auf Mobilgeräten, winzige Touch-Ziele, Desktop-Navigation auf kleinen Bildschirmen
  • Erkennungsregel: Wenn die mobile Version Zoomen oder horizontales Scrollen erfordert, um sie zu nutzen
  • Behebung: Mobile-First beginnen, auf echten Geräten testen, mindestens 44px Touch-Ziele sicherstellen

Niedrig-Kontrast-Barrierefreiheitsfehler

  • Symptome: Hellgrauer Text (#999) auf Weiß, schlechte Lesbarkeit bei Sonnenlicht, Benutzerbeschwerden über Textlesbarkeit
  • Erkennungsregel: Wenn irgendein Text beim Testen das WCAG 4,5:1 Kontrastverhältnis nicht erfüllt
  • Behebung: Kontrastprüfwerkzeuge verwenden, bei hellen Lichtverhältnissen testen, Option für hohen Kontrast bereitstellen

Zusammenbruch der Informationsarchitektur

  • Symptome: Benutzer finden primäre Inhalte nicht, Navigation entspricht nicht mentalen Modellen, hohe Absprungraten
  • Erkennungsregel: Wenn Benutzer die primäre Aufgabe nicht innerhalb von 3 Klicks oder 30 Sekunden erledigen können
  • Behebung: User Journey Mapping, Kartensortierung für Navigation, Prominenz für Schlüsselaktionen

Arbeitende Beispiele

Beispiel 1: SaaS-Dashboard Redesign

Kontext: B2B-Analyseplattform, Benutzer verbringen täglich 2+ Stunden in der Oberfläche

Entscheidungsprozess:

  1. Zielgruppenanalyse: Power-User, die Effizienz über Ästhetik schätzen
  2. Layout-Wahl: Sidebar-Navigation (immer zugänglich) + Hauptinhaltsbereich
  3. Farbstrategie: Blau als Primärfarbe (#2563eb) für Vertrauen, minimale Akzente zur Reduzierung der kognitiven Belastung
  4. Hierarchie: Datentabellen erhalten den meisten Platz, Aktionen sind sekundär, aber zugänglich

Wichtige Designentscheidungen:

  • Dichte Informationsanzeige (8px Abstandsskala)
  • Hoher Kontrast Text (#1f2937 auf #ffffff)
  • Konsistente Button-Größe (40px Höhe für einfaches Klicken)
  • Statusindikatoren verwenden semantische Farben (grün = gut, rot = Alarm)

Ergebnisvalidierung:

  • Aufgabenerledigung um 23% verbessert
  • Benutzerberichtete "Benutzerfreundlichkeit" erhöht
  • Support-Tickets zur Navigation um 40% gesunken

Beispiel 2: E-Commerce-Produktseite

Kontext: Modehändler, Mobile-First-Zielgruppe (70% mobilen Traffic)

Entscheidungsprozess:

  1. Traffic-Muster: Mobile Browser, schnelle Entscheider
  2. Layout-Wahl: Einspaltig mobil, zweispaltig Desktop
  3. Visuelle Priorität: Produktbilder > Preis > Bewertungen > Spezifikationen
  4. Conversion-Elemente: In den Warenkorb-Button klebrig auf Mobil, prominent aber nicht aufdringlich

Wichtige Designentscheidungen:

  • Hero-Produktbild füllt die Bildschirmbreite auf Mobil
  • Preis in großer, fetter Typografie sofort sichtbar
  • Zusammenfassung der Bewertungen über den Produktdetails
  • Größen-/Farbwähler mit sofortigem visuellem Feedback

Anfänger- vs. Experten-Ansatz:

  • Anfänger würde: Alle Produktinformationen oberhalb der Falte platzieren, kleine Produktbilder verwenden
  • Experte erkennt: Benutzer benötigen große Bilder zur Bewertung von Mode, preisbewusste Zielgruppe benötigt frühe Bewertungsvalidierung

Messbare Ergebnisse:

  • Mobile Conversion-Rate um 31% gesteigert
  • Durchschnittliche Sitzungsdauer erhöht (Benutzer erkunden mehr Produkte)
  • Warenkorbabbruch um 18% gesunken

Qualitätstore

  • Primäre Benutzeraktion ist innerhalb von 3 Sekunden nach Seitenaufruf visuell offensichtlich
  • Alle Texte erfüllen die WCAG-AA-Kontrastanforderungen (mindestens 4,5:1)
  • Mobiles Layout funktioniert auf 320px Breite ohne horizontales Scrollen
  • Touch-Ziele sind mindestens 44px für interaktive Elemente
  • Markenfarben werden konsistent verwendet (gleiche Hex-Werte über Komponenten hinweg)
  • Visuelle Hierarchie verwendet maximal 3 Schriftstärken und 4 Größen
  • Seite lädt und ist innerhalb von 3 Sekunden auf 3G-Verbindung interaktiv
  • Navigation entspricht dem mentalen Modell des Benutzers (bestätigt durch Aufgabenerledigungsrate >80%)
  • Design funktioniert sowohl in hellen als auch in dunklen Systemeinstellungen
  • Komponenten haben Hover-, Fokus- und Aktivzustände definiert

Validieren eines Designplans

Geben Sie die Einhaltung der Qualitätstore des Designs als strukturierten Plan an (siehe schemas/design-plan.schema.json) und überprüfen Sie ihn deterministisch anstatt nur einen Mockup zu begutachten:

node scripts/design_audit.mjs --input plan.json

Der Prüfer gibt { pass, score, findings, recommendations } zurück und markiert die fünf oben genannten Fehlermodi namentlich: design-by-committee (zu viele Button-Stile/Schriftstärken/Größen), decoration-over-function, mobile-afterthought (320px horizontales Scrollen oder Sub-44px-Touch-Ziele), low-contrast (unter 4,5:1) und information-architecture collapse (Navigation, die nicht dem mentalen Modell des Benutzers entspricht). Siehe examples/expected-output.md für einen erfolgreichen und einen fehlschlagenden Durchlauf nebeneinander.

Referenzen

DateiLaden, wenn
references/layout-systems.mdDas Raster-Entscheidungsbaum, die 8px-Abstandsskala, responsive Breakpoints oder die Mobile-First-/Konsistenz-Checklisten benötigt werden.
references/color-accessibility.mdDie minimale Palette, Farbpsychologie-Tabelle, Dark-Mode-Anleitung oder die WCAG 2.1 AA-Checkliste benötigt werden.
references/tooling-integration.md21st.dev- oder Figma-MCP-Werkzeuge verwendet werden müssen, um von der Designrichtung zum Code zu gelangen.
templates/output-template.mdEine wiederverwendbare Designplan-Vorlage benötigt wird, die vor der Prüfung ausgefüllt werden muss.
examples/expected-output.mdDie Form eines fertigen Designplan-Audits benötigt wird, sowohl bestanden als auch nicht bestanden.
schemas/design-plan.schema.jsonDie Struktur eines Designplans programmatisch validiert werden muss.
scripts/design_audit.mjsDeterministische Bewertung eines Designplans gegen die Qualitätstore und benannten Fehlermodi benötigt wird.
agents/openai.yamlEin Subagenten-Deskriptor für delegierte Designplan-Erstellung benötigt wird.

NICHT-FÜR-Grenzen

Verwenden Sie dieses Skill NICHT für:

  • Tiefe Typografie-Entscheidungen (Zeilenhöhenberechnungen, Zeichenabstand) → verwenden Sie typography-expert
  • Farbmathematik oder Palettenerstellung → verwenden Sie color-theory-palette-harmony-expert
  • Designsystem-Token-Architektur oder CSS-Variablen → verwenden Sie design-system-creator
  • Retro- oder historische Designstile → verwenden Sie windows-3-1-web-designer
  • Native Mobile-App-Oberflächendesign → delegieren Sie an native-app-designer
  • Detaillierte Barrierefreiheitsprüfungen → verwenden Sie accessibility-expert
  • Animationen und Mikrointeraktionsspezifikationen → verwenden Sie motion-design-expert

Grenzindikatoren:

  • Wenn der Benutzer nach spezifischen Schriftpaar-Empfehlungen fragt → typography-expert
  • Wenn der Benutzer HSL-Farbberechnungen benötigt → color-theory-expert
  • Wenn der Benutzer CSS-Architekturberatung wünscht → design-system-creator
  • Wenn der Benutzer eine WCAG-Compliance-Checkliste benötigt → accessibility-expert

Layout-QA-Prüfpunkt (mechanisch – vor Versand ausführen)

Bevor Sie eine gerenderte Seite, ein Artefakt, Dashboard, Deck oder Komponente für fertig erklären, führen Sie den mechanischen Überlauf-/Kollisionsprüfer aus. Er rendert die Seite headless und markiert Text-gegen-Text-Kollisionen, abgeschnittene/ellipsis-gekürzte Elemente, Text, der aus seinem Behälter tritt, und horizontales Seiten-Scrollen – die visuellen Mängel, die ein Screenshot verbirgt und die nur bei einer bestimmten Breite oder in einem Theme auftreten.

Lösen Sie layout-overflow-guard aus dem aktiven Skill-Katalog auf, bevor Sie ihn ausführen. Der Befehl unten zeigt den Standard-Claude-Installationspfad; verwenden Sie den Pfad, der von Ihrer Umgebung gemeldet wird. Wenn das Skill fehlt, installieren oder synchronisieren Sie es, anstatt dieses Tor zu überspringen.

python3 ~/.claude/skills/layout-overflow-guard/scripts/check_layout.py <datei-oder-url> \
  --widths 1280,1100,860,720,390 --themes light,dark

Sie müssen nicht check_layout.py lesen – rufen Sie es mit dem Bash-Werkzeug auf und handeln Sie basierend auf seinem Bericht und Exit-Code (ungleich null = ein Fehler). Die Quelle des Skripts gelangt nie in Ihren Kontext; nur seine Ergebnisse. Bringen Sie es auf null Verstöße über jede Breite und beide Themes, bevor Sie ausliefern. Vollständige Details: das layout-overflow-guard-Skill.

Skill-Bundle-Index

Jede Datei in diesem Skill und wann sie zu öffnen ist. Automatisch generiert; führen Sie scripts/index_references.py --fix aus.

root

  • CHANGELOG.md — Changelog — Alle bemerkenswerten Änderungen am web-design-expert-Skill werden in dieser Datei dokumentiert.
  • README.md — Webdesign-Experte — Erstellt einzigartige visuelle Web-Systeme: Markenidentität, Farbpaletten, Layout-Komposition und responsive UI-Muster für Webanwendungen.

agents/

examples/

  • examples/expected-output.md — Beispielausgabe: Web-Designplan-Audit — Szenario: Ein SaaS-Marketing-Seiten-Redesign wurde als strukturierter Designplan spezifiziert (entspricht schemas/design-plan.schema.json) und ist
  • examples/sample-input.json — Beispiel-Eingabe (data/schema)

references/

schemas/

scripts/

templates/

  • templates/output-template.md — Web-Designplan-Vorlage — [Ein-Satz-Beschreibung des Produkts/der Seite, die dieser Designplan abdeckt.] Feldnotizen: - primaryActionObviousWithin3s — wahr nur, wenn ein frischer

Individual skills in this repo

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

Verwandte Skills