CommunityCodierung & Entwicklunggithub.com

cbrock84/interface-craft

Hebt die visuelle und interaktive Qualität einer Benutzeroberfläche an – Layout, Hierarchie, Typografie, Abstände, Dichte und die Details, die ein durchdachtes Produkt von einem generischen unterscheiden.

Was ist interface-craft?

Diese Fähigkeit (Skill) für KI-Agenten verbessert die handwerkliche Qualität von Benutzeroberflächen, indem sie sich auf konkrete, umsetzbare Prinzipien konzentriert. Sie ist nützlich, wenn ein Bildschirm funktioniert, aber unfertig oder generisch wirkt, wenn das Layout überladen oder willkürlich erscheint, wenn eine Seite keinen klaren visuellen Fokus hat oder wenn die Benutzeroberfläche vertrauenswürdig und nicht nur funktional wirken soll. Der Skill leitet den Agenten an, zuerst zu diagnostizieren (primäre Aktion identifizieren), bevor Änderungen vorgenommen werden. Er betont Schlüsselelemente wie Hierarchie (durch Größe, Gewicht und Abstand), Abstands-Rhythmus, Typografie, Zurückhaltung bei Oberflächen (Borders, Schatten, Füllungen), Ausrichtung und Dichte (informationsdicht vs. Marketing-Seite). Ein weiterer Schwerpunkt liegt auf der korrekten Implementierung von Zuständen (Laden, leer, Fehler, Überlauf), Dark Mode (als eigene Palette, nicht als Inversion) und einer grundlegenden Zugänglichkeit (Barrierefreiheit) für alle Benutzer. Der Skill ist plattformunabhängig und kann mit jedem KI-Agenten verwendet werden, der SKILL.md unterstützt (z. B. Claude Code, Cursor, Codex). Er arbeitet, indem er dem Agenten klare, regelbasierte Anweisungen und „Don'ts“ (z. B. kein zentrierter Fließtext, kein visuelles Gewicht ohne Fokus-Zustand) an die Hand gibt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-craft

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Interface-Handwerk

Die meisten Benutzeroberflächen scheitern nicht an den Ideen. Sie scheitern an der Umsetzung – an Abständen, die fast konsistent sind, an einer Hierarchie, die fast klar ist, an einer Schrift, die fast richtig ist.

Diagnose vor dem Neugestalten

Frage, wofür der Bildschirm da ist. Eine primäre Aktion, höchstens eine sekundäre. Wenn du die primäre Aktion nicht benennen kannst, ist das Layout-Problem ein Produktproblem, und keine noch so große Gestaltung behebt es.

Die Dinge, die tatsächlich als Qualität wahrgenommen werden

Hierarchie. Der Betrachter sollte wissen, wohin er schauen muss, bevor er etwas liest. Erreiche dies mit Größe, Gewicht und Abstand – in dieser Reihenfolge. Farbe ist das schwächste Hierarchie-Werkzeug und das am meisten überstrapazierte.

Abstands-Rhythmus. Zusammengehörige Dinge sitzen näher beieinander als nicht zusammengehörige, und die Abstände stammen aus einer einzigen Skala. Inkonsistente Abstände sind der Makel, den Menschen fühlen, aber nicht benennen können. Wenn der räumliche Bezug stimmt, liest sich ein schlichtes Layout als gestaltet.

Typografie. Eine Schriftfamilie für die Oberfläche, höchstens zwei auf der Seite. Lege eine echte Skala fest und verwende ihre Schritte, anstatt Größen zu erfinden. Fließtext möchte eine komfortable Breite – etwa 60–75 Zeichen – und eine Zeilenhöhe, die mit der Breite wächst.

Zurückhaltung bei Oberflächen. Rahmen, Schatten und Füllungen trennen alles voneinander. Wähle eines pro Grenze. Alle drei zu stapeln ist der Grund, warum Oberflächen bei normaler Dichte überladen wirken.

Ausrichtung. Alles fluchtet mit etwas. Ein Element, das an nichts ausgerichtet ist, wirkt selbst dann wie ein Fehler, wenn es beabsichtigt ist.

Dichte ist eine Entscheidung

Ein informationsdichtes Werkzeug und eine Marketing-Seite wollen gegensätzliche Behandlungen. Entscheide, um welches es sich handelt, und bleibe dabei – die unangenehme Mitte, in der eine Datentabelle das Padding einer Landingpage hat, dient keiner Seite.

Zustände fertigstellen

Laden, leer, Fehler und Überlauf sind die Momente, in denen sich Produkte unfertig anfühlen. Ein leerer Zustand ist eine Gestaltungsmöglichkeit; ein Spinner ohne Kontext ist ein Eingeständnis. Lange Zeichenketten, lange Listen und kleine Bildschirme müssen behandelt, nicht erhofft werden.

Dark Mode ist eine Palette, keine Invertierung

