ux-writingdi content-designer

UX Writing Skill.

Uno skill per Claude Code e Codex dedicato alla ricerca UX: microcopy accessibile e centrato sull'utente per pulsanti, etichette, errori, form e onboarding.

UX & Research

Scarica OpenDesign Guida all'uso

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

Metadati e intestazioni di sezione estratti dal file upstream il 14/09/2026 · 15.313 caratteri in totale

01 Cosa fa

Cosa Fa la Skill ux-writing in Claude Code e Codex

Sintesi, workflow e output, tutto letto dal SKILL.md della skill.

Dal SKILL.mdLetto il 14-09-2026 · non è un'esecuzione registrata

Nelle parole della skill

Una guida operativa per scrivere e modificare microcopy nei prodotti digitali: pulsanti, etichette, titoli, messaggi di errore, notifiche, form, onboarding, stati vuoti, messaggi di successo e testi di aiuto. Ogni stringa viene valutata rispetto a quattro standard di qualità — mirata, concisa, colloquiale e chiara — e ogni tipo di elemento ha un pattern, come [Verbo] [oggetto] per i pulsanti e [Cosa è andato storto].

[Perché/contesto]. [Cosa fare]. per gli errori. La voice è trattata come una personalità di marca fissa, mentre il tono varia tra utenti frustrati, confusi, sicuri, cauti e di successo. La skill aggiunge regole di accessibilità, parametri di riferimento su frasi e caratteri basati su ricerche, un processo di editing in quattro fasi e file di riferimento per grafici di voice, usabilità dei contenuti e Figma MCP.

Che cosa produce

Il testo dell'interfaccia stesso in pulsanti, etichette, messaggi di errore, notifiche, form ed elementi correlati.
Un grafico della voice di prodotto, costruito con references/voice-chart-template.md, che collega i concetti di marca alle caratteristiche della voice ed esempi di cosa fare/non fare.
Messaggi di errore scritti a partire da templates/error-message-template.md, un template compilabile per messaggi di errore efficaci.
Un flusso di onboarding progettato a partire da templates/onboarding-flow-template.md, il framework per esperienze di onboarding chiare.

Vedi l'esempio di prompt ↗

Come funziona

01
Partire dal contesto
Il primo passo è comprendere gli obiettivi dell'utente, gli obiettivi di business, i vincoli tecnici e lo stato emotivo dell'utente prima di iniziare qualsiasi bozza.
02
Redigere a partire dal parlato
Iniziare da ciò che direste ad alta voce, applicare il pattern dell'elemento, valutare voice e tone, poi anticipare le informazioni importanti.
03
Modificare in quattro passaggi ordinati
Il file prescrive quattro fasi, da eseguire in ordine: purposeful, concise, conversational, clear, ciascuna con le proprie domande di verifica.
04
Adattare il tone al momento
Il tone viene adattato in base allo stato emotivo dell'utente — frustrato, confuso, sicuro, cauto, soddisfatto — mentre il voice resta costante.
05
Testare e misurare
Rivedere con il team, testare con gli utenti quando possibile, quindi misurare il completamento dei task e la comprensione piuttosto che l'opinione.

02 Trova la tua applicazione

Quando usare la ux-writing Skill

Usa la ux-writing skill in Claude Code o Codex quando il lavoro è una ricerca UX di questo tipo. Campo di applicazione e limiti qui sotto sono tratti dal file della skill stessa.

Buona applicazione

Scrivere testi nuovi per elementi dell'interfaccia: pulsanti, etichette, titoli, messaggi e form.
Modificare testi UX esistenti già pubblicati ma poco efficaci.
Verificare i contenuti di un prodotto per coerenza e usabilità tra le schermate.
Scrivere messaggi di errore, notifica e successo che spiegano e permettono di recuperare.
Definire il voice e il tone di un prodotto, oppure progettare flussi di onboarding e conversazionali.

Conosci i limiti

Non funziona in ChatGPT — il file specifica che viene eseguito con Codex CLI/IDE e che ChatGPT non può installare o usare skill.
Spiegazioni vaghe degli errori come "Qualcosa è andato storto" sono elencate tra le cose da evitare.
L'umorismo eccessivamente ricercato è escluso nei contesti seri.

Cosa fornire

