Communitygithub.com

fresh-eyes

Erstellt und prüft UI-Bildschirme für Webprodukte (App-Screens, Dashboards, Einstellungen, Tabellen, Formulare, Onboarding, leere und Fehlerzustände sowie Landing-, Home- und Preisseiten), die wirken, als kämen sie von einem durchdachten Menschen – nicht von einer Vorlage. Jeder Bildschirm wird aus der Aufgabe des Benutzers und echten Inhalten aufgebaut, durch Rendering und ein neues Augenpaar geprüft, nach WCAG 2.2 AA gemessen und frei von maschinellen Erkennungszeichen gehalten.

Was ist fresh-eyes?

**fresh-eyes** ist eine KI-Agenten-Fertigkeit, die für den Bau und die Überprüfung von UI-Bildschirmen für Webanwendungen und SaaS-Produkte entwickelt wurde. Sie folgt einem strukturierten, siebenschrittigen Prozess: vom Verstehen der Benutzeraufgabe über das Schreiben des Textinhalts vor dem Styling bis hin zum Bauen mit echten Komponenten und der Prüfung durch gerenderte Screenshots. Ein zentrales Element ist „Fresh eyes“ – ein unabhängiger Unteragent, der den Bildschirm ohne Vorkenntnisse bewertet, um intuitive Verständlichkeit zu gewährleisten. Die Fertigkeit unterstützt Plattformen wie Claude Code, Cursor und Codex und verwendet Node.js-Skripte mit Playwright für automatisierte Prüfungen (Kontrast, Fokus, Seitenlauf etc.). Sie stellt strenge Regeln auf: ausschließlich echte Inhalte, Barrierefreiheit nach WCAG 2.2 AA, keine maschinellen Erkennungszeichen wie Farbstreifen oder Gedankenstriche. Das Ergebnis ist ein professionell gestalteter, funktionaler und zugänglicher Bildschirm, der dem Benutzer seine Aufgabe erleichtert.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bernardoo-soares/fresh-eyes/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Fresh eyes

Gestalte den Bildschirm für die Person, die ihn nutzen wird, ausgehend von der Aufgabe, die sie erledigen möchte, und den Inhalten, die sie sehen wird. Das Urteilsvermögen führt; die Referenzen schärfen es und die Skripte prüfen es. Nichts hier steht über dem gesunden Menschenverstand: Wenn ein Bildschirm verwirrend ist und keine Regel den Grund benennt, ist er trotzdem verwirrend.

<skill> unten ist das Verzeichnis dieser Fertigkeit: ${CLAUDE_SKILL_DIR} (wenn dies als wörtliche Variable angezeigt wird, verwende den Ordner, aus dem diese Datei gelesen wurde).

Einrichtung

Die Skripte benötigen Node 20 oder höher. Wenn ein Skript angibt, dass eine Einrichtung erforderlich ist, führe das aus, was es ausgibt: eines oder beide von npm --prefix "<skill>" install und node "<skill>/node_modules/playwright/cli.js" install chromium, die von jedem Ordner und in jeder Shell funktionieren.

Wenn die Skripte hier nicht ausgeführt werden können (keine Shell, kein Node, kein Netzwerk für den Browser-Download), brich nicht ab: Mache Screenshots mit dem Browser-Werkzeug, das die Sitzung bietet, oder prüfe den Code Zeile für Zeile gegen references/floor.md und gib im Bericht an, dass die Rendering-Prüfung nicht durchgeführt wurde. Melde niemals eine visuelle Prüfung, die nur anhand des Codes durchgeführt wurde.

Der Ablauf

