ux-writingvon content-designer

UX Writing Skill.

Ein Claude Code- und Codex-Skill für UX-Research: nutzerzentrierte, barrierefreie Microcopy: Buttons, Labels, Fehler, Formulare, Onboarding.

UX & Research

OpenDesign herunterladen Anleitung ansehen

content-designer/ux-writing-skill · SKILL.mdSKILL.md

--- name: ux-writing description: Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and … --- ## When to Use This Skill ## Core UX Writing Principles ## UX Text Patterns ## Voice and Tone ## Editing Process ## Workflow

Front Matter und Abschnittsüberschriften aus der Upstream-Datei vom 14.09.2026 · 15.313 Zeichen insgesamt

01 Was es tut

Was der Skill ux-writing in Claude Code und Codex leistet

Zusammenfassung, Workflow und Ergebnisse — alles aus der SKILL.md des Skills ausgelesen.

Aus der SKILL.mdGelesen am 14.09.2026 · kein aufgezeichneter Durchlauf

In den eigenen Worten des Skills

Ein praxisnaher Leitfaden zum Schreiben und Überarbeiten von Microcopy in digitalen Produkten: Buttons, Labels, Titel, Fehlermeldungen, Benachrichtigungen, Formulare, Onboarding, Empty States, Erfolgsmeldungen und Hilfetexte. Jede Textzeile wird an vier Qualitätsstandards gemessen – zweckgerichtet, prägnant, konversationell und klar – und jeder Elementtyp folgt einem Muster, etwa [Verb] [Objekt] für Buttons und [Was ist fehlgeschlagen].

[Warum/Kontext]. [Was zu tun ist]. für Fehlermeldungen. Die Voice wird als feste Markenpersönlichkeit behandelt, während sich der Ton je nach frustrierten, verwirrten, zuversichtlichen, vorsichtigen und erfolgreichen Nutzern verändert. Der Skill ergänzt Barrierefreiheitsregeln, forschungsgestützte Richtwerte für Satz- und Zeichenlängen, einen vierphasigen Editierprozess sowie Referenzdateien für Voice-Charts, Content-Usability und Figma MCP.

Was er erzeugt

Die Interface-Texte selbst – über Buttons, Labels, Fehlermeldungen, Benachrichtigungen, Formulare und verwandte Elemente hinweg.
Ein Produkt-Voice-Chart, erstellt mit references/voice-chart-template.md, das Markenkonzepte auf Voice-Merkmale abbildet, inklusive Do/Don’t-Beispielen.
Fehlermeldungen, geschrieben nach templates/error-message-template.md, einer ausfüllbaren Vorlage für wirksame Fehlermeldungen.
Ein Onboarding-Flow, entworfen nach templates/onboarding-flow-template.md, dem Framework für klare Onboarding-Erlebnisse.

Siehe Beispiel-Prompt ↗

So funktioniert es

01
Beginnen Sie mit dem Kontext
Der erste Schritt besteht darin, die Ziele der Nutzer, die Geschäftsziele, die technischen Einschränkungen und den emotionalen Zustand des Nutzers zu verstehen, bevor der Entwurf beginnt.
02
Entwerfen Sie ausgehend von gesprochener Sprache
Beginnen Sie mit dem, was Sie laut sagen würden, wenden Sie das Muster des Elements an, wägen Sie Voice und Tonalität ab und stellen Sie die wichtigen Informationen an den Anfang.
03
Bearbeiten Sie in vier geordneten Durchgängen
Die Datei schreibt vier Phasen in dieser Reihenfolge vor: zielgerichtet, prägnant, konversationell, klar, jede mit eigenen Prüffragen.
04
Passen Sie die Tonalität an den Moment an
Die Tonalität wird an den emotionalen Zustand des Nutzers angepasst – frustriert, verwirrt, zuversichtlich, vorsichtig, erfolgreich –, während die Voice konstant bleibt.
05
Testen und messen
Prüfen Sie mit dem Team, testen Sie wenn möglich mit Nutzern, und messen Sie dann die Aufgabenerfüllung und das Verständnis statt Meinungen.

