Communitygithub.com

crowdin/skills

Responde "¿cómo hago X en Crowdin?" mapeando un problema de localización a la solución más barata que Crowdin ya ofrece: una funcionalidad integrada, algunas acciones a través del conector o la API de Crowdin, una aplicación de Crowdin Store o una aplicación personalizada, y entrega el "cómo exacto" al skill que lo posee. Úsalo cuando alguien describe un problema de Crowdin o de localización sin nombrar una herramienta, pregunta si Crowdin puede hacer algo, pregunta qué aplicación de Crowdin usar, o nombra una aplicación de la tienda y quiere saber qué hace o si la necesita.

¿Qué es skills?

Este skill funciona como una **capa de triaje** para problemas de localización, mapeando rápidamente el síntoma del usuario a la solución más directa y barata dentro del ecosistema de Crowdin. Está diseñado para asistentes de IA que trabajan con el conector de Crowdin, ya sea en Cowork, Claude.ai o ChatGPT, así como para desarrolladores en terminal. El skill evalúa el problema en cuatro escalones: primero comprueba si es una **función nativa** que el usuario no conocía (como filtros, controles de calidad o configuraciones); luego, si se puede resolver con **acciones del conector** (filtros, etiquetado masivo, creación de tareas); después, si es necesaria una **aplicación de Crowdin Store**; y por último, si se requiere una **aplicación personalizada**, delegando en el skill `create-app`. El skill describe el problema en términos de objetos de Crowdin (strings, traducciones, TM, glosario, pasos de workflow, controles de calidad, tareas, informes, integraciones), y solo consulta los catálogos en vivo para el escalón que necesita confirmación. Nunca improvisa llamadas a la API ni sintaxis de filtro que pertenezcan a otros skills, sino que entrega el "cómo exacto" al skill correspondiente (`croql`, `graphql`, `crowdin-api-client`, `crowdin-cli`). Su objetivo es ser honesto y preciso: no sobreestimar el escalón 2 para evitar que el usuario haga manualmente lo que una app haría mejor, ni subestimarlo para evitar instalar una app cuando un filtro sería suficiente.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/crowdin/skills/tree/HEAD/skills/how-to-crowdin

Preguntar en tu IA favorita

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

Documentación

Cómo usar Crowdin

Crowdin suele ofrecer varias formas de resolver el mismo problema de localización: un ajuste que el usuario nunca encontró, algunas acciones sobre sus strings, una aplicación de Crowdin Store o algo construido para el trabajo. Alguien que pregunta "¿cómo hago X en Crowdin?" quiere la ruta más corta y honesta hacia X, y saber cuál es esa ruta requiere conocer las cuatro. Este skill es ese conocimiento, organizado como un mapa desde el problema hasta su respuesta.

Eres una capa de triaje, no una capa de ejecución. Decides cuál es la solución correcta en Crowdin para este problema y entregas el "cómo exacto" a quien corresponda: el conector de Crowdin cuando el usuario tiene uno, los skills croql, graphql, crowdin-api-client y crowdin-cli cuando el cómo es una consulta, un script o un comando, el skill create-app cuando nada encaja. Nunca improvisas llamadas a la API ni sintaxis de filtro que pertenezcan a esos skills.

Quién pregunta

Normalmente, un gestor de localización que trabaja a través de un asistente de IA con el conector de Crowdin, en Cowork, Claude.ai o ChatGPT. A veces, un desarrollador en una terminal. Asume que no hay shell hasta que veas una. Cuando una respuesta implica hacer algo, descríbelo como acciones del conector sobre objetos de Crowdin primero, y nombra la ruta de terminal solo como alternativa.

La escalera

Cada respuesta se sitúa en un escalón, y los pruebas empezando por el más barato:

  1. Función nativa que el usuario no conocía. Etiquetas más un filtro, un control de calidad, un paso de workflow, un informe, un ajuste.
  2. Acciones del conector. Una secuencia corta que realizas bajo demanda a través del conector o la API de Crowdin, descrita al nivel de objetos de Crowdin: filtrar strings, añadir una etiqueta, crear una tarea, pretraducir un conjunto, obtener un informe. La misma secuencia se ejecuta como llamadas REST en una terminal, por lo que nunca hay que escribir una segunda versión.
  3. Aplicación de la tienda. Instalada desde store.crowdin.com.
  4. Aplicación personalizada. Nada encaja; delegar en create-app.

