ux-writing-es Skill
检查并改写中性西班牙语(使用 tú 称谓)的界面文案——按钮、错误提示、空状态、表单、确认框和通知——检测 voseo 用法、vosotros 形式、残留英文、标题式大写、缺失的开头问号/感叹号以及无描述性链接。当用户要求审查文案或微文案、表单或页面文本、统一语言风格,或在发布新文案前使用。
安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。
技能指令原文(SKILL.md)
UX writing en español (tuteo neutro)
Escribes para personas de toda Latinoamérica: **tú (nunca voseo ni usted); nada de vosotros ni
regionalismos marcados**. Texto claro, corto y útil. La guía completa con ejemplos está en
guia-de-voz.md: léela antes de reescribir.
Si el CLAUDE.md del proyecto define otra voz (usted, un país específico, un glosario), **manda
el CLAUDE.md**.
1. Detecta lo mecánico
node ${CLAUDE_SKILL_DIR}/scripts/revisar-texto.mjs <archivos o carpeta>
Encuentra voseo (podés, ingresá, registrate), vosotros (podéis), usted suelto, inglés
residual (Submit, Learn more, loguearte), mayúsculas de título («Crea Tu Cuenta Gratis»),
preguntas o exclamaciones sin ¿ ¡, enlaces «aquí» y regionalismos. Los errores son
seguros; los avisos son hipótesis: revísalos uno por uno (por ejemplo, «escribí» puede ser
pasado y estar bien).
2. Revisa lo que importa (eso no lo ve el script)
Recorre los textos de la pantalla o del flujo y aplica, en este orden:
- ¿Se entiende a la primera? Una idea por frase. Palabras de la persona, no del sistema
(«No pudimos guardar tus cambios», no «Error 500 al persistir la entidad»).
- Botones: dicen la acción con un verbo y, si hace falta, el objeto: «Guardar cambios»,
«Crear cuenta», «Enviar solicitud». Nunca «Aceptar» o «Sí» cuando la acción es otra. Mismo
verbo en el botón y en el título del diálogo.
- Errores: qué pasó + cómo seguir, sin culpar: «La contraseña necesita al menos 8
caracteres». Junto al campo, no solo arriba.
- Estados vacíos: qué es esta pantalla + qué hacer ahora + un botón para hacerlo.
- Acciones destructivas: nombra lo que se pierde: «¿Eliminar el proyecto “Rediseño”? No se
puede deshacer.» Botón: «Eliminar proyecto».
- Formularios: label visible y corto; ayuda debajo si hace falta; el placeholder no
reemplaza al label; marca lo opcional, no lo obligatorio (si casi todo es obligatorio).
- Consistencia: un término por concepto en todo el producto. Si el proyecto tiene glosario
en el CLAUDE.md, úsalo; si no, propone uno con los términos que encuentres.
- Inclusivo sin trabas: «Te damos la bienvenida» en vez de «Bienvenido/a»; «las personas
usuarias» o reformular («quienes usan…») en vez de «los usuarios» cuando importa.
- Formato: mayúscula solo al inicio y en nombres propios;
¿?y¡!; números y fechas en
el formato del país del público (si es toda Latinoamérica, evita ambigüedades: «3 de marzo»,
no «03/03»).
3. Propón cambios
Tabla corta, de lo más grave a lo menos:
| Dónde (archivo:línea) | Ahora | Propuesta | Por qué |
|---|---|---|---|
- No reescribas por gusto: cada cambio tiene un «por qué» de esta guía.
- Pregunta antes de cambiar el tono de marca, nombres de producto o textos legales.
- Si la persona aprueba (o pidió corregir directamente), aplica los cambios y vuelve a correr el
script: debe quedar en 0 errores.
Nunca
- Mezclar tú y usted en el mismo producto.
- Traducir literal del inglés («Hacer clic aquí para aprender más»).
- Usar emojis en textos de interfaz salvo que el sistema de marca lo defina.