ux-writingpor content-designer

UX Writing Skill.

Una skill de Claude Code y Codex para investigación UX: microtextos accesibles y centrados en el usuario: botones, etiquetas, errores, formularios, onboarding.

UX & Research

Descargar OpenDesign Ver guía de 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

Encabezados de front matter y sección leídos del archivo upstream el 14/09/2026 · 15313 caracteres en total

01 Qué hace

Qué Hace el Skill ux-writing en Claude Code y Codex

Resumen, flujo de trabajo y resultados, todo leído del SKILL.md del skill.

Del SKILL.mdLeído 2026-09-14 · no es una ejecución registrada

En los propios términos del Skill

Una guía práctica para escribir y editar microcopy en productos digitales: botones, etiquetas, títulos, mensajes de error, notificaciones, formularios, incorporación, estados vacíos, mensajes de éxito y texto de ayuda. Cada cadena se evalúa según cuatro estándares de calidad —con propósito, concisa, conversacional y clara— y cada tipo de elemento tiene un patrón, como [Verbo] [objeto] para botones y [Qué falló].

[Por qué/contexto]. [Qué hacer]. para errores. La voz se trata como una personalidad de marca fija, mientras que el tono varía entre usuarios frustrados, confundidos, confiados, cautelosos y exitosos. El skill añade reglas de accesibilidad, referencias de oraciones y caracteres respaldadas por investigación, un proceso de edición en cuatro fases y archivos de referencia para tablas de voz, usabilidad de contenido y Figma MCP.

Qué produce

El copy de la interfaz en sí, a través de botones, etiquetas, mensajes de error, notificaciones, formularios y elementos relacionados.
Una tabla de voz del producto, construida con references/voice-chart-template.md, que relaciona los conceptos de marca con las características de voz y ejemplos de qué hacer y qué no hacer.
Mensajes de error escritos a partir de templates/error-message-template.md, una plantilla rellenable para mensajes de error efectivos.
Un flujo de onboarding diseñado a partir de templates/onboarding-flow-template.md, el marco para experiencias de onboarding claras.

Ver el ejemplo de prompt ↗

Cómo funciona

01
Empezar por el Contexto
El primer paso es comprender los objetivos del usuario, los objetivos de negocio, las restricciones técnicas y el estado emocional del usuario antes de comenzar cualquier redacción.
02
Redactar a partir del Habla
Empiece por lo que diría en voz alta, aplique el patrón del elemento, sopese la voz y el tono, y luego anteponga la información importante.
03
Editar en Cuatro Pasadas Ordenadas
El archivo prescribe cuatro fases, ejecutadas en orden: propositiva, concisa, conversacional, clara, cada una con sus propias preguntas de verificación.
04
Ajustar el Tono al Momento
El tono se adapta según el estado emocional del usuario —frustrado, confundido, confiado, cauteloso, exitoso— mientras la voz permanece constante.
05
Probar y Medir
Revise con el equipo, pruebe con usuarios cuando sea posible, y luego mida la finalización de tareas y la comprensión, no la opinión.

02 Encuentra tu caso de uso

Cuándo usar el ux-writing Skill

Use el ux-writing skill en Claude Code o Codex cuando el trabajo sea investigación UX de este tipo. Idoneidad y límites a continuación se toman del archivo propio del skill.

Buen caso de uso

Redactar textos nuevos para elementos de interfaz: botones, etiquetas, títulos, mensajes y formularios.
Editar textos de UX existentes que ya se publicaron pero se leen mal.
Auditar el contenido de un producto para verificar consistencia y usabilidad entre pantallas.
Redactar mensajes de error, notificación y éxito que expliquen y ayuden a recuperarse.
Establecer la voz y el tono de un producto, o diseñar flujos de onboarding y conversacionales.

Conozca los límites

No funcionará en ChatGPT: el archivo indica que se ejecuta con Codex CLI/IDE y que ChatGPT no puede instalar ni usar skills.
Explicaciones de fallo vagas como "Algo salió mal" figuran como algo que se debe evitar.
El humor demasiado ingenioso queda descartado en contextos serios.

