clarify

Visión general de clarify skill

Qué hace clarify skill

clarify mejora el copy de UX cuando no se entiende bien: etiquetas, textos de ayuda, estados vacíos, instrucciones de onboarding, confirmaciones y, sobre todo, mensajes de error. Está pensado para situaciones en las que las personas usuarias se confunden no porque falten funciones en la interfaz, sino porque el texto hace que el producto cueste más de entender.

Cuándo encaja mejor clarify para UI/UX Design

clarify for UI/UX Design encaja mejor con diseñadores de producto, UX writers, equipos frontend, PMs y agentes de IA que revisan texto de interfaz antes de publicar. Resulta más útil cuando la pantalla ya existe y el trabajo consiste en hacer el wording más claro, más accionable y mejor ajustado al contexto de uso.

El trabajo real que resuelve

Quienes instalan clarify no lo hacen solo para “reescribir copy”. Lo usan para responder preguntas más difíciles y prácticas: por qué un mensaje no está funcionando, qué es probable que la gente malinterprete, cuánto contexto conviene añadir, qué tono encaja en ese momento y cómo reescribir el texto para que las personas actúen sin dudar.

Qué diferencia a clarify de un prompt genérico

La diferencia principal está en el proceso. No es un prompt libre del tipo “haz que esto suene mejor”. La skill fuerza una revisión estructurada de:

• el nivel técnico de la audiencia
• el estado mental de la persona usuaria
• la acción que debe realizar
• el contexto que falta en el texto actual
• tipos concretos de fallo de claridad, como jerga, ambigüedad, supuestos o desajuste de tono

Eso hace que clarify skill sea más útil que un prompt genérico para pulir copy cuando lo importante es la comprensión funcional, no solo el estilo.

Advertencia importante antes de adoptarlo

El mayor bloqueo es que depende de contexto de diseño previo. La skill exige explícitamente /frontend-design, y si todavía no existe contexto de diseño, indica que primero debes ejecutar /teach-impeccable. Así que clarify install es fácil a nivel de skill, pero la calidad del resultado depende de si puedes aportar desde el principio contexto de producto, audiencia e interfaz.

Cómo usar clarify skill

clarify install y cómo invocarlo

El fragmento del repositorio muestra clarify como una skill invocable por el usuario con la pista de argumento [target]. En la práctica, instálala desde el repositorio pbakaus/impeccable e invoca clarify sobre una pantalla, flujo, componente o bloque de copy concreto, no con una petición vaga a nivel de todo el producto.

Un patrón de instalación práctico es:

• añadir la skill desde https://github.com/pbakaus/impeccable
• invocar clarify con un objetivo como un modal, un error de checkout, un paso de onboarding o una página de ajustes

Si tu entorno admite comandos de instalación de skills por nombre, usa la URL del repo junto con la ruta de la skill clarify. Si no, importa el conjunto de skills del repositorio y llama a clarify directamente.

Lee primero este archivo

Empieza por:

• SKILL.md

En el árbol proporcionado, esta skill no muestra README.md, metadata.json, reglas ni carpetas de recursos de apoyo. Eso significa que la mayor parte de la guía real de uso está concentrada en SKILL.md, y que hay menos profundidad de implementación oculta que en skills más grandes.

Contexto necesario antes de usar clarify skill

Antes de pedirle a clarify que reescriba nada, reúne:

• el copy exacto actual
• dónde aparece en la UI
• quién es la audiencia
• cuál es el estado mental probable de la persona usuaria en ese momento
• qué acción debe realizar a continuación
• cualquier restricción de producto o de dominio

Esto importa porque la skill evalúa la claridad en contexto, no de forma aislada. Una reescritura técnicamente correcta puede seguir fallando si ignora la urgencia, la confianza o el nivel de experiencia de la persona usuaria.

Por qué importa la dependencia de frontend-design

clarify usage está encadenado explícitamente a /frontend-design. Es una señal clara de que la skill espera que primero se apliquen principios de diseño y un protocolo de recopilación de contexto. Si te saltas ese paso, el resultado puede quedar más limpio a nivel lingüístico, pero seguir siendo incorrecto para el flujo, la jerarquía o el objetivo de usuario.

Si todavía no existe contexto de diseño, la skill indica que ejecutes antes /teach-impeccable. Trátalo como una preparación obligatoria, no como un pulido opcional.

Qué tipo de input da los mejores resultados

Los mejores inputs son concretos y acotados. Por ejemplo:

