clarify

Visión general de la skill clarify

La skill clarify ayuda a reescribir texto confuso de interfaz para que las personas usuarias entiendan qué ocurrió, qué deben hacer a continuación y por qué importa. Está pensada para trabajo de diseño UI/UX, especialmente cuando un producto tiene etiquetas ambiguas, mensajes de error flojos, instrucciones difíciles de seguir o microcopy que suena técnicamente correcto pero aun así confunde a usuarios reales.

Para qué funciona mejor clarify

Usa clarify cuando el problema principal no es el layout ni el flujo de interacción, sino el texto dentro de la interfaz:

• etiquetas de botones que no dejan claro el resultado
• mensajes de error que explican el sistema en vez de ayudar a la persona usuaria
• estados vacíos sin un siguiente paso
• textos de ayuda en formularios que dan por sentado demasiado conocimiento
• instrucciones exactas, pero mentalmente pesadas en momentos de estrés

Esto convierte a la skill clarify en una muy buena opción para product designers, UX writers, equipos frontend y founders que quieren pulir texto visible para el usuario antes del lanzamiento.

El trabajo real que hace clarify

La función práctica de clarify es convertir copy de interfaz impreciso o poco claro en texto que sea:

• más fácil de escanear
• más fácil de convertir en acción
• mejor ajustado al conocimiento de la persona usuaria
• mejor alineado con el momento emocional

Ese último punto importa. La skill original pide explícitamente el nivel técnico de la persona usuaria y su estado mental en contexto, algo mucho más útil que un prompt genérico de “haz esto más claro”.

Qué diferencia a clarify de un prompt genérico de reescritura

Un prompt normal puede producir un texto más limpio. clarify es más intencional respecto a por qué falla un copy:

• jerga
• ambigüedad
• voz pasiva
• falta de contexto
• supuestos ocultos
• desajuste de tono
• exceso o falta de detalle

También depende de un contexto de diseño más amplio. La skill requiere /frontend-design y, si ese contexto aún no existe, primero /teach-impeccable. Esta dependencia es importante al decidir si instalarla: clarify no es una macro aislada para pulir copy; está pensada para funcionar dentro de un flujo mayor de UX/sistema de diseño.

Cómo usar la skill clarify

Instala clarify en el contexto correcto del repositorio

La ruta de clarify install sigue el sistema de skills anfitrión del repo pbakaus/impeccable. Si usas un entorno compatible con Skills, añade el repo e invoca la skill clarify desde ahí. La skill vive en:

/.agents/skills/clarify/SKILL.md

Como la evidencia del repositorio solo expone SKILL.md, conviene leer primero ese archivo antes de asumir que existen assets auxiliares adicionales.

Lee este archivo antes de tu primer uso

Empieza por:

• SKILL.md

Ahí está la lógica real de funcionamiento: preparación requerida, criterios de evaluación y el flujo paso a paso para revisar copy. Aquí no aparecen scripts de soporte ni referencias adicionales, así que el valor principal está en seguir bien la secuencia de la skill.

No te saltes la dependencia obligatoria

Antes de usar clarify, la skill indica invocar:

• /frontend-design

Y si todavía no existe contexto de diseño:

• /teach-impeccable

Este es el mayor bloqueo de adopción para usuarios nuevos. Si te saltas esa preparación, probablemente obtendrás un texto razonable, pero decisiones de UX más débiles. La skill asume que los principios de diseño y la recopilación de contexto ya están resueltos.

Qué información necesita clarify para funcionar bien

La entrada mínima útil para clarify usage es el texto actual y el lugar donde aparece. Los resultados mejoran si además incluyes:

• pantalla o flujo objetivo
• tipo exacto de elemento de UI
• nivel técnico de la audiencia
• estado mental de la persona usuaria en ese momento
• acción deseada después de leer
• restricciones como tono, voz de marca o límite de caracteres

Sin esto, la skill puede reescribir el texto, pero no puede elegir con fiabilidad el nivel correcto de directividad, detalle o tono emocional.

