Communitygithub.com

ulasalyesil/personal-website-v2

Prüft die bestehende Oberfläche auf Konsistenz mit tieferen Entscheidungsebenen und erstellt ein Inventar der Oberflächenentscheidungen – Vokabular, Objektkonsistenz, Vollständigkeit, Feedback, Hierarchie, Zugänglichkeit.

Was ist personal-website-v2?

Dieses Skill dient der systematischen Überprüfung und Gestaltung der Oberflächenschicht (Surface Layer) eines Produkts oder Features. Es setzt voraus, dass das Frameworks `/layers-intro` geladen wurde. Die Oberfläche ist die Schicht, mit der Benutzer interagieren – Worte, visuelle Elemente, Töne, haptische Rückmeldungen. Das Skill unterscheidet zwischen Problemen, die direkt an der Oberfläche behoben werden können, und solchen, die tiefere Schichten (z. B. konzeptionelles Modell, Breadboard) betreffen. Der strukturierte Leitfaden umfasst einen Auditteil (Phasen 1–5), der die bestehende Oberfläche gegen das konzeptionelle Modell, das Breadboard und die Job Stories prüft, sowie einen Entscheidungsinventarteil (Phasen 6–10), der alle offenen Oberflächenentscheidungen katalogisiert. Es ist geeignet für Produktdesigner:innen und Entwickler:innen, die mit Tools wie Claude Code, Cursor oder Codex arbeiten, um sicherzustellen, dass visuelle und interaktive Oberflächen mit den darunter getroffenen Systementscheidungen übereinstimmen. Das Skill bietet klare Prüfmethoden und Qualitätssignale, um Konsistenz, Vollständigkeit und Zugänglichkeit zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-surface

In Ihrer bevorzugten KI fragen

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

Dokumentation

/layers-surface

Setzt voraus, dass /layers-intro für den Framework-Kontext geladen wurde.

Die Oberflächenschicht ist der Ort, an dem alle Entscheidungen der darunter liegenden Schichten zu etwas werden, das ein Mensch tatsächlich erlebt: Worte, Töne, Bilder, physische Handlungsmöglichkeiten, Bewegung, Feedback. Sie ist die medial spezifischste Schicht, aber die wichtigsten Entscheidungen zuerst sind universell – sie gelten unabhängig davon, ob es sich um einen Bildschirm, eine Sprachoberfläche, ein physisches Gerät oder einen Service-Touchpoint handelt.

Oberflächenverstöße sind oft Symptome tieferer Probleme. Dieses Skill unterscheidet zwischen Problemen, die an der Oberfläche behoben werden können, und solchen, die eine Überarbeitung einer tieferen Schicht erfordern.

Entscheidungen, die diese Schicht treffen muss:

  • Ehrt die Oberfläche das Vokabular und die Objekte aus dem konzeptionellen Modell?
  • Ist jeder Affordance (Handlungsmöglichkeit) vom Breadboard vorhanden – und gibt es Oberflächeninhalte ohne dahinterstehendes Modell?
  • Vermittelt die Oberfläche die richtige emotionale Register für die Aufgaben (Jobs) der Benutzer?
  • Wie erfährt der Benutzer, was passiert ist, was gerade läuft und was schiefgelaufen ist?
  • Was ist am prominentesten, und sollte es das sein?
  • Ist jede Information für die Benutzer zugänglich, die sie benötigen?

Methoden:

MethodeWann
Direkt im echten Medium arbeiten (Code, produktive UI)Wenn Sie echtes Feedback zu echten Interaktionen benötigen. Vermeidet die Lücke zwischen dem Aussehen in einem Mockup und dem Verhalten in der Benutzung.
Hochauflösende Mockups (Figma, etc.)Layout, visuelle Hierarchie und visuelle Form erkunden – besonders für neuartige Muster oder Stakeholder-Abstimmung.
Designsystem / KomponentenbibliothekWenn das Produkt etablierte Komponenten und Tokens hat. Oberflächenentscheidungen müssen das System erweitern, nicht widersprechen.
Style TilesVisuelle Sprache früh etablieren, ohne sich auf ein Layout festzulegen. Schneller als Hi-Fi für anfängliche Tonabstimmung.
PrototypenInteraktionsverhalten testen – Übergänge, Feedback-Zeitpunkte, Abläufe – die statische Mockups nicht vermitteln können.
Copy-firstWenn Sprache das primäre Designmaterial ist – Nachrichten, Onboarding, Fehlerzustände. Schreiben Sie den Text, bevor Sie den Container gestalten.