• texto actual: “Authentication failed”
• superficie: error del formulario de login debajo del campo de contraseña
• audiencia: usuarios de SaaS no técnicos
• estado mental: frustrados, intentando volver al trabajo cuanto antes
• acción deseada: reintentar la contraseña, restablecerla si hace falta
• restricción: no insinuar que el email es incorrecto por motivos de seguridad

Eso dará mejores resultados que:

• “Improve this error message”

Cómo convertir una petición vaga en un buen prompt para clarify

Débil:

• “Make our onboarding copy clearer.”

Mejor:

• “Use clarify on step 2 of onboarding. Current copy: ‘Configure your workspace for enhanced collaboration efficiency.’ Audience: first-time small business users with low technical confidence. Mental state: curious but impatient. Goal: get them to invite teammates. Constraint: keep headline under 8 words and body under 20 words.”

La versión mejorada le da a clarify skill información suficiente para evaluar la jerga, el contexto ausente, la claridad de la acción y el tono.

Qué es probable que revise clarify

Según SKILL.md, la skill comprueba de forma sistemática:

• jerga que la audiencia puede no entender
• ambigüedad y múltiples interpretaciones
• voz pasiva que oculta quién debe actuar
• copy demasiado largo o demasiado escueto
• supuestos sobre lo que la persona usuaria ya sabe
• falta de contexto sobre lo ocurrido o sobre qué hacer después
• tono inadecuado para la situación

Esto es útil porque deja claro qué tipos de problemas está optimizada para detectar la skill.

Flujo de trabajo recomendado para clarify usage

Un flujo práctico:

1. Ejecuta /frontend-design y reúne contexto.
2. Elige una sola superficie objetivo, no toda la app.
3. Pega el copy actual exacto.
4. Indica audiencia, estado mental y acción siguiente deseada.
5. Pide primero un diagnóstico y luego reescrituras.
6. Revisa el resultado frente al espacio disponible en la UI y las restricciones del producto.
7. Prueba el texto revisado en estados adyacentes como éxito, carga y error.

Esta secuencia suele dar mejores decisiones que pedir reescrituras instantáneas sin diagnóstico previo.

Pide diagnóstico antes de las reescrituras finales

Para un uso de clarify guide con más señal, primero pregunta:

• qué no está claro
• qué podría malinterpretar la persona usuaria
• qué contexto falta
• si el tono encaja con ese momento

Después pide alternativas. Esto evita reescribir demasiado pronto y te ayuda a decidir si el problema real está en el wording, en la arquitectura de información o en la falta de feedback del sistema.

Mejores casos de uso de clarify para UI/UX Design

La skill destaca especialmente en:

• mensajes de error que no explican qué pasó ni qué hacer después
• etiquetas que dependen de terminología interna
• instrucciones de onboarding que dan por sentado conocimiento previo
• estados vacíos con indicaciones vagas o poco útiles
• descripciones de ajustes técnicamente correctas pero difíciles de procesar
• mensajes de confirmación y éxito que no transmiten confianza

Cuándo clarify encaja mal

No esperes que clarify resuelva:

• problemas más profundos de flujo UX donde la interfaz es estructuralmente confusa
• copy legal o de compliance que no puede modificarse de forma sustancial
• trabajo puramente de voz de marca cuando la claridad ya es buena
• escritura preparada para localización sin revisar por separado las restricciones de traducción

Si el problema es de diseño de interacción y no de wording, usa clarify después de corregir el flujo.

Preguntas frecuentes sobre clarify skill

¿clarify skill es apta para principiantes?

Sí, si puedes aportar el texto actual y un contexto básico. Pero quienes empiezan suelen saltarse la parte difícil: describir la audiencia y el estado de la persona usuaria. Sin eso, clarify aún puede mejorar la redacción, pero no mejorar la usabilidad de forma fiable.

¿Necesito todo el repo impeccable para usar clarify?

Principalmente necesitas la skill clarify junto con la dependencia de contexto que requiere. Como el árbol visible solo expone SKILL.md para esta skill, no hay demasiado material adicional del repo que estudiar antes. El requisito clave es tener acceso a /frontend-design y, si hace falta, a /teach-impeccable.

¿En qué se diferencia clarify de pedirle a una IA que reescriba copy?

Un prompt normal suele optimizar para que el texto suene pulido. clarify skill funciona mejor cuando necesitas que la IA inspeccione riesgos de comprensión: jerga, supuestos, ambigüedad, ausencia de próximos pasos y tono bajo condiciones reales de uso.