La mejor forma de pedir clarify para UI/UX Design

Una solicitud floja:

• “Improve this error message: Authentication failed.”

Una solicitud más sólida:

• “Use clarify for UI/UX Design. Rewrite this login error message for non-technical users on mobile. They are likely frustrated and trying to get back into their account quickly. Current text: ‘Authentication failed.’ We want them to understand the problem and next step without sounding robotic. Keep it under 90 characters if possible.”

Esa segunda versión le da a la skill la información de decisión que faltaba: audiencia, emoción, contexto de dispositivo y criterio de éxito.

Convierte un objetivo difuso en un prompt útil para clarify

Si tu punto de partida es “haz más claro el texto de la app”, conviértelo a esta estructura:

1. copy actual
2. ubicación dentro del producto
3. quién es la persona usuaria
4. qué está intentando hacer
5. en qué estado emocional se encuentra
6. qué acción debería tomar después
7. restricciones de longitud o tono

Esta estructura encaja muy bien con la clarify guide que se desprende del checklist de la skill.

Flujo recomendado para un uso práctico de clarify

Un flujo fiable se ve así:

1. Reúne contexto de producto y diseño con /frontend-design.
2. Confirma el nivel de la audiencia y su estado mental.
3. Pega el copy original exactamente como aparece.
4. Explica la pantalla y la acción que se espera de la persona usuaria.
5. Pide primero diagnóstico y después opciones de reescritura.
6. Elige una dirección e itera sobre tono, brevedad o especificidad.

Ese paso de “diagnóstico primero” importa, porque la skill está diseñada para identificar por qué un copy no se entiende, no solo para sustituirlo.

Pide a clarify que diagnostique antes de reescribir

Para obtener más valor que con un pulido genérico de LLM, pide la salida en dos etapas:

• problemas de claridad detectados
• alternativas mejoradas

Ejemplo:

• “Use clarify. First identify jargon, ambiguity, missing context, assumptions, and tone issues in this onboarding copy. Then provide 3 rewrite options for first-time users.”

Esto ayuda a los equipos a revisar decisiones, en lugar de limitarse a elegir la versión que “suena mejor”.

Dónde rinde más clarify

La skill clarify funciona especialmente bien con texto corto de UI de alto impacto, como:

• errores
• etiquetas
• texto de ayuda
• confirmaciones
• advertencias
• estados vacíos
• instrucciones de configuración

Son puntos donde una redacción poco clara genera fricción muy rápido y donde una reescritura sensible al contexto puede mejorar de forma tangible la tasa de finalización y la confianza.

Dónde clarify encaja peor

Úsala con cautela si el problema real es:

• un flujo de producto incorrecto
• funcionalidad ausente
• mala arquitectura de la información
• texto legal o de compliance que apenas puede modificarse
• copy largo de marketing

En esos casos, clarify puede mejorar la legibilidad, pero no resolverá el problema de fondo.

FAQ de la skill clarify

¿clarify es solo para UX writers?

No. clarify también resulta útil para designers, PMs, engineers y founders que son responsables del texto de interfaz pero no tienen formación como UX writers. El requisito principal es poder aportar suficiente contexto sobre la persona usuaria y el momento.

¿clarify es apta para principiantes?

En general sí, pero solo si prestas atención a su cadena de dependencias. La skill original exige /frontend-design y, posiblemente, /teach-impeccable antes de reescribir. Quienes empiezan y omiten ese paso pueden pensar que la skill es limitada, cuando en realidad el flujo previsto prioriza el contexto antes que la redacción.

¿Qué hace mejor clarify que un prompt normal de “reescribe esto”?

La principal ventaja es el diagnóstico estructurado. clarify busca causas concretas de confusión como jerga, ambigüedad, voz pasiva, falta de contexto y supuestos sobre el conocimiento de la persona usuaria. Eso suele traducirse en reescrituras más accionables para copy de interfaz.

¿Cuándo no debería usar clarify?