La prueba del escalón 2 resuelve la mayoría de las disputas. Un trabajo es del escalón 2 cuando es una lectura, un filtro, una edición masiva o un informe sobre los datos propios de Crowdin, realizado cuando el usuario lo pide. Deja de ser del escalón 2 cuando necesita vigilancia continua (webhooks, programaciones), un sistema externo (un CMS, un repositorio, una herramienta de chat, una herramienta de diseño), un analizador de archivos, una conexión con un proveedor de MT o IA, una interfaz de usuario dentro del editor de Crowdin o un pase de modelo sobre miles de strings que el usuario necesitará la semana que viene. Sé honesto en ambos sentidos: sobreestimar el escalón 2 envía a la gente a hacer manualmente lo que una app haría mejor; subestimarlo empuja a instalar algo cuando un filtro sería suficiente.

Cuando gane el escalón 3 o 4, di en una línea cada uno por qué perdieron los escalones más baratos. Esa línea es lo que le dice al usuario que la respuesta fue sopesada, no adivinada, y es lo que hace que valga la pena pagar por una instalación cuando realmente es la respuesta.

El flujo

  1. Reformular el problema en términos de Crowdin. Los usuarios describen síntomas: "lo alemán está mal", "los traductores ignoran nuestros términos". Nombra los objetos de Crowdin subyacentes antes de responder: strings, traducciones, TM, glosario, paso de workflow, control de calidad, tarea, informe, integración. Hecho cuando puedes expresar el problema en una frase que use esos sustantivos. Haz solo una pregunta aclaratoria cuando dos interpretaciones llegarían a escalones diferentes; en caso contrario, elige la interpretación más probable, di cuál elegiste y responde.
  2. Busca el problema en el mapa de abajo. Un acierto te da el escalón y la entrega. Hecho cuando tienes un escalón y una entrega, o un fallo confirmado.
  3. En caso de fallo, recorre la escalera tú mismo, empezando por el más barato, utilizando la prueba del escalón 2 anterior.
  4. Consulta los catálogos en vivo solo para el escalón que lo necesita. references/catalogs.md dice cómo. Escalón 1 en caso de fallo: el índice de Documentación de Crowdin. Escalón 3: el índice de la tienda, restringido a la categoría correspondiente, luego uno o dos archivos de elementos leídos por completo. Un eslogan preselecciona una aplicación; solo el archivo del elemento la recomienda. Hecho cuando lo que estás a punto de nombrar está confirmado que existe y hace lo que afirmarás.
  5. Entrega el cómo. Las acciones del conector se quedan a nivel de objeto. Cualquier cosa que necesite una expresión CroQL, una consulta de GraphQL, un script o un comando de CLI va al skill propietario por su nombre, para que sea invocado y no reinventado aquí.
  6. Responde con la forma que se indica a continuación.

Forma de la respuesta

Solución primero, en una o dos frases. Luego, lo que le cuesta al usuario: nada, una instalación o una construcción. Luego, los pasos o la entrega. Cuando gane el escalón 3 o 4, una línea por cada escalón más barato rechazado. Cuando la respuesta dependa de la edición del usuario, su plan o lo que ya está habilitado en su proyecto, dilo en lugar de adivinar; los catálogos no pueden ver su cuenta, y tú tampoco sin el conector.

Barreras de seguridad

  • Los cambios masivos requieren un recuento y un "sí" primero. Añadir una etiqueta a muchos strings, aprobar en masa, limpiar una TM, borrar cualquier cosa: nombra cuántos objetos se ven afectados y espera confirmación. Un filtro que coincidió con más de lo que el usuario imaginaba es la forma común en que un asistente daña un proyecto.
  • Solo nombra lo que el catálogo confirme. Cuando la tienda no tenga nada para un problema, dilo y pasa al escalón 4 o a "no es posible actualmente". Una aplicación que no existe es peor que ninguna respuesta.
  • Solo para Enterprise, mantenlo etiquetado. Los flujos de trabajo, proveedores, equipos y grupos existen solo en Crowdin Enterprise. Dilo cuando sean la respuesta, para que un usuario de crowdin.com no busque un menú que no tiene.

El mapa

Cada fila es una familia de problemas: el problema en términos del usuario, el escalón más barato que lo resuelve y qué hacer. "Conector" significa acciones a través del conector o la API de Crowdin, descritas a nivel de objeto. Una fila que nombra una aplicación de la tienda ya ha sopesado sus escalones más baratos, así que confirma la aplicación en el catálogo y di qué añade. Una fila que dice que algo "es una aplicación" marca dónde el escalón más barato deja de ser suficiente.

Encontrar, editar y organizar strings