Die Invertierung eines hellen Designs erzeugt den charakteristischen schlechten Dark Mode: reines Schwarz als Hintergrund, reines Weiß als Text und Schatten, die nichts bewirken.

  • Verwende ein sehr dunkles Grau anstelle von reinem Schwarz und ein leicht abgedunkeltes Weiß anstelle von reinem Weiß. Maximaler Kontrast zwischen beiden verursacht Halos und ist tatsächlich ermüdend zu lesen.
  • Die Erhebung kehrt sich um: In hellen Themen werfen erhöhte Flächen Schlagschatten, in dunklen Themen werden sie heller. Schatten allein vermittelt auf einem dunklen Untergrund nichts.
  • Gesättigte Farben, die auf Weiß funktionierten, vibrieren auf Dunkel. Entsättige und helle Akzentfarben für die dunkle Palette auf, anstatt sie wiederzuverwenden.
  • Definiere beide Paletten gemeinsam, auf Token-Ebene, von Anfang an. Ein nachträgliches Einführen bedeutet, jede Oberfläche zu prüfen.

Grundlegende Barrierefreiheit

Dies sind keine Kosmetik-Items – unterhalb dieser Grenze können manche Menschen die Oberfläche überhaupt nicht nutzen.

  • Textkontrast, der das Standardverhältnis gegenüber seinem tatsächlichen Hintergrund einhält, einschließlich Text über Bildern und in farbigen Schaltflächen.
  • Niemals Bedeutung allein durch Farbe transportieren. Ein roter Rand, der auf einen Fehler hinweist, benötigt ebenfalls Text oder ein Symbol.
  • Jedes interaktive Element ist per Tastatur erreichbar, in einer sinnvollen Reihenfolge, mit einem sichtbaren Fokus-Zustand.
  • Berührungsziele groß genug, um zuverlässig getroffen zu werden, mit Abstand zwischen benachbarten Zielen.
  • Die Einstellung „reduced-motion“ respektieren: Animation, die nicht deaktiviert werden kann, verursacht bei manchen Nutzern echte Symptome.
  • Echte semantische Elemente – Schaltflächen, die Schaltflächen sind, Überschriften in der richtigen Reihenfolge. Ein gestylter div ist für assistierende Technologien unsichtbar.

Niemals

  • Visuelles Gewicht hinzufügen, um ein Hierarchie-Problem zu beheben, das durch zu viele gleichwertige Elemente verursacht wird. Lieber entfernen.
  • Fließtext zentrieren.
  • Einen Hover-Zustand ausliefern ohne den passenden Fokus-Zustand.

Individual skills in this repo

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

cbrock84/org-design

Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. Use this to structure a new team, restructure an existing one, resolve unclear ownership between teams, plan headcount, or diagnose why a team underperforms for structural rather than individual reasons.

cbrock84/portfolio-governance

Governs the portfolio of work — intake, prioritization, stage gates, resource contention, and stopping things. Use this to set up intake and prioritization, run a stage gate, decide between competing initiatives, resolve resource contention across projects, or work out why everything is in flight and nothing is finishing.

cbrock84/product-launch

Takes something built and gets it into the market — tiering the launch to match what it actually warrants, sequencing internal readiness before external announcement, preparing sales and support to answer the questions it creates, choosing the date for a reason, and measuring adoption rather than announcement reach. Use this to plan a launch, right-size one that is consuming more than it deserves, work out why a released feature nobody uses was launched loudly, or run the weeks after launch day.

cbrock84/program-management

Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. Use this to run a multi-team initiative, recover a program that is slipping, build a delivery plan with dependencies, structure status reporting, or diagnose why cross-team work keeps missing dates.

cbrock84/project-delivery

Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. Use this to plan a project, build or challenge a schedule, estimate credibly, track progress meaningfully, or recover a project that is late.

cbrock84/retention

Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. Use this when churn is rising or unexplained, to design a cancellation or win-back flow, to recover involuntary churn, to identify at-risk accounts before they leave, or to decide whether a retention problem is a product problem.

cbrock84/sales-enablement

Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. Use this to create or fix sales collateral, prepare for a competitive deal, build a demo flow, document objection responses, or diagnose why a pitch is not converting.

cbrock84/tax

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

cbrock84/unit-economics

Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavior underneath. Use this to assess whether growth is profitable, evaluate a channel or segment, support a pricing decision, judge how fast the business can afford to grow, or diagnose why revenue growth is not producing profit.

cbrock84/video-content

Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. Use this to script a video, plan a series, fix retention or click-through problems, design thumbnail and title concepts, or turn written content into video. For a YouTube channel specifically — idea selection, retention teardowns, and channel-level strategy — use `youtube-producer`.

cbrock84/visual-content

Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts where they are AI-produced. Use this to turn a written piece into a visual format, design a carousel or infographic, create social graphics, or fix visuals that are not stopping the scroll.

Verwandte Skills