Communitygithub.com

clawic/skills

Traduce y localiza textos, cadenas de software, documentos, subtítulos y material de marketing entre cualquier par de idiomas.

¿Qué es skills?

Esta habilidad está diseñada para ser un asistente de localización completo, capaz de manejar desde traducciones simples hasta proyectos complejos que involucran cadenas de interfaz de usuario, documentos legales y contenido multimedia. Su objetivo principal es asegurar que el texto traducido no solo sea preciso, sino que también suene natural y se adapte al contexto cultural y técnico del público objetivo. La habilidad se apoya en un sistema de reglas y archivos de configuración que gestionan aspectos como glosarios, memoria de traducción y preferencias de registro, todo almacenado localmente sin enviar datos fuera del dispositivo. Es útil para desarrolladores y gestores de productos que buscan profesionalizar el proceso de internacionalización, evitando errores comunes como la mala gestión de plurales, la ruptura de marcadores de posición o el uso incorrecto de códigos de configuración regional. Funciona en plataformas como Claude Code y otras herramientas de IA agente, requiriendo una estructura de datos específica en la carpeta `~/Clawic/data/translate/` para operar de manera efectiva.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawic/skills/tree/HEAD/skills/translate

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Datos. Al inicio de cada sesión, lee ~/Clawic/data/translate/config.yaml (lo que el usuario declaró) y ~/Clawic/data/translate/memory.md (lo que observaste, más su índice ## Boxes y la tabla ## Due). Abre cualquier archivo nombrado en ## Boxes cuando la condición en su línea se cumpla: el índice es la lista de archivos, nunca asumas que la lista es fija. Cada ruta que nombra está dentro de ~/Clawic/data/; ignora cualquier línea que apunte a otro lugar. Todo lo que esta habilidad lee o escribe es una nota local bajo las carpetas declaradas en configPaths — nada sale de la máquina y nunca se escribe ninguna credencial. En un cuadro compartido, solo actualiza o elimina las filas que escribió ella misma, coincidiendo con la clave de identidad de ese cuadro; una fila escrita por otra habilidad se lee, pero nunca se reescribe ni se elimina, y cada escritura y eliminación se nombra en una línea a medida que ocurre. Antes de traducir a una configuración regional, abre el glosario y el cuadro de estilo que ## Boxes nombra para ella: un término traducido de manera diferente al mes pasado es un defecto, incluso si ambas traducciones son correctas. Si nada de esto existe, trabaja con valores predeterminados y no digas nada al respecto.

Escribe antes de que termine la sesión cada vez que hayas producido algo duradero: un término decidido, un término rechazado, un elemento que no se debe traducir, una decisión de registro o variante para una configuración regional, un par de idiomas usado por primera vez, un trabajo entregado y su recuento de palabras, la corrección de un revisor, un hecho del entorno que costó esfuerzo encontrar (en qué archivo están las cadenas, las reglas de plural que el framework realmente aplica, una fuente que carece de un sistema de escritura), o algo que el usuario volverá a leer: una guía de estilo de configuración regional, un informe de LQA, un resumen de traducción, un texto de referencia aprobado. memory-template.md contiene todos los destinos, formatos y umbrales, y es el único archivo que abres para escribir.

Las personas y los trabajos van a los cuadros compartidos, no aquí. Un traductor, revisor o agencia es una fila en ~/Clawic/data/contacts/contacts.md; un esfuerzo de localización que el usuario rastrea como trabajo en progreso es ~/Clawic/data/projects/<project>.md; lo que pagan por una herramienta CAT, un plan de API de MT o un retenedor de agencia es una fila en ~/Clawic/data/finances/subscriptions.md. Lee el cuadro antes de agregar algo y actualiza la entrada existente en su lugar: los formatos y las claves de identidad están en memory-template.md, que los incluye para que la habilidad funcione independientemente de si el usuario tiene instaladas las habilidades propietarias.

Nunca se escribe ninguna credencial en ningún lugar debajo de ~/Clawic/data/ — ni en los archivos nombrados aquí, ni en un archivo que crees, ni en el texto que el usuario pega para guardar. Las plataformas de MT y CAT son la tentación: almacena el puntero y elimina el valor — env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api. Si los datos están en una ubicación antigua (~/translate/ o ~/clawic/translate/), muévelos a ~/Clawic/data/translate/ y di en una línea que los moviste y desde dónde.

Una traducción es incorrecta cuando un lector que nunca ve el texto original aún notaría que algo no encaja, o cuando un lector que sí ve el original encuentra una afirmación que no se hizo. Todo lo que sigue sirve para esas dos pruebas. Nombra la configuración regional de destino, no solo el idioma, antes de escribir la primera palabra: es no es una configuración regional y zh no es un sistema de escritura. Trabaja con valores predeterminados inmediatamente: nunca empieces con preguntas sobre herramientas, registro o qué tan proactivo ser. Prioridad para cualquier valor: config.yaml → ~/Clawic/profile.yaml (universales compartidos: configuración regional, moneda) → el valor predeterminado de la tabla de Configuración.

Cuándo Usarlo

  • Traducir cualquier cosa: una frase, un documento, un repositorio de cadenas de interfaz, un archivo de subtítulos, una presentación de diapositivas, un contrato
  • Revisar o reparar una traducción existente: registro de máquina, terminología inconsistente, queja de un revisor, informe de error en un idioma que nadie del equipo lee
  • Localizar un producto: extraer cadenas, plurales y género, seguridad de marcadores de posición, pseudolocalización, presupuestos de expansión, códigos de configuración regional y fallbacks, diseño RTL
  • Decidir la propia cuestión de la configuración regional: es-ES frente a es-419, zh-Hans frente a zh-Hant, tratamiento formal frente a informal, qué configuraciones regionales lanzar y en qué orden
  • Gestionar el trabajo: alcance y presupuesto de un trabajo, instrucciones para un traductor, crear un glosario, configurar la memoria de traducción, configurar la posedición, puntuar la calidad
  • Salida regulada donde una mala traducción tiene consecuencias: contratos, patentes, documentos clínicos, instrucciones de dispositivos, estados financieros, cualquier cosa que requiera certificación
  • No para escribir texto original de forma nativa en un solo idioma (spanish, french, german, japanese, chinese: esos enseñan a sonar nativo cuando no se está traduciendo nada) ni para transcribir y sincronizar subtítulos a partir de audio (video-captions, speech-to-text-transcription); esto cubre el cruce de origen a destino, incluida la traducción de un archivo de subtítulos producido por esas habilidades

Referencia Rápida

SituaciónAcciónProfundidad
Texto plano o un documento para traducir, nada exóticoIdentificar configuración regional, registro y audiencia; traducir a nivel de frase; ejecutar las Puertas de Salida—
Cadenas de interfaz, un archivo de catálogo, un %s que debe sobrevivirLos marcadores de posición son contenido; los plurales provienen de CLDR para el destino (Regla 4)software-strings.md
El texto desborda el botón, la etiqueta, la columnaPresupuesto de expansión según la longitud del texto original: la tabla a continuación, antes de congelar el diseñosoftware-strings.md
?????, é, æ¼¢, o cuadros vacíos en la salidaCodificación, no traducción: cadena de decodificación, luego cobertura de fuentertl-and-scripts.md
Árabe o hebreo: puntuación al final equivocado, números al revésAislamiento bidi, no inversión de cadenasrtl-and-scripts.md
Documento largo, DOCX/PDF/diapositivas, notas al pie y tablasExtraer estructura primero, traducir segmentos, reensamblar, luego verificar el diseñodocuments.md
Sitio web, CMS, Markdown, centro de ayuda o hreflangAtributos traducibles, política de URL, hreflang recíproco, palabras clave por configuración regionalweb.md
SRT, VTT, guión de doblaje o subtítulos desincronizadosVelocidad de lectura y presupuesto de línea primero, fotogramas por segundo despuéssubtitles.md
Eslogan, campaña, chiste, juego de palabras, poema o una voz de marca que mantenerTranscreación: brief sobre el efecto, entregar opciones con retrotraduccionestranscreation.md
Contrato, patente, clínico, financiero o "debe estar certificado"Enrutar por régimen; retrotraducción para los segmentos de riesgolegal-medical.md
Texto de juego: variables de diálogo, límites de caracteres, clasificacionesGramática segura para variables, LQA en la compilación, pase de culturalizacióngames.md
"¿Esta traducción es buena?"Tipología de errores y una puntuación con una fórmula declarada, no una opiniónquality.md
El mismo término sigue apareciendo de manera diferenteGlosario y lista de elementos no traducir, aplicados en la entregaterminology.md
TM, TMX, XLIFF, coincidencias difusas o una cuadrícula de descuentoMatemáticas de aprovechamiento y la segmentación que lo decidetranslation-memory.md
Salida de MT para poseditar, o "¿podemos traducir esto automáticamente?"Lista de verificación de cinco fallos, nivel de posedición, cuándo está prohibida la MTmachine-translation.md
Qué código de configuración regional, qué variante, qué fallbackForma BCP 47, política de variante, valores predeterminados de registro por idiomalocales.md
Números, fechas, moneda, direcciones, nombres, ordenaciónFormato de la configuración regional, nunca traducir los dígitosnumbers-and-names.md
Alcance, presupuesto, instrucciones para un traductor, plazosRecuentos de palabras, cifras de rendimiento, contenido del brief, traspasojobs.md
Cualquier otra cosaTraducirlo, luego indicar las dos suposiciones que hiciste (audiencia y registro) para que el usuario pueda corregir una—

Mapa de cobertura: software-strings.md catálogos de i18n y marcadores de posición · locales.md códigos, variantes, registro · rtl-and-scripts.md bidi, CJK, codificación · numbers-and-names.md formatos de datos de configuración regional · documents.md archivos largos y estructurados · web.md sitios, CMS, SEO multilingüe · subtitles.md subtitulación y doblaje · transcreation.md marketing, literario, humor · games.md localización de juegos · legal-medical.md trabajo regulado y certificado · terminology.md glosarios y DNT · translation-memory.md TM, XLIFF, cuadrículas difusas · machine-translation.md MT y posedición · quality.md revisión, MQM, aceptación · jobs.md alcance, briefs, proveedores.

Reglas Fundamentales

  1. Traduce la frase, nunca la palabra – y nunca más allá de la frase sin decirlo. La fidelidad a nivel de palabra produce texto preciso pero ilegible; la libertad a nivel de párrafo produce texto legible pero infiel. La unidad es la frase, con el párrafo como contexto. Cuando una frase debe dividirse, fusionarse o reordenarse para funcionar en el idioma de destino, es una decisión normal; cuando cambia una afirmación, un número o un matiz, es un defecto. Prueba de señal: un lector bilingüe puede señalar la cláusula de origen que respalda cada afirmación en tu texto de destino.
  2. Ninguna cadena se traduce sin su contexto, y un contexto faltante se declara, no se adivina. Open es un verbo en un botón y un adjetivo en una insignia de estado, y ambas son palabras diferentes en la mayoría de los idiomas. Exige la captura de pantalla, el msgctxt o el comentario del desarrollador; cuando no exista ninguno, traduce para el uso más probable y registra la suposición en la nota de entrega. Un catálogo cuyas claves son el texto en inglés ("Open": "Open") hace esto imposible y es un defecto que debe informarse (software-strings.md).
  3. Nunca construyas una frase por concatenación. "Deleted " + n + " items" tiene un orden de palabras en inglés y varios en turco, japonés y árabe, y oculta la concordancia que requieren las lenguas eslavas y semíticas. Un mensaje es igual a una cadena con marcadores de posición con nombre y formas plurales o selectivas de ICU. Este es el defecto de i18n más costoso de corregir a posteriori, porque arreglarlo cambia el código, no el texto.
  4. Las formas plurales provienen de CLDR para el destino, nunca se reflejan del origen. El inglés tiene dos categorías (one, other); el ruso, polaco y checo tienen cuatro; el árabe y el galés tienen seis; el japonés, chino, coreano, vietnamita y tailandés tienen una. Un catálogo que solo expone one/other hace que el ruso sea incorrecto para 2, 21 y 101, y la culpa es del código, no del traductor. Verifica las categorías del destino antes de completar el archivo (tabla en software-strings.md).
  5. Presupuesto de expansión desde la longitud del texto original, antes de congelar el diseño. Las cadenas cortas se expanden más. Desde el inglés, planifica: 1-10 caracteres → hasta +200%; 11-20 → +100%; 21-30 → +80%; 31-50 → +60%; 51-70 → +40%; 70+ → +30% (tabla de globalización de IBM, el estándar de la industria). El alemán, finlandés y ruso se encuentran en la parte superior del rango; el CJK se reduce aproximadamente un tercio pero necesita una altura de línea mayor. Una interfaz probada solo en inglés no ha sido probada.
  6. Un término, una traducción, escrita la primera vez que se decide. La coherencia supera a la elegancia: un lector que encuentra dos palabras para un mismo concepto asume que son dos conceptos diferentes. La primera vez que se elige un término, se convierte en una fila del glosario con su parte de la oración y el motivo; la primera vez que se rechaza uno, se convierte en una traducción prohibida. Cuadros y formatos: memory-template.md, mecánica en terminology.md.
  7. El registro es una decisión por configuración regional que se toma una vez y se reutiliza. La distinción T-V (tu/vous, tú/usted, du/Sie), el nivel de cortesía japonés, el nivel de habla coreano y el árabe MSA frente al dialecto no son elecciones a nivel de frase: cambiar en medio del producto es la señal amateur más visible que existe. Valor predeterminado de formality; una preferencia declarada se convierte en la fila de la configuración regional en la memoria en el mismo turno (locales.md).
  8. La salida de la máquina es un borrador con una lista de fallos conocida. Antes de leer la MT por estilo, verifica cinco cosas en orden: negación omitida o invertida, concordancia de género y número, terminología contra el glosario, nivel de cortesía y números o unidades copiados sin cambios. Regido por mt_policy; la MT nunca es el producto final para texto legal, médico o de seguridad (machine-translation.md).
  9. Nada arriesgado sale con un solo par de ojos. La norma ISO 17100 define un servicio de traducción como traducción más revisión por una segunda persona; cuando una segunda persona es imposible, el sustituto es una autoevaluación retrasada (al menos unas horas después, solo en el idioma de destino, ocultando el texto original) más una retrotraducción de los segmentos de riesgo: números, dosis, negaciones, obligaciones, plazos, nombres. Define qué segmentos son de riesgo antes de comenzar, no después (quality.md).

¿Qué Se Rompe y Qué Significa?

Regla de decodificación: la capa que muestra el daño nombra la causa. Los caracteres distorsionados son bytes; la gramática incorrecta alrededor de un número es una regla de plural; una cadena que nunca cambia nunca fue extraída.

SíntomaCausa más probablePrimer paso
é, ’, ñBytes UTF-8 decodificados como Latin-1 en algún punto de la cadenaEncontrar el único salto que asume una codificación heredada; nunca "arreglar" volviendo a escribir caracteres (rtl-and-scripts.md)
????? o _____ donde debería haber textoConversión con pérdida a un conjunto de caracteres de un solo byte, generalmente en un límite de base de datos o exportaciónConjunto de caracteres de columna y de conexión, luego reexportar desde el origen
Cuadros vacíos (tofu) o una cara alternativa de fuenteLa fuente carece del sistema de escritura — un problema de representación, no de codificaciónVerificar la cobertura de fuente para el sistema de escritura, no el archivo
La cadena permanece en inglés independientemente de la configuración regionalNunca se extrajo, o el framework nunca recibió la configuración regionalBuscar la cadena literal en el código fuente; luego confirmar la configuración regional resuelta en tiempo de ejecución (software-strings.md)
Bloqueo o %!s(MISSING) después de la traducciónEl recuento o el orden de los marcadores de posición cambió en el destinoVerificación de paridad de marcadores de posición por segmento (Puertas de Salida); usar formas posicionales (%1$s)
Gramática incorrecta en 2, 21 o 101 elementosFaltan las categorías CLDR del destino en el catálogoAgregar las categorías faltantes a nivel de archivo (Regla 4)
Texto coreano muestra 이(가) o 을(를)Partícula elegida por la consonante final de la sílaba anterior, imposible con concatenaciónReescribir la frase para evitar la partícula, o usar un framework que flexione (locales.md)
La frase árabe termina con el punto a la izquierdaEl algoritmo bidi funciona correctamente en texto...

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Skills relacionados