02 Finden Sie Ihren Favoriten

Wann Sie den ux-writing Skill verwenden sollten

Verwenden Sie den ux-writing Skill in Claude Code oder Codex, wenn die Aufgabe UX-Recherche dieser Art ist. Eignung und Grenzen unten sind der eigenen Datei des Skills entnommen.

Gut geeignet

Neue Texte für Interface-Elemente verfassen: Buttons, Labels, Titel, Meldungen und Formulare.
Bestehende UX-Texte bearbeiten, die bereits live sind, sich aber schlecht lesen.
Die Inhalte eines Produkts auf Konsistenz und Benutzbarkeit über Screens hinweg prüfen.
Fehler-, Benachrichtigungs- und Erfolgsmeldungen verfassen, die erklären und zur Wiederherstellung anleiten.
Die Voice und Tonalität eines Produkts festlegen oder Onboarding- und Konversationsflows gestalten.

Grenzen kennen

Funktioniert nicht in ChatGPT — die Datei besagt, dass sie mit Codex CLI/IDE läuft und dass ChatGPT keine Skills installieren oder verwenden kann.
Vage Fehlererklärungen wie "Something went wrong" werden als zu vermeidende Dinge aufgeführt.
Übertrieben cleverer Humor ist in ernsten Kontexten fehl am Platz.

Was Sie bereitstellen sollten

Der emotionale Zustand des Nutzers und der EinsatzDie Tonalität wird danach gewählt, wie sich der Nutzer fühlt und wie viel auf dem Spiel steht — eine risikoarme Themenänderung liest sich anders als das Löschen eines Kontos.
Einschränkungen bei der BarrierefreiheitOb der visuelle Kontext für ein Element ausreicht, oder ob explizite Labels und ARIA-Labels für assistive Technologien nötig sind.

03 Innerhalb des Skills

Regeln, die die ux-writing Skill Claude Code und Codex vorgibt

8 konkrete Anweisungen, Standardwerte und Grenzen, die die SKILL.md für den Agent festlegt – der Teil der Datei, der das Ergebnis verändert.

Zeilen mit 40-60 Zeichen
Zeilen mit Interface-Text sollten 40-60 Zeichen umfassen, das maximale Lesbarkeitsintervall, das die Datei festlegt.
Buttons: 2-4 Wörter
Button- und CTA-Beschriftungen sollten 2 bis 4 Wörter umfassen, mit 6 Wörtern als absoluter Obergrenze.
Einfache Sprache je Zielgruppe
Schreiben Sie für ein allgemeines Publikum auf dem Leseniveau der 7. Klasse und für professionelle Kontexte auf dem der 10. Klasse.
85 % der Zeit im Aktiv
Rund 85 % des Textes sollten im Aktiv stehen.
Fehlertexte folgen einer festen Reihenfolge
Fehlertexte nennen zuerst, was fehlgeschlagen ist, dann warum bzw. den Kontext, dann was zu tun ist — in dieser Reihenfolge.
Nie dem Nutzer die Schuld geben
Fehlertexte benennen das Problem, ohne der lesenden Person die Schuld zu geben.
Nie allein auf Farbe setzen
Bedeutung wird nie ausschließlich über Farbe transportiert; visuelle Indikatoren werden immer mit Text kombiniert.
Fehlermeldungen: 12-18 Wörter
Eine Fehlermeldung sollte inklusive Lösungshinweis zwischen 12 und 18 Wörtern liegen.

04 In Betrieb nehmen

ux-writing in Claude Code oder Codex installieren

Ein npx skills add-Befehl, dann eine erste Aufgabe in Ihrem Agent und eine Checkliste für das Ergebnis.