Lo stato emotivo dell'utente e la posta in giocoIl tone viene scelto in base a come si sente l'utente e a quanto è in gioco — un cambio di tema a basso rischio si legge diversamente dall'eliminazione di un account.
Vincoli di accessibilitàSe il contesto visivo è sufficiente per un elemento, oppure sono necessarie etichette esplicite e ARIA label per le tecnologie assistive.

03 Dentro la skill

Le regole che la skill ux-writing dà a Claude Code e Codex

8 istruzioni concrete, valori predefiniti e limiti che il SKILL.md imposta per l'agente — la parte del file che cambia il risultato.

Righe di 40-60 caratteri
Le righe di testo dell'interfaccia dovrebbero rientrare in 40-60 caratteri, l'intervallo massimo di leggibilità stabilito dal file.
Pulsanti: 2-4 Parole
Le etichette di pulsanti e CTA devono essere di 2-4 parole, con 6 parole come limite massimo assoluto.
Linguaggio Semplice in Base al Pubblico
Scrivete a un livello di lettura di terza media per un pubblico generico e di scuola superiore per contesti professionali.
Voce Attiva l'85% delle Volte
Circa l'85% del testo deve essere in forma attiva.
Gli Errori Seguono un Ordine Fisso
Il testo di errore indica cosa non ha funzionato, poi il perché o il contesto, poi cosa fare, in quest'ordine.
Non Colpevolizzare Mai l'Utente
Il testo di errore riconosce il problema senza colpevolizzare chi lo legge.
Non Usare Mai Solo il Colore
Il significato non è mai veicolato dal solo colore; gli indicatori visivi sono sempre accompagnati da testo.
Messaggi di Errore: 12-18 Parole
Un messaggio di errore, inclusa la soluzione, deve rientrare tra le 12 e le 18 parole.

04 Mettila al lavoro

Installate ux-writing in Claude Code o Codex

Un comando npx skills add, poi un primo task nel tuo agente e una checklist per il risultato.

Aggiungete ux-writing a Claude Code, Codex o al vostro agente

Eseguitelo nel Suo progetto; l'installer chiede a quale agente aggiungerlo.

Terminal

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

Forma generica della CLI skills per SKILL.md; il repository può documentare un proprio percorso.

Assegnare allo Skill un Primo Compito di Ricerca UX

Redatto nei termini propri della skill; sostituisca le parti tra parentesi con il suo materiale.

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.

Fonte: redatto a partire dal SKILL.md, nei termini propri della skill.

Verifica il primo risultato

Ciò che il SKILL.md stesso indica come risultato corretto:

Leggete il testo ad alta voce e chiedetevi se lo direste davvero in quel modo.
Passate i testi in uno strumento di leggibilità; i file si chiamano Hemingway Editor e punteggio Flesch-Kincaid.
Verificate i parametri di comprensione: 8 parole o meno raggiungono il 100% di comprensione, 14 parole o meno il 90%.
Seguite references/content-usability-checklist.md, la checklist fornita per valutare la qualità del testo UX.
Fate revisionare il team e testate con gli utenti, misurando il completamento dei compiti e la comprensione, non il gusto personale.
Per l'accessibilità, verificate che gli errori siano strutturati in modo che l'errore e l'etichetta del campo vengano annunciati insieme da uno screen reader.

In OpenDesign importate ux-writing dal suo link SKILL.md: Plugins → Add → Skill → Import from link, quindi selezionatelo nella barra superiore.

Scarica OpenDesign Leggi il quickstart

05 Open source, tracciabile

Sorgente, licenza e verifica

Da dove provengono i dati di questa pagina e quando sono stati verificati l'ultima volta.

Author: content-designer
Repository: github.com/content-designer/ux-writing-skill Branch main
File della skill: SKILL.md Checksum del contenuto registrato alla verifica; commit 98cacde
License: MIT Da LICENSE.
Stelle del repository: 168 Snapshot GitHub scattato il 14-09-2026 per l'intero repository content-designer/ux-writing-skill. Non è un punteggio o conteggio di utilizzo per ux-writing.
Verificato da OpenDesign: 14/09/2026 File sorgente, percorso, testo della licenza e conteggio delle stelle sono stati verificati. Non inclusa in OpenDesign main (verificato il 28/08/2026); un'esecuzione live non è stata registrata in questa pagina.

All'interno di SKILL.md