Verwende ihn sowohl zum Erstellen als auch zum Prüfen. Für eine Prüfung lies zuerst references/review.md: Seine Schritte ersetzen die Schritte 1 bis 4, und die verbesserte Version befindet sich als Kopie neben dem Original, es sei denn, die Person hat darum gebeten, ihre Dateien zu ändern.

  1. Verstehen. Wer nutzt diesen Bildschirm, für welche Aufgabe, wie oft, auf welchem Gerät, mit welchen echten Inhalten. Lies die DESIGN-CONTEXT.md des Projekts, falls vorhanden (references/design-context.md). Falls nicht, leite sie aus dem Code, dem Text und der Anfrage ab und notiere deine Annahmen. Zögere nicht, zuerst den Benutzer zu befragen.
  2. Vor dem Styling entscheiden. Schreibe kurz in deinen Arbeitsnotizen oder der Antwort, bevor du baust: den einen Zweck dieses Bildschirms; worauf das Auge zuerst fallen soll; was der erste Bildschirm für die Hauptentscheidung enthalten muss, sowohl auf dem Desktop als auch auf dem Telefon; die Reihenfolge von allem anderen; die einzelne primäre Aktion; was du weglässt. Nenne zwei oder drei Produkte, die Nutzer dieser Kategorie bereits mögen, deren Strukturen du folgst, und den einen charakteristischen Zug, den dieses Produkt besitzt (references/modern.md). Dies ist deine Absicht, und Schritt 6 testet sie.
  3. Schreibe die Wörter zuerst. Überschriften, Bezeichnungen, Schaltflächen, leere Zustände und Fehlerzustände, in den Worten der Person, aus den echten Daten (references/words.md). Erfinde niemals Zahlen, Namen, Erfahrungsberichte oder Trends; wenn keine echten Daten vorliegen, verwende einen sichtbaren Platzhalter.
  4. Baue in der Reihenfolge: Struktur, dann Hierarchie, dann Handwerk, mit den eigenen Komponenten und Tokens des Projekts, wenn es sie hat (für React mit shadcn/ui lies references/stacks/react-shadcn.md). Ein neues visuelles System beginnt mit node "<skill>/scripts/tokens.mjs" --accent "<hex>" --out <dir>, das jedes Farbpaar prüft.
  5. Rendern und ansehen. Starte für eine App den Entwicklungsserver und übergib die URL. Schreibe --out in einen temporären Ordner außerhalb des Projekts: node "<skill>/scripts/render.mjs" <page.html | url> --out <dir> (wenn es nach Einrichtung fragt oder nicht ausgeführt werden kann, siehe Einrichtung); hinter einem Login füge --storage-state <file> hinzu. Es speichert Desktop- und Telefon-, Hell- und Dunkel-Screenshots, gibt die Probleme aus, die es messen kann (Kontrast, Fokus, seitlicher Bildlauf, kleine Ziele, konkurrierende primäre Schaltflächen, Randstreifen, Gedankenstriche), dann eine Liste „Durch Augenprüfung“. Behebe jedes Problem oder nenne im Bericht den Grund, warum eines bestehen bleibt; eine Prüfung behebt grundlegende Mängel, Streifen und Gedankenstriche und gibt die anderen gemessenen Anzeichen als Erkenntnisse weiter. Wenn es warnt, dass Hell und Dunkel identisch aussehen, führe es erneut mit --theme-mode class aus. Sieh dir die Screenshots an, zuerst die vier -first.png, und jedes Element der „Durch Augenprüfung“-Liste: Eine leere Liste bedeutet, dass der Grundstock sauber ist, nicht, dass der Bildschirm gut ist. Rendere einmal mit Stress-Inhalten: den längsten echten Namen, den größten Betrag, das leere Konto.
  6. Fresh eyes. Starte einen neuen Unteragenten, der keinen Teil dieses Gesprächs hat (kein Fork davon); verwende den Agententyp first-look, falls einer aufgeführt ist. Seine gesamte Eingabeaufforderung: Lies <skill>/agents/first-look.md und befolge es. Die Aufgabe: <ein Satz>. Bilder: <absolute Pfade, zuerst die des ersten Bildschirms>. Öffne keine andere Datei. Füge nichts über deine Absicht oder das, was du gebaut oder geändert hast, hinzu. Vergleiche seine Antworten mit Schritt 2: Ein falsches „Was ist das“, ein falscher erster Klick, ein Zögern oder ein „fühlt sich falsch an“ ist ein Fehler; bei einer Prüfung einer Seite, die bereits funktioniert, ist ein Zögern, das die Aufgabe weder blockiert noch in die Irre führt, ein optionaler Vorschlag, kein Fehler. Ohne Unteragenten, beantworte die Fragen des ersten Blicks selbstständig anhand der Bilder des ersten Bildschirms, bevor du deinen Code erneut liest.
  7. Beheben und aufhören. Behebe jedes Zögern zuerst mit Struktur (eine Bezeichnung, eine Liste, ein visuelles Element, eine Neugruppierung); füge einen Satz nur hinzu, wenn nichts anderes es vermitteln kann. Ein Zweifel an einem Namen wird durch einen besseren Namen behoben, niemals durch eine Erklärungszeile darunter, und nichts wird jemals innerhalb eines Menüs erklärt. Maximal zwei weitere Runden der Schritte 5 und 6, dann benenne, was noch offen ist. Beantworte die drei Fragen des Tests in references/modern.md (welches Kategorieprodukt würde dies als aktuell bezeichnen; wo der charakteristische Zug ist; könnte dies zu einem beliebigen Startup gehören) und berichte.

Der einfachste Weg zuerst. Die Hauptaktion funktioniert in dem Moment, in dem der Bildschirm geöffnet wird; zusätzliche Fähigkeiten (Bearbeiten jeder Zeile, Massenwerkzeuge) befinden sich eine Ebene tiefer, niemals im Weg des ersten Bildschirms (references/structure.md).