ux-writing zu Claude Code, Codex oder Ihrem Agent hinzufügen

Im eigenen Projekt ausführen; der Installer fragt, welchem Agent er hinzugefügt werden soll.

Terminal

npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

Generische skills-CLI-Form für SKILL.md; das Repository kann einen eigenen Pfad dokumentieren.

Geben Sie dem Skill eine erste UX-Research-Aufgabe

In den eigenen Begriffen des Skills verfasst; ersetzen Sie die Teile in Klammern durch Ihr Material.

Starter prompt

Write the microcopy for our [checkout] flow: the payment button label, the field labels, and the message a user sees when their card is declined. The user will be frustrated, so keep the tone empathetic and give a clear next step. Then run the four-phase edit and flag any line over 60 characters.

Quelle: verfasst aus der SKILL.md in den eigenen Begriffen des Skills.

Das erste Ergebnis prüfen

Was die SKILL.md selbst als korrektes Ergebnis beschreibt:

Lesen Sie den Text laut vor und prüfen Sie, ob Sie ihn tatsächlich so sagen würden.
Prüfen Sie Texte mit einem Lesbarkeits-Tool; die Dateien Hemingway Editor und Flesch-Kincaid-Bewertung.
Prüfen Sie Verständlichkeits-Benchmarks: 8 Wörter oder weniger erreichen 100 % Verständnis, 14 Wörter oder weniger 90 %.
Arbeiten Sie references/content-usability-checklist.md durch, die mitgelieferte Checkliste zur Bewertung der UX-Textqualität.
Lassen Sie das Team den Text prüfen und mit Nutzern testen, wobei Aufgabenerfolg und Verständnis gemessen werden, nicht Geschmack.
Stellen Sie für die Barrierefreiheit sicher, dass Fehler so strukturiert sind, dass Fehlermeldung und Feldbeschriftung von einem Screenreader gemeinsam vorgelesen werden.

In OpenDesign importieren Sie ux-writing über den SKILL.md-Link: Plugins → Add → Skill → Import from link, und wählen es dann in der oberen Leiste aus.

OpenDesign herunterladen Quickstart lesen

05 Open Source, nachvollziehbar

Quelle, Lizenz und Verifizierung

Woher die Fakten auf dieser Seite stammen und wann sie zuletzt geprüft wurden.

Author: content-designer
Repository: github.com/content-designer/ux-writing-skill Branch main
Skill-Datei: SKILL.md Content-Prüfsumme bei Verifizierung erfasst; Commit 98cacde
License: MIT Aus LICENSE.
Repository-Sterne: 168 GitHub-Snapshot vom 14.09.2026 für das gesamte Repository content-designer/ux-writing-skill. Keine Bewertung oder Nutzungszahl für ux-writing.
Verifiziert von OpenDesign: 14.09.2026 Quelldatei, Pfad, Lizenztext und Sternezählung wurden geprüft. Nicht in OpenDesign main gebündelt (geprüft 28.08.2026); ein Live-Durchlauf wurde auf dieser Seite nicht erfasst.

In der SKILL.md