Qué proporcionar

El estado emocional del usuario y lo que está en juegoEl tono se elige según cómo se siente el usuario y cuánto está en riesgo — un cambio de tema de bajo impacto se lee de forma distinta a eliminar una cuenta.
Restricciones de accesibilidadSi el contexto visual basta para un elemento, o si se necesitan etiquetas explícitas y etiquetas ARIA para la tecnología de asistencia.

03 Dentro del skill

Reglas que el Skill ux-writing le da a Claude Code y Codex

8 instrucciones concretas, valores por defecto y límites que SKILL.md fija para el agente: la parte del archivo que cambia el resultado.

Líneas de 40-60 Caracteres
Las líneas de texto de interfaz deben tener entre 40 y 60 caracteres, el rango máximo de legibilidad que establece el archivo.
Botones: 2-4 palabras
Las etiquetas de botones y CTA deben tener entre 2 y 4 palabras, con 6 palabras como límite absoluto.
Lenguaje sencillo según el público
Escriba con un nivel de lectura de 7.º grado para el público general y de 10.º grado para contextos profesionales.
Voz activa el 85% del tiempo
Aproximadamente el 85% del texto debe estar en voz activa.
Los errores siguen un orden fijo
El texto de error indica qué falló, luego por qué o el contexto, y después qué hacer, en ese orden.
Nunca culpe al usuario
El texto de error reconoce el problema sin culpar a la persona que lo lee.
Nunca use solo el color
El significado nunca se transmite únicamente mediante el color; los indicadores visuales van acompañados de texto.
Mensajes de error: 12-18 palabras
Un mensaje de error, incluida su solución, debe tener entre 12 y 18 palabras.

04 Ponlo a trabajar

Instalar ux-writing en Claude Code o Codex

Un comando npx skills add, luego una primera tarea en tu agente y una lista de verificación para el resultado.

Añadir ux-writing a Claude Code, Codex o tu agente

Ejecútelo en su proyecto; el instalador pregunta a qué agente añadirlo.

Terminal

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

Forma genérica de la CLI de skills para SKILL.md; el repositorio puede documentar su propia ruta.

Dale al Skill una Primera Tarea de Investigación UX

Redactado en los términos del propio skill; sustituya las partes entre corchetes por su 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.

Fuente: redactado a partir del SKILL.md en los términos del propio skill.

Revisa el primer resultado

Lo que el propio SKILL.md indica que debe ser un resultado correcto:

Lea el texto en voz alta y pregúntese si realmente lo diría así.
Pase los textos por una herramienta de legibilidad; los nombres de archivo Hemingway Editor y la puntuación Flesch-Kincaid.
Verifique los puntos de referencia de comprensión: 8 palabras o menos logra un 100% de comprensión, 14 palabras o menos logra un 90%.
Recorra references/content-usability-checklist.md, la lista de verificación incluida para evaluar la calidad del texto UX.
Haga que el equipo revise y pruebe con usuarios, midiendo la finalización de tareas y la comprensión, en lugar del gusto personal.
Para accesibilidad, confirme que los errores estén estructurados para que el error y la etiqueta del campo se anuncien juntos mediante un lector de pantalla.

En OpenDesign importe ux-writing desde su enlace SKILL.md: Plugins → Add → Skill → Import from link, y luego selecciónelo en la barra superior.

Descargar OpenDesign Leer la guía de inicio rápido

05 Código abierto, rastreable

Fuente, Licencia y Verificación

De dónde provienen los datos de esta página y cuándo se verificaron por última vez.

Author: content-designer
Repository: github.com/content-designer/ux-writing-skill Rama main
Archivo de skill: SKILL.md Checksum del contenido registrado en la verificación; commit 98cacde
License: MIT Desde LICENSE.
Estrellas del repositorio: 168 Instantánea de GitHub tomada el 14-09-2026 para todo el repositorio content-designer/ux-writing-skill. No es una calificación ni un recuento de uso para ux-writing.
Verificado por OpenDesign: 14/09/2026 Se verificaron el archivo fuente, la ruta, el texto de licencia y el recuento de estrellas. No incluido en OpenDesign principal (verificado el 28/08/2026); no se ha registrado una ejecución en vivo en esta página.