Quando Usare Questa SkillSei situazioni: scrivere o modificare testi di interfaccia, messaggi, flussi conversazionali, voce, verifica dei contenuti.
Principi Fondamentali di UX WritingI quattro standard di qualità più concisione, chiarezza, tono conversazionale e approccio centrato sull'utente.
Pattern di Testo UXFormati ed esempi per titoli, pulsanti, quattro tipi di errore, messaggi di successo, stati vuoti, moduli e notifiche.
Voce e TonoCostruire una voce costante; adattare il tono in base allo stato emotivo dell'utente e al tipo di contenuto.
Processo di EditingQuattro passaggi ordinati — mirato, conciso, colloquiale, chiaro — ognuno con le proprie domande di verifica.
WorkflowComprendere il contesto, scrivere una bozza, modificare in modo iterativo attraverso le quattro fasi, poi testare e misurare.
Accessibilità nella Scrittura UXRequisiti per screen reader, accessibilità cognitiva, multimodale e linguaggio semplice, con esempi di pattern scorretti e corretti.
Benchmark del Testo UXObiettivi di lunghezza in frasi e caratteri per elemento, tassi di comprensione e livelli di lettura con strumenti di test.
Errori Comuni da EvitareUndici anti-pattern, dalla voce passiva alle etichette generiche fino al testo dei link inaccessibile.
Riferimento RapidoPromemoria in una riga su sentence case, pulsanti imperativi, focus sull'utente, verbi specifici e informazioni chiave in apertura.
RisorseNove file inclusi: guida all'accessibilità, tabella delle voci, checklist di usabilità, esempi di pattern, template e integrazione con Figma.

Descrizione della skill

"Crea testo per interfacce (microcopy) centrato sull'utente e accessibile per prodotti digitali, inclusi pulsanti, etichette, messaggi di errore, notifiche, moduli, onboarding, stati vuoti, messaggi di successo e testo di aiuto. Usala quando scrivi o modifichi qualsiasi testo che appare in app, siti web o interfacce software, progetti flussi conversazionali, stabilisci linee guida di voce e tono, verifichi il contenuto del prodotto per coerenza e usabilità, revisioni stringhe UI o migliori il copy esistente dell'interfaccia. Applica le best practice di UX writing basate su quattro standard di qualità — finalizzato, conciso, conversazionale e chiaro. Include linee guida di accessibilità, benchmark basati su ricerca (lunghezza delle frasi, tassi di comprensione, livelli di lettura), pattern di errore espansi, framework di adattamento del tono e materiali di riferimento completi."

Descrizione front-matter da SKILL.md. Il file completo è di circa 15.313 caratteri. Leggi il file completo su GitHub.

06 Prima di installare

Domande sullo Skill ux-writing

Le risposte provengono dal SKILL.md letto il 2026-09-14, non da un'esecuzione registrata.

Quali agenti possono eseguire questo skill?

È scritto per Claude, Codex, Cursor e qualsiasi altro agente che supporti la specifica degli agent skills. ChatGPT è esplicitamente escluso — non può installare né usare skill.

Posso usarlo su testi già esistenti?

Sì. Lo skill copre l'editing di testi UX già esistenti, la revisione delle stringhe UI e l'audit dei contenuti di prodotto per coerenza e usabilità, non solo la scrittura da zero.

Copre l'accessibilità?

Sì. La scrittura accessibile è una sezione a sé, che copre l'ottimizzazione per screen reader, l'accessibilità cognitiva, la comunicazione multimodale e il linguaggio semplice, con un contrasto colore minimo WCAG AA di 4.5:1.

UX Writing

Esegui ux-writing su un task reale di ricerca UX.

Scarica OpenDesign, importa ux-writing dal link SKILL.md, incolla il prompt qui sopra e leggi il piano prima del risultato.

Scarica OpenDesign Esplora tutte le skill

Terminale

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

Cosa Fa la Skill ux-writing in Claude Code e Codex

Nelle parole della skill

Come funziona

Quando usare la ux-writing Skill

Buona applicazione

Conosci i limiti

Cosa fornire

Le regole che la skill ux-writing dà a Claude Code e Codex

Righe di 40-60 caratteri

Pulsanti: 2-4 Parole

Linguaggio Semplice in Base al Pubblico

Voce Attiva l'85% delle Volte

Gli Errori Seguono un Ordine Fisso

Non Colpevolizzare Mai l'Utente

Non Usare Mai Solo il Colore

Messaggi di Errore: 12-18 Parole