Wann dieser Skill genutzt wirdSechs Auslöser: Schreiben oder Bearbeiten von Interface-Texten, Nachrichten, Konversationsabläufen, Tonalität, Content-Audits.
Grundprinzipien des UX WritingDie vier Qualitätsstandards sowie Prägnanz, Klarheit, konversationeller Ton und nutzerzentrierte Praktiken.
UX-TextmusterFormate und Beispiele für Titel, Buttons, vier Fehlertypen, Erfolgsmeldungen, Leerzustände, Formulare und Benachrichtigungen.
Stimme und TonEine konstante Stimme etablieren; den Ton je nach emotionalem Zustand des Nutzers und Inhaltstyp anpassen.
RedigierprozessVier aufeinanderfolgende Durchgänge – zielgerichtet, prägnant, gesprächsnah, klar – jeweils mit eigenen Prüffragen.
WorkflowKontext verstehen, Entwurf erstellen, iterativ durch die vier Phasen redigieren, dann testen und messen.
Barrierefreiheit im UX-WritingAnforderungen für Screenreader, kognitive Zugänglichkeit, multimodale Kommunikation und einfache Sprache, mit Beispielen für schlechte und gute Muster.
UX-Text-BenchmarksZiele für Satz- und Zeichenlänge nach Element, Verständnisraten und Lesestufen samt Testtools.
Häufige Fehler vermeidenElf Anti-Patterns, von Passivkonstruktionen und generischen Labels bis hin zu unzugänglichem Linktext.
KurzreferenzEinzeilige Erinnerungen zu Satzgroßschreibung, imperativen Buttons, Nutzerfokus, konkreten Verben und Front-Loading.
RessourcenNeun mitgelieferte Dateien: Barrierefreiheits-Leitfaden, Stimmdiagramm, Usability-Checkliste, Musterbeispiele, Vorlagen und Figma-Integration.

Die eigene Beschreibung des Skills

„Erstellen Sie nutzerzentrierte, barrierefreie Oberflächentexte (Microcopy) für digitale Produkte, einschließlich Buttons, Labels, Fehlermeldungen, Benachrichtigungen, Formulare, Onboarding, leere Zustände, Erfolgsmeldungen und Hilfetexte. Verwenden Sie diesen Skill beim Schreiben oder Bearbeiten von Text, der in Apps, Websites oder Software-Oberflächen erscheint, beim Gestalten konversationaler Abläufe, Etablieren von Voice- und Tone-Richtlinien, Prüfen von Produktinhalten auf Konsistenz und Nutzbarkeit, Überprüfen von UI-Strings oder Verbessern bestehender Oberflächentexte. Wendet UX-Writing-Best-Practices basierend auf vier Qualitätsstandards an – zweckorientiert, prägnant, konversational und klar. Enthält Barrierefreiheits-Richtlinien, forschungsgestützte Benchmarks (Satzlänge, Verständlichkeitsraten, Lesestufen), erweiterte Fehlermuster, Frameworks zur Tonanpassung und umfassende Referenzmaterialien."

Front-matter-Beschreibung aus SKILL.md. Die vollständige Datei umfasst etwa 15.313 Zeichen. Lesen Sie die vollständige Datei auf GitHub.

06 Vor der Installation

Fragen zum Skill ux-writing

Die Antworten stammen aus der SKILL.md, gelesen am 14.09.2026, nicht aus einem protokollierten Lauf.

Welche Agents können diesen Skill ausführen?

Er ist für Claude, Codex, Cursor und jeden anderen Agent geschrieben, der die Agent-Skills-Spezifikation unterstützt. ChatGPT ist ausdrücklich ausgeschlossen – es kann keine Skills installieren oder verwenden.

Kann ich ihn auf bereits vorhandene Texte anwenden?

Ja. Der Skill umfasst das Redigieren bestehender UX-Texte, das Überprüfen von UI-Strings und das Auditieren von Produktinhalten auf Konsistenz und Nutzbarkeit – nicht nur das Schreiben von Neuinhalten.

Deckt er Barrierefreiheit ab?

Ja. Barrierefreies Schreiben ist ein eigener Abschnitt, der Screenreader-Optimierung, kognitive Zugänglichkeit, multimodale Kommunikation und einfache Sprache abdeckt, mit einem WCAG-AA-Mindestfarbkontrast von 4,5:1.

UX Writing

Führen Sie ux-writing bei einer realen UX-Research-Aufgabe aus.

Laden Sie OpenDesign herunter, importieren Sie ux-writing über den SKILL.md-Link, fügen Sie den obigen Prompt ein und lesen Sie den Plan vor dem Ergebnis.

OpenDesign herunterladen Alle Skills durchsuchen