Qualitätssignale – wie gute Oberflächenentscheidungen aussehen:

  • Jeder Begriff stimmt mit der ubiquitären Sprache des konzeptionellen Modells überein
  • Jedes Objekt hat eine konsistente Darstellung in allen Kontexten – kein Formwandler, keine Maskierung
  • Jeder Affordance vom Breadboard ist vorhanden; jedes Oberflächenelement hat ein dahinterstehendes Modell
  • Emotionales Register stimmt mit den emotionalen und sozialen Aufgaben (Jobs) aus den Benutzerbedürfnissen überein
  • Fehlermeldungen tun drei Dinge: diagnostizieren (was passiert ist), erklären (warum), beheben (was als nächstes zu tun ist). „Etwas ist schiefgelaufen“ scheitert an allen drei.
  • Prominenz spiegelt Wichtigkeit wider – das, was der Ablauf den Benutzer bemerken lassen muss, sticht hervor
  • Zugänglichkeitsentscheidungen werden explizit getroffen, nicht als Standard belassen

Geführte Sitzung

Dieses Skill besteht aus zwei Teilen. Sagen Sie mir, was Sie brauchen:

  • Audit – bestehende Oberflächenarbeit gegen Entscheidungen tieferer Schichten prüfen (Phasen 1–5)
  • Entscheidungsinventar – offene Oberflächenentscheidungen durcharbeiten (Phasen 6–10)

Beschreiben Sie, was Sie haben, oder sagen Sie „Leiten Sie mich“, um zu beginnen.

Fragen Sie: „Wo soll ich die Ergebnisse dieser Sitzung festhalten?“ (siehe /layers-intro für Optionen)

Fragen:

  1. An welchem Produkt oder Feature arbeiten wir?
  2. Welches Medium – Bildschirm-UI, Sprach-/Conversational-UI, physisch, Service-Touchpoints?
  3. Was haben Sie aus den darunter liegenden Schichten? Konzeptionelles Modell (Objekte + ubiquitäre Sprache)? Breadboard oder Ablauf? Job Stories einschließlich emotionaler/sozialer Jobs?

Teil 1 – Audit

Phase 1 – Die Oberfläche einordnen

Gibt es bereits Oberflächenarbeit – funktionierender Code, bereitgestellte UI, Copy, visuelle Designs? Oder ist die Oberfläche noch nicht begonnen? Wenn noch nicht begonnen, fahren Sie mit Teil 2 fort.

Phase 2 – Vokabular und Sprache

Nehmen Sie die Liste der ubiquitären Sprache aus dem konzeptionellen Modell. Bitten Sie die Designer:in, die Oberflächen-Copy zu teilen – Labels, Überschriften, Button-Texte, Fehlermeldungen, Benachrichtigungen, Hilfetexte.

Prüfen Sie jeden Begriff. Kennzeichnen Sie:

  • Direkte Verstöße – ein Modellbegriff wird inkorrekt oder inkonsistent verwendet („Konto“ an einer Stelle, „Arbeitsbereich“ an einer anderen)
  • Nicht gelistete Begriffe – Wörter auf der Oberfläche, die nicht in der ubiquitären Sprache vorkommen. Neue Begriffe für das Modell, oder Oberflächenrauschen?
  • Tonabweichungen – technisch korrekt, aber tonal falsch für die emotionalen/sozialen Jobs

Für jeden Verstoß: Oberflächenkorrektur (Copy umschreiben) oder tiefere Korrektur (Vokabular des konzeptionellen Modells aktualisieren)?

Phase 3 – Objektkonsistenz

Für jedes Objekt im konzeptionellen Modell: Wo erscheint es auf der Oberfläche? In wie vielen Formen?

  • Formwandler (Shapeshifters) – dasselbe Objekt in deutlich unterschiedlichen visuellen oder strukturellen Formen in verschiedenen Kontexten
  • Maskierte Objekte (Masked Objects) – das Objekt erscheint in einer Form, in der ein Benutzer es nicht als diesen Objekttyp erkennen würde

Für jedes: Ist dies eine Oberflächenentscheidung (konsistente Behandlung etablieren) oder ein Problem des konzeptionellen Modells (die Identität des Objekts ist selbst im Modell unklar)?

Phase 4 – Vollständigkeitsprüfung

Nehmen Sie das Breadboard. Überprüfen Sie für jeden Ort und jeden Affordance:

  • Ist jeder Affordance vom Breadboard auf der Oberfläche vorhanden?
  • Gibt es Oberflächeninhalte ohne entsprechendes Breadboard-Element?

Ergänzungen, die nicht im Breadboard waren, sind oft Interaktionsschicht-Entscheidungen, die durchgerutscht sind – kennzeichnen Sie sie und empfehlen Sie, /layers-interaction-flow erneut aufzurufen.

Phase 5 – Emotionales Register

Kehren Sie zu den Job Stories zurück, insbesondere zu emotionalen und sozialen Jobs.

„Welchen emotionalen Job erledigt der Benutzer hier – nicht nur die funktionale Aufgabe, sondern wie er sich fühlen möchte?“ „Welcher soziale Job ist im Spiel – wie möchte er wahrgenommen werden?“

Häufige Fehlausrichtungen:

  • Die Oberfläche betont den Nutzen des Produkts („wir erhalten eine Empfehlung“) über den Job des Benutzers („ich helfe einem Kollegen“)
  • Copy stellt eine Interaktion transaktional dar, während der Job des Benutzers relational ist
  • Der Ton wirkt fachlich/klinisch, während der Benutzer sich beruhigt oder selbstbewusst fühlen muss