No recurras a clarify cuando el copy sea solo un síntoma de un problema más profundo del producto. Si las personas usuarias se confunden porque el flujo está roto, los permisos no están claros o la UI oculta información clave, una mejor redacción por sí sola no lo va a solucionar.

¿clarify sirve para mensajes de error?

Sí. Este es uno de sus casos de uso más claros. La skill tiene en cuenta explícitamente el estado mental de la persona usuaria, algo crítico en momentos de estrés como fallos de login, problemas de pago o errores de validación en formularios.

¿clarify puede ayudar con tono y voz de marca?

Sí, pero solo si indicas restricciones. Si buscas algo como “claro pero premium”, “amable pero no juguetón” o “tranquilizador en momentos de estrés”, dilo de forma explícita. Si no, la skill optimizará sobre todo la claridad.

Cómo mejorar la skill clarify

Dale a clarify el estado de la persona usuaria, no solo la frase

La mejora con más impacto es describir la situación de la persona usuaria:

• si es principiante o experta
• si está tranquila o estresada
• si está explorando o intentando recuperarse de un fallo
• si está en desktop o mobile
• si tiene mucha o poca atención disponible

Esto afecta directamente a si el mejor copy debe ser más corto, más cálido, más explícito o más instructivo.

Aporta la UI circundante, no el texto aislado

Una etiqueta o mensaje muchas veces parece malo porque le falta contexto alrededor. Para mejorar los resultados de clarify, incluye:

• campos o botones cercanos
• título de la página
• paso anterior
• siguiente acción esperada

Una línea “mala” puede ser aceptable en una pantalla y perjudicial en otra.

Pide varias estrategias de reescritura

En vez de pedir una sola respuesta, solicita opciones como:

• versión más corta y clara
• versión más tranquilizadora
• versión más orientada a la acción

Esto es especialmente útil para clarify for UI/UX Design, porque los equipos a menudo tienen que equilibrar brevedad, tono y nivel de guía.

Usa pronto las restricciones de caracteres o layout

Si el copy debe caber en un botón, toast, modal o campo de formulario en mobile, indícalo desde el principio. De lo contrario, clarify puede generar texto más claro en teoría, pero inviable dentro de la interfaz real.

Vigila los modos de fallo más comunes

Incluso con clarify, los equipos suelen aceptar reescrituras que son:

• más claras pero demasiado largas
• más amables pero vagas
• precisas pero excesivamente técnicas
• pulidas pero desconectadas de la tarea real

Evalúa los resultados según la acción que quieres provocar en la persona usuaria, no solo por la calidad de escritura.

Itera sobre el diagnóstico, no solo sobre el texto

Si el primer resultado no da en el blanco, no pidas únicamente una versión más corta. Pregunta también qué pudo haber entendido mal la skill:

• suposición incorrecta sobre la audiencia
• estado mental incorrecto
• falta de contexto de producto
• simplificación excesiva
• poca explicación del siguiente paso

Esto mejora las salidas posteriores más rápido que una edición superficial.

Combina clarify con una revisión a nivel de pantalla

La mejor forma de mejorar la skill clarify en la práctica es usarla como parte de una revisión de pantalla, no como una herramienta para arreglar frases sueltas. Revisa de forma conjunta todo el copy relacionado:

• título de la página
• etiquetas de campos
• texto de ayuda
• texto de validación
• etiqueta del CTA
• mensaje de éxito o error

Así detectas inconsistencias que una reescritura de una sola línea pasaría por alto.

Mantén una plantilla reutilizable de prompt para clarify usage

Una plantilla sencilla y reutilizable:

• “Use clarify. Context: [screen/flow]. Audience: [user type]. Mental state: [emotion/urgency]. Current copy: [text]. Goal: [desired action]. Constraints: [tone/length/brand]. First diagnose the clarity issues, then give 3 rewrite options.”

Esto hace que el clarify usage sea más consistente entre equipos y reduce las solicitudes con poco contexto que suelen producir resultados genéricos.