Fertig, nicht kahl. Das Vermeiden von Erkennungszeichen ist nicht das Ziel. Ein Bildschirm sollte wie ein fertiges Produkt aussehen: Einheiten, mit denen die Person in ihren eigenen Containern arbeitet, Symbole und kleine visuelle Elemente, wo sie eine Bedeutung tragen, die gesamte Entscheidung auf dem ersten Bildschirm. Eine breite Spalte mit grauen Sätzen ist ebenfalls ein Fehler (references/hierarchy.md).

Skaliere es auf die Anfrage. Nur Wörter (Bezeichnungen, eine Fehlermeldung): Schritte 1 bis 3. Eine Komponente oder eine kleine Korrektur: Schritte 1 bis 5. Ein ganzer Bildschirm oder eine Prüfung: alle sieben.

Die Fragen, die die meisten Bildschirme entscheiden

FrageLesen Sie
Wer kommt hierher, wie oft, für welche Aufgabe? Wie dicht sollte es sein (Haltung)? Wie werden Dinge gruppiert, benannt und erreicht?references/structure.md
Worauf sollte das Auge zuerst fallen? Gibt es genau eine primäre Aktion? Hat jede Zahl ihren Vergleich, ihre Einheit und ihr Datum?references/hierarchy.md
Kann ein Neuling erkennen, was dies ist, wo er ist und was er als nächstes tun soll?references/clarity.md
In welchem Zustand befindet sich jede Region, und ist es genau einer? Wenn jemand etwas falsch macht, rückgängig machen oder bestätigen?references/states.md
Benennen die Wörter die Dinge so, wie die Person es tut? Sagt jeder Fehler die Lösung?references/words.md
Sind Schriftart, Abstände, Farbe, Dunkelmodus und Bewegung bewusst gestaltet?references/craft.md
Sieht es fertig aus oder wie ein Dokument? Enthält der erste Bildschirm die Entscheidung?references/hierarchy.md
Sieht es aktuell aus, ohne generiert zu wirken? Was ist sein charakteristischer Zug?references/modern.md
Könnte dieser Bildschirm zu einem beliebigen Produkt gehören? Was kann ihn verlassen?references/tells.md
Ist es eine Landing-, Home- oder Preisseite? Was muss ein Besucher entscheiden?references/landing.md
Tastatur, Kontrast, Reflow, Namen, Ziele, in beiden Designs?references/floor.md

Lies eine Referenz, wenn ihre Frage auf dem Bildschirm vor dir offen ist, nicht alle auf einmal. Jede Karte in ihnen hat eine Entscheidung, ein Tun, das Warum mit seiner Quelle, worauf man Achten soll, und wann sie nicht zutrifft (Außer wenn). Die Ausnahmen sind genauso wichtig wie die Regeln.

Unveränderliche Linien

  • Nur echte Inhalte: Keine erfundenen Zahlen, Personen, Zitate oder Geschichten.
  • Die Barrierefreiheits-Basisschwelle (references/floor.md) gilt sowohl im Hellen als auch im Dunkeln.
  • Kein farbiger Streifen an einer Kante eines Elements als Akzent und keine Gedankenstriche im Text (references/tells.md).
  • Behalte bei einer Prüfung jedes Datenelement und jede Aktion, die die Seite hatte; verschiebe oder stufe herab, entferne nicht.
  • „Keine Änderung erforderlich“ ist eine vollständige Prüfung, wenn nichts die Person etwas kostet. Ändere niemals aus reinem Geschmack.

Bericht

Klar, kurz:

  • was du gebaut oder geändert hast, jeweils verknüpft mit der Aufgabe der Person und dem, was es ihr erspart; bei einer Prüfung jede Änderung, egal wie klein (eine Größe, ein Abstand, eine Farbe), zum Beispiel als kurze Tabelle mit „war“, „jetzt“ und „was es der Person erspart“: Eine Änderung, die du nicht nennst, ist ein gebrochenes Versprechen;
  • was du angenommen hast, höchstens drei Punkte, und was sich ändern würde, wenn eine Annahme falsch ist;
  • was du geprüft hast: die Rendering-Probleme vorher und nachher und wie der erste Blick mit deiner Absicht übereinstimmte;
  • was du nicht getestet hast (Gesten, ein echtes Telefon, Safari, ein Screenreader) und ob das Rendering durchgeführt wurde.

Keine Bewertungen, IDs oder Regelnummern. Wenn das Projekt keine DESIGN-CONTEXT.md hat, biete an, eine aus deinen Annahmen zu schreiben.

Verwandte Skills