Dentro del SKILL.md

Cuándo usar este skillSeis disparadores: redactar o editar texto de interfaz, mensajes, flujos conversacionales, voz, auditoría de contenido.
Principios básicos de redacción UXLos cuatro estándares de calidad, además de concisión, claridad, tono conversacional y prácticas centradas en el usuario.
Patrones de texto UXFormatos y ejemplos para títulos, botones, cuatro tipos de errores, mensajes de éxito, estados vacíos, formularios y notificaciones.
Voz y TonoConstruir una voz constante; adaptar el tono según el estado emocional del usuario y el tipo de contenido.
Proceso de EdiciónCuatro pasadas ordenadas —con propósito, concisa, conversacional, clara— cada una con sus preguntas de verificación.
Flujo de TrabajoComprender el contexto, redactar, editar de forma iterativa a través de las cuatro fases y luego probar y medir.
Accesibilidad en la Redacción UXRequisitos de lector de pantalla, cognitivos, multimodales y de lenguaje sencillo, con ejemplos de patrones malos y buenos.
Referencias de Texto UXObjetivos de oraciones y caracteres por elemento, tasas de comprensión y niveles de lectura, con herramientas de prueba.
Errores Comunes que EvitarOnce antipatrones, desde la voz pasiva y etiquetas genéricas hasta texto de enlace inaccesible.
Referencia RápidaRecordatorios de una línea sobre uso de minúsculas en oraciones, botones en modo imperativo, foco en el usuario, verbos específicos y anteponer la información clave.
RecursosNueve archivos incluidos: guía de accesibilidad, tabla de voz, lista de verificación de usabilidad, ejemplos de patrones, plantillas e integración con Figma.

La descripción propia del Skill

Cree textos de interfaz (microcopy) centrados en el usuario y accesibles para productos digitales, incluyendo botones, etiquetas, mensajes de error, notificaciones, formularios, onboarding, estados vacíos, mensajes de éxito y texto de ayuda. Use cuando escriba o edite cualquier texto que aparezca en apps, sitios web o interfaces de software, diseñe flujos conversacionales, establezca guías de voz y tono, audite contenido de producto para consistencia y usabilidad, revise cadenas de UI o mejore textos de interfaz existentes. Aplica las mejores prácticas de escritura UX basadas en cuatro estándares de calidad — con propósito, conciso, conversacional y claro. Incluye guías de accesibilidad, referencias basadas en investigación (longitud de oraciones, tasas de comprensión, niveles de lectura), patrones de error ampliados, marcos de adaptación de tono y materiales de referencia completos.

Descripción del encabezado de SKILL.md. El archivo completo tiene aproximadamente 15.313 caracteres. Lee el archivo completo en GitHub.

06 Antes de instalar

Preguntas Sobre el Skill ux-writing

Las respuestas provienen del SKILL.md tal como se leyó el 2026-09-14, no de una ejecución registrada.

¿Qué agentes pueden ejecutar este skill?

Está escrito para Claude, Codex, Cursor y cualquier otro agente que admita la especificación de agent skills. ChatGPT queda explícitamente excluido: no puede instalar ni usar skills.

¿Puedo usarlo en textos que ya existen?

Sí. El skill cubre la edición de texto UX existente, la revisión de cadenas de UI y la auditoría de contenido de producto para verificar la coherencia y usabilidad, no solo la redacción desde cero.

¿Cubre la accesibilidad?

Sí. La redacción accesible tiene su propia sección, que abarca la optimización para lectores de pantalla, la accesibilidad cognitiva, la comunicación multimodal y el lenguaje sencillo, con un contraste de color mínimo WCAG AA de 4.5:1.

UX Writing

Ejecuta ux-writing en una Tarea de Investigación UX Real.

Descargue OpenDesign, importe ux-writing desde su enlace SKILL.md, pegue el prompt anterior y lea el plan antes del resultado.

Descargar OpenDesign Ver todas las skills