Teil 2 – Entscheidungsinventar

Phase 6 – Feedback und Fehler

Für jede signifikante Aktion und Zustandsänderung:

  • „Wie erfährt der Benutzer, dass seine Aktion funktioniert hat?“
  • „Wie erfährt der Benutzer, dass etwas ausgeführt wird?“
  • „Wie erfährt der Benutzer, dass etwas schiefgelaufen ist, und was er dagegen tun kann?“

Fehlermeldungen müssen diagnostizieren, erklären und dem Benutzer sagen, was als nächstes zu tun ist. Kennzeichnen Sie jeden Fehlerzustand, der nicht alle drei Kriterien erfüllt. Erstellen Sie für jede Lücke eine Entscheidung: „Wir müssen entscheiden, wie wir [X] dem Benutzer mitteilen. Die Optionen sind [Y].“

Phase 7 – Hierarchie und Hervorhebung

Für jeden wichtigen Ort:

  • „Was ist das Wichtigste, das ein Benutzer hier bemerken oder worauf er reagieren muss?“
  • „Macht die aktuelle Oberfläche diese Sache am prominentesten?“
  • „Gibt es etwas visuell Hervorgehobenes, das nicht hervorgehoben sein sollte?“

Dies sind zuerst mediumunabhängige Entscheidungen (was primär sein sollte), bevor sie mediumspezifisch werden (wie es visuell, akustisch oder haptisch primär gemacht wird).

Phase 8 – Zugänglichkeit

Kennzeichnen Sie relevante Überlegungen für das erklärte Medium:

  • Bildschirm-UI: Farbkontrast, Textgröße, Touch-Ziele, Tastaturnavigation, Screenreader-Labels für interaktive Elemente und Bilder, Fokusverwaltung über Ablaufschritte hinweg
  • Sprache/Conversational: Alle Informationen verbal vermitteln (kein „Klicken Sie auf den Button links“), Fehlerbehebung ohne visuellen Kontext
  • Physisch: Erreichbarkeit, taktile Unterscheidbarkeit, Sichtbarkeit bei unterschiedlichem Licht, Bedienung ohne feinmotorische Präzision

Erstellen Sie eine Liste von Zugänglichkeitsentscheidungen: „Wir müssen entscheiden, wie [X] für Benutzer zugänglich sein wird, die [Y].“

Phase 9 – Konsistenz

  • Werden ähnliche Dinge ähnlich behandelt? (Gleiche Aktionen sehen und verhalten sich gleich; gleiche Objekttypen werden konsistent dargestellt)
  • Werden unterschiedliche Dinge unterschiedlich behandelt? (Primär vs. Sekundär, destruktiv vs. sicher)
  • Entspricht diese Oberfläche den Konventionen ihres Mediums? Gegen Plattformnormen zu verstoßen, ist eine Entscheidung mit Kosten – manchmal lohnenswert, immer beabsichtigt.

Unterscheiden Sie: Interne Inkonsistenzen (innerhalb der Oberfläche beheben) vs. Konventionsverstöße (bewusste Entscheidung oder Versehen – entscheiden Sie, welches).

Phase 10 – Offene Entscheidungen

Erstellen Sie eine konsolidierte Liste aller noch zu treffenden Oberflächenentscheidungen:

  • Zuerst zu lösende schichtübergreifende Probleme – Ursache liegt in einer tieferen Schicht; separat aufgeführt; erfordern erneute Durcharbeitung des relevanten Skills, bevor die Oberfläche korrigiert werden kann
  • Jetzt zu treffende Oberflächenentscheidungen – Was ist die Entscheidung? Welche Optionen gibt es? Welche Einschränkungen gelten (aus tieferen Schichten, dem Medium, der Marke/Konsistenz)?
  • Zurückgestellt – müssen jetzt nicht getroffen werden, sollten aber nachverfolgt werden

Abschluss

Erstellen Sie:

  1. Audit-Ergebnisse – Vokabularverstöße, maskierte/formwandelnde Objekte, Vollständigkeitslücken, Abweichungen im emotionalen Register – jeweils kategorisiert als Oberflächenkorrektur oder Problem tieferer Schichten
  2. Entscheidungsinventar – alle offenen Oberflächenentscheidungen, gruppiert und priorisiert
  3. Schichtübergreifende Probleme – Dinge, die auf einer tieferen Schicht gelöst werden müssen, bevor die Oberfläche korrigiert werden kann
  4. Was bereits funktioniert – Oberflächenentscheidungen, die bereits gut getroffen wurden; diese bei der Überarbeitung nicht verlieren

Beenden Sie mit: „Die Oberfläche ist die Schicht, die Benutzer erleben. Alles, was darunter entschieden wurde, wird hier entweder geehrt oder untergraben. Kehren Sie zu diesem Skill zurück, nachdem das konzeptionelle Modell oder die Interaktionsstruktur wesentlich geändert wurde.“

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

Verwandte Skills