ProblemaEscalónHaz esto
Qué strings cambiaron o son nuevos desde una fecha o versión1Filtro del editor o CroQL sobre fechas de string; etiqueta el resultado si debe reutilizarse
Etiquetar muchos strings a la vez2Filtrar con CroQL, añadir la etiqueta por lotes; conjuntos pequeños: selección múltiple en el editor
El texto fuente está descuidado antes de llegar a los traductores1Enterprise: paso de workflow de Revisión de texto fuente; en otros casos, Reemplazar en fuentes con Mantener traducciones; una revisión recurrente con ML es una aplicación
Corregir o añadir strings fuente sin perder sus traducciones2Edición masiva de strings con la opción de conservar traducciones; un string: edítalo en el editor
No se detectan strings duplicados1Estrategia de duplicados del proyecto; encontrarlos entre archivos es conector
Los archivos nuevos deben traducirse solo a algunos idiomas2Actualizar los idiomas de destino excluidos de cada archivo; un archivo: configuración del archivo
Dónde se usa este string o término en todos nuestros proyectos2Búsqueda en toda la organización, no listado por proyecto; segmentos de TM por TM
Entregar un subconjunto específico de strings a alguien como tarea2Filtrar, etiquetar, crear una tarea filtrada por esa etiqueta
Las partes interesadas necesitan un subconjunto como hoja de cálculo o documento bilingüe2Filtrar, listar traducciones por idioma, escribir el archivo localmente; archivo completo: descargar traducciones
Se colaron datos personales en los archivos enviados para traducción2CroQL sobre texto fuente para patrones de correo electrónico y teléfono, etiquetar coincidencias; bloquear en la importación es una aplicación
Las oraciones se segmentaron incorrectamente al importar1Opción de importación de segmentación personalizada (SRX); reimportar archivos existentes es conector; la creación de reglas es una aplicación
Los archivos no se importan o exportan limpiamente1Configuración del analizador y opciones de importación primero; la reescritura de contenido en el pipeline es una aplicación
Las claves difieren solo por convención de nomenclatura entre plataformas3Tienda: Converter para convenciones de claves; nada nativo normaliza claves

Contexto para traductores

ProblemaEscalónHaz esto
Los traductores no pueden ver la pantalla en la que vive un string1Capturas de pantalla con etiquetado automático; subirlas y etiquetarlas en su nombre es conector; las inserciones de diseño en vivo son aplicaciones
Los traductores de páginas web o documentos no pueden ver el resultado renderizado1Localización en contexto y la vista previa de documentos del editor; la sincronización de video es una aplicación
Nadie escribió contexto y los traductores adivinan2Listar strings con contexto vacío, derivar significado del código base, editar contexto por lotes; en una terminal, crowdin-context-cli más context-extraction
Qué strings carecen de suficiente contexto para traducirse correctamente2Cobertura: filtrar contexto vacío por archivo e informar; la suficiencia juzgada por un modelo a escala es una aplicación
La hoja de cálculo tiene columnas de contexto que Crowdin ignora al importar2Después de importar, editar el contexto de los strings por lotes desde la hoja original; en cada importación es una aplicación
El material de referencia vive en otras herramientas1La descripción del proyecto y el contexto del archivo llevan enlaces; renderizar un tablero dentro de Crowdin es una aplicación
Los plurales ICU, JSON o entidades dentro de los strings estorban1Los controles de calidad de ICU y etiquetas detectan salidas rotas; los ayudantes por string en el editor son aplicaciones

Calidad

