clarify

Visión general

¿Qué es clarify?

La skill clarify está diseñada para ayudar a los equipos de UI y UX a identificar y mejorar textos poco claros o confusos en la interfaz. Esto incluye mensajes de error, microcopy, etiquetas e instrucciones que pueden dificultar la comprensión del usuario. Al revisar y reescribir sistemáticamente estos elementos, clarify garantiza que tu producto comunique de forma clara y efectiva con sus usuarios.

¿Quién debería usar clarify?

clarify es ideal para diseñadores de producto, redactores UX, desarrolladores UI y cualquier persona responsable del texto en la interfaz. Si tus usuarios tienen dificultades con etiquetas confusas, instrucciones ambiguas o mensajes de error poco claros, esta skill ofrece un enfoque estructurado para mejorar la claridad y usabilidad.

Problemas que resuelve clarify

• Texto con jerga técnica o poco claro en la interfaz
• Instrucciones ambiguas o engañosas
• Tono o estilo inconsistente en el microcopy
• Mensajes de error que confunden en lugar de ayudar
• Etiquetas y avisos que generan incertidumbre en los usuarios

Cómo usar

Pasos de instalación

1. Instala la skill clarify con el siguiente comando:

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

2. Comienza con el archivo SKILL.md para obtener una visión general del flujo de trabajo y requisitos de clarify.

3. Revisa archivos relacionados como README.md, AGENTS.md y metadata.json para más contexto y detalles de integración.

Guía del flujo de trabajo

• Preparación obligatoria:
  • Antes de hacer cambios, ejecuta /frontend-design para recopilar principios de diseño y contexto. Si no hay contexto de diseño, primero ejecuta /teach-impeccable.
  • Recopila información sobre el nivel técnico de tu audiencia y su estado mental al interactuar con la interfaz.
• Evaluar el texto actual:
  • Identifica problemas como jerga, ambigüedad, voz pasiva, longitud excesiva, suposiciones, falta de contexto o tono inapropiado.
  • Comprende los objetivos, acciones y limitaciones del usuario para cada elemento de la interfaz.
• Planificar y mejorar:
  • Prioriza qué elementos de texto necesitan revisión según el impacto en el usuario.
  • Reescribe el texto para que sea claro, conciso y adecuado para la audiencia y situación.
  • Prueba el texto revisado con usuarios reales cuando sea posible.

Archivos recomendados para revisar

• Comienza con SKILL.md para una visión general del proceso clarify.
• Explora archivos complementarios para una integración más profunda y mejores prácticas.

Preguntas frecuentes

¿Cuándo debería usar la skill clarify?

Usa clarify siempre que notes que los usuarios se confunden con el texto de la interfaz, mensajes de error o instrucciones, o cuando quieras mejorar proactivamente la calidad del texto UX.

¿clarify modifica código o solo texto?

clarify se centra en mejorar el texto de la interfaz y el microcopy. No altera la lógica backend ni el código de la aplicación.

¿Qué preparación se requiere antes de usar clarify?

Debes recopilar contexto de diseño y entender a tu audiencia. Usa /frontend-design y, si es necesario, /teach-impeccable para asegurarte de tener toda la información necesaria antes de editar el texto.

¿Dónde puedo encontrar más detalles sobre el flujo de trabajo de clarify?

Consulta el archivo SKILL.md en el directorio de la skill clarify para una guía completa paso a paso. Para más recursos, revisa la documentación y scripts relacionados en el repositorio.