¿clarify maneja bien los mensajes de error?

Sí. Los estados de error son uno de sus mejores encajes porque la skill pide explícitamente el estado mental de la persona usuaria y la acción siguiente. Eso lleva a reescrituras más útiles que un prompt genérico del tipo “friendly error message”.

¿clarify es solo para microcopy?

No. También puede ayudar con instrucciones breves y guía dentro de la interfaz. Aun así, funciona mejor con texto de UI acotado, no con páginas largas de marketing ni con sistemas de content design completos.

¿Cuándo no debería instalar clarify?

Evita clarify install si tu necesidad principal es una crítica de diseño visual, una reestructuración de IA o estrategia de contenidos para documentos largos. Instálala cuando el verdadero cuello de botella sea la claridad del texto dentro de interfaces de producto.

Cómo mejorar clarify skill

Dale a clarify mejor contexto, no más texto

La forma más rápida de mejorar la salida de clarify es aportar mejores restricciones:

• ubicación exacta en la UI
• límites de caracteres
• nivel de experiencia de la audiencia
• estado emocional
• acción deseada
• afirmaciones prohibidas o límites legales

Más copy alrededor solo ayuda si cambia la interpretación.

Separa el diagnóstico de la reescritura

Pídele a clarify una lista breve de problemas antes de solicitar el copy final. Así aflora si el problema es ambigüedad, falta de contexto o desajuste de tono. Obtendrás mejores revisiones cuando el modo de fallo se nombra primero.

Muestra la acción actual y la acción deseada del usuario

Muchas salidas flojas aparecen porque el modelo no sabe qué debe hacer la persona usuaria a continuación. Incluye ambas cosas:

• qué acaba de pasar
• qué debe hacer ahora la persona usuaria

Por ejemplo, “payment failed” está incompleto a menos que la skill sepa si la acción correcta es reintentar, actualizar la tarjeta, contactar con soporte o esperar.

Incluye explícitamente el estado mental

Esta skill da un peso inusual al estado mental de la persona usuaria, y ese es uno de sus palancas prácticas más potentes. “User is stressed and blocked” debería producir un copy distinto de “user is exploring settings casually.” Si omites esto, el tono puede quedarse en algo agradable pero genérico, en lugar de ser realmente útil.

Pide alternativas con tradeoffs

Solicita de 2 a 4 opciones con prioridades distintas, por ejemplo:

• versión más corta
• versión más tranquilizadora
• versión más orientada a la acción
• versión más clara para usuarios no técnicos

Eso te ayuda a comparar tradeoffs de claridad en lugar de dar una sola reescritura por definitiva.

Vigila los modos de fallo habituales

Formas habituales en las que clarify skill puede quedarse corta:

• pule el wording sin corregir la falta de contexto
• hace el copy más amable, pero menos específico
• elimina términos técnicos que en realidad la persona usuaria sí necesita
• produce texto demasiado largo para el componente de UI
• reescribe cadenas aisladas de forma inconsistente con los estados adyacentes

Normalmente estos problemas vienen del input, no solo del modelo.

Usa restricciones reales de UI durante la iteración

Después de la primera pasada, estrecha la petición:

• “Keep label under 24 characters”
• “Do not mention internal system names”
• “Must be understandable at 8th-grade reading level”
• “Should not blame the user”
• “Preserve security ambiguity around account existence”

Aquí es donde el uso de clarify guide pasa de servir para revisión editorial a estar listo para producción.

Combina clarify con la revisión de pantallas adyacentes

No mejores un mensaje aislado si las personas usuarias lo ven dentro de una secuencia. Revisa en conjunto el disparador, el mensaje en sí y el siguiente paso. Una línea de error clara puede seguir fallando si la etiqueta del CTA o el texto de ayuda que la rodea siguen siendo vagos.

Crea una plantilla de prompt reutilizable

Para equipos que usan clarify for UI/UX Design de forma repetida, conviene crear una plantilla con:

• superficie objetivo
• copy actual
• audiencia
• estado mental
• acción deseada
• restricciones
• petición: primero diagnosticar, luego reescribir

Eso reduce la inconsistencia entre revisiones y hace que la skill sea mucho más fácil de invocar bien.

Mejora la salida de clarify con evidencia de usuarios

Si tienes tickets de soporte, notas de tests de usabilidad o ejemplos de personas que han malinterpretado el texto, inclúyelos. clarify rinde mucho mejor cuando puede reescribir a partir de confusión observada y no solo de confusión hipotética.