ProblemaEscalónHaz esto
Las traducciones son descuidadas: puntuación, mayúsculas, espaciado, ortografía1Activar los controles de calidad nativos en la configuración del proyecto; una limpieza de las traducciones existentes es conector
Números, colores, atajos, emojis o secuencias de escape se perdieron o alteraron1Controles nativos de Variables, Etiquetas, Caracteres especiales; otras clases de tokens: una auditoría puntual es conector, el marcado en vivo es un control de calidad de la tienda (Enterprise)
URLs, correos electrónicos, fechas o unidades se copiaron en lugar de localizarse2Auditar y corregir en masa las traducciones de un idioma después de la revisión; la aplicación en vivo por idioma es un control de calidad de la tienda
La traducción no encaja en su elemento de interfaz o en el tiempo de los subtítulos1Longitud máxima por string y el control de Longitud; un presupuesto de caracteres por archivo completo es conector; caracteres por segundo es un control de calidad
Los problemas de calidad se acumulan y no se pueden triar2Listar problemas de calidad por idioma, agrupar por tipo, añadir falsos positivos al diccionario del proyecto en un solo lote
La misma fuente se traduce de forma diferente en todo el proyecto2Informar grupos de misma fuente, destino diferente por idioma; las pistas de consistencia en el editor existen de forma nativa para un conjunto limitado de idiomas
Errores de ortografía o gramática específicos de una configuración regional se cuelan1Corrector ortográfico nativo, o un proveedor de corrección ortográfica en la configuración de la organización; el control de calidad de convenciones regionales mientras escribes es una aplicación
Lenguaje ofensivo o contrario a la política en las traducciones1Control de calidad personalizado con una lista de palabras (Enterprise); un modelo que juzgue cada nueva traducción es una aplicación
No puedo verificar un idioma que no hablo2Retrotraducir o explicar una muestra limitada bajo demanda; cada exportación retrotraducida es una aplicación
La revisión humana es el cuello de botella1Paso de workflow de revisión y tareas; un lote de revisión limitado es conector; revisar cada nueva traducción con IA es una aplicación
No puedo ver lo que cambiaron los revisores1Informe de Precisión del traductor por traductor; un antes y después por string es conector; las eliminaciones están en la Actividad del proyecto
Puntuar la calidad de la traducción según un modelo LQA3Tienda: Linguistic Quality Assurance (Enterprise); la anotación vive en el editor
Se sospecha que las traducciones se pegaron desde una herramienta de IA3Informes de detección de IA de la tienda; la procedencia (quién o qué motor produjo una traducción) es conector
Verificar las traducciones según nuestras propias reglas o tono2Verificar un archivo o idioma puntualmente bajo demanda; de forma global y repetible es una aplicación
Qué traducciones de MT o IA son seguras para enviar sin un humano3Aplicaciones de estimación de calidad de la tienda; el triaje básico (tarea para traducciones solo de MT) es conector

Terminología, TM y estilo

ProblemaEscalónHaz esto
El glosario está vacío o es escaso2glossary-generation desde una terminal; a través del conector, proponer términos a partir de strings fuente y añadir después de revisar
Los desarrolladores quieren que los strings que acaban de añadir se traduzcan ahora, de forma coherente con nuestro glosario y TM2translate desde una terminal: borradores en los archivos de recursos locales, subir como sugerencias no aprobadas; el trabajo masivo es pretraducción (crowdin-cli)
El glosario tiene términos fuente pero no traducciones2Exportar el glosario, subirlo como archivo fuente para traducir, importar de vuelta
Es necesario añadir o corregir términos mientras la traducción está en curso2Encontrar el concepto, añadir o actualizar el término; los traductores que lo hagan en línea necesitan la aplicación del editor
No hay guía de estilo, por lo que el tono y el formato se desvían2Inferir reglas a partir de traducciones aprobadas, escribir la Guía de estilo nativa con instrucciones de IA
Las traducciones quedaron desactualizadas después de un cambio en el glosario o la guía de estilo1Renombrar términos conocidos: Reemplazar en traducciones, o CroQL más una etiqueta cuando cada uno necesite revisión; una regla de estilo o una vigilancia continua es una aplicación
La MT o la IA ignoran nuestro glosario y TM1Los prompts de IA nativos ya reciben glosario, TM y strings hermanos; DeepL respeta los glosarios de DeepL; sincronizar términos en DeepL es una aplicación
Cada proyecto genera su propio TM y glosario1Asignar el TM y glosario compartidos en la configuración del proyecto; fusionar los dispersos es conector; la creación automática al crear un proyecto es una aplicación
El TM está inflado con duplicados3Tienda: TM Cleaner (mantiene una copia de seguridad); un TM pequeño se puede deduplicar mediante conector después de una exportación
Necesito una porción filtrada del TM, no la exportación completa2CroQL sobre registros de TM (fechas, uso, autor), escribir CSV; sin filtrar: descarga nativa de TM
Las traducciones terminadas no están en un TM que otro proyecto pueda usar1Un TM asignado a varios proyectos; un TM de un subconjunto de archivos es conector
Los documentos traducidos heredados o TMX no están intactos en el TM1Carga nativa de TM para TMX, XLSX, CSV; alinear pares de documentos o preservar el contexto anterior/siguiente es una aplicación
Los traductores quieren diccionarios externos en el editor1Importar la base de términos como glosario y se muestra de forma nativa; los corpus externos en vivo son aplicaciones
La IA sigue repitiendo errores que los traductores ya corrigieron1Enterprise: AI Alignment redacta términos del glosario a partir de traducciones humanas; en otros casos, comparar la salida de la IA con las aprobadas

Skills relacionados