clarify

Resumen

¿Qué es la skill clarify?

La skill clarify está diseñada para ayudar a diseñadores UI/UX, desarrolladores frontend y equipos de producto a mejorar sistemáticamente textos poco claros en la interfaz. Se enfoca en perfeccionar el copy de UX, mensajes de error, microcopy, etiquetas e instrucciones para que los productos digitales sean más fáciles de entender y usar. Si tus usuarios tienen dificultades con etiquetas confusas, mensajes de error vagos o instrucciones difíciles de seguir, clarify ofrece un método estructurado para identificar y resolver estos problemas.

¿Quién debería usar clarify?

clarify es ideal para quienes son responsables del diseño de interfaces, redacción UX o desarrollo frontend. Es especialmente útil cuando recibes comentarios sobre textos confusos, etiquetas poco claras o mensajes de error ineficaces, o cuando quieres mejorar proactivamente la claridad en la comunicación de tu producto.

Problemas que resuelve clarify

• Textos de interfaz poco claros o ambiguos
• Jerga técnica que confunde a los usuarios
• Mensajes de error que no ayudan a recuperarse
• Instrucciones difíciles de seguir
• Desajustes de tono o falta de contexto en el texto UI

Cómo usar

Pasos de instalación

1. Instala clarify con el siguiente comando:

   npx skills add https://github.com/pbakaus/impeccable --skill clarify
   

2. Comienza revisando el archivo SKILL.md en el directorio de la skill clarify. Este archivo detalla el flujo de trabajo, pasos de preparación y mejores prácticas para mejorar el copy de la interfaz.

Resumen del flujo de trabajo

• Preparación obligatoria:

  • Invoca $frontend-design para acceder a principios de diseño y al Protocolo de Recolección de Contexto.
  • Si no existe contexto de diseño, ejecuta primero $teach-impeccable.
  • Recopila información sobre el nivel técnico de tu audiencia y el estado mental de los usuarios.

• Evaluar el copy actual:

  • Identifica problemas de claridad como jerga, ambigüedad, voz pasiva, extensión, suposiciones, falta de contexto y desajuste de tono.
  • Comprende el contexto: audiencia, estado del usuario, acción prevista y restricciones.

• Planificar y mejorar:

  • Aborda sistemáticamente cada problema de claridad.
  • Reescribe el copy considerando la perspectiva y estado mental del usuario.
  • Prueba el copy revisado con usuarios reales o partes interesadas.

Estructura de archivos y recursos clave

• Comienza con SKILL.md para el flujo principal.
• Puedes encontrar contexto adicional en README.md, AGENTS.md y carpetas de soporte como rules/, resources/ o references/ si están disponibles en tu instalación.

Preguntas frecuentes

¿Cuándo debería usar clarify?

Usa clarify siempre que encuentres textos confusos, ambiguos o ineficaces en la interfaz, o cuando quieras mejorar proactivamente la claridad y usabilidad en la comunicación de tu producto.

¿Con qué tipos de textos ayuda clarify?

clarify es efectivo para copy de UX, mensajes de error, microcopy, etiquetas e instrucciones, es decir, cualquier texto de interfaz que afecte la comprensión del usuario.

¿Necesito contexto de diseño antes de usar clarify?

Sí. El flujo de trabajo de clarify requiere que recopiles contexto de diseño y entiendas a tu audiencia antes de hacer cambios. Si no tienes este contexto, sigue los pasos de preparación indicados en SKILL.md.

¿Dónde puedo encontrar más detalles?

Abre la pestaña de Archivos en tu directorio de skills para explorar la estructura completa, incluyendo SKILL.md y cualquier script o referencia de soporte.