La localización se está convirtiendo en un Skill de agente, no en un SDK

Localizar una app solía significar añadir un SDK, conectar un provider y gestionar claves a mano. Con los agentes de codificación con IA hay un camino más corto: instalas un Skill y el agente hace las conexiones. globalize.now es infraestructura de localización impulsada por IA que se distribuye como Skill de agente abierto. Ejecutas un comando, tu agente lee el playbook y tu codebase obtiene una estructura lista para traducir sin que tengas que mantener nuevas tuberías.

¿Qué es un Skill de agente?

Un Skill de agente es un paquete pequeño de instrucciones que un agente de codificación lee y ejecuta. Se distribuye a través del ecosistema abierto de Skills y se instala con la CLI de Skills, por ejemplo npx skills add owner/repo. El mismo comando funciona en Claude Code, Cursor, Codex, OpenCode y más de cincuenta agentes más.

El Skill en sí es un archivo SKILL.md más los archivos de apoyo que haga falta, y se coloca en el directorio donde tu agente ya busca. La CLI lo enlaza a una única copia canónica y registra la instalación en un lockfile, así que un Skill queda versionado junto al resto de tu proyecto en lugar de vivir en la cuenta de un proveedor. Incluso hay un registro público, así que un Skill es algo que puedes encontrar, leer y fijar como cualquier otra dependencia.

El cambio que merece la pena notar: un Skill no es un producto con el que tu agente se integra. Es conocimiento que tu agente absorbe y luego aplica a tu código. Esa diferencia se nota en el momento en que incorporas a un compañero de equipo. Clona el repo, el Skill ya está ahí, y su agente gestiona tu localización igual que lo hace el tuyo.

¿Por qué distribuir i18n como Skill en lugar de como SDK?

Porque la parte difícil de la internacionalización es el refactor, y un Skill le enseña a tu agente a hacerlo por ti. Un SDK da por hecho que tu código ya está estructurado para traducirse. Sigues teniendo que encontrar las cadenas codificadas, diseñar un esquema de claves, crear archivos de traducción y conectar la biblioteca en tiempo de ejecución.

Las apps generadas por IA empeoran esto, porque los agentes de codificación optimizan para tener una pantalla funcionando, no para una arquitectura pensada para traducir. El resultado suele ser correcto y desplegable, y está lleno de cadenas como <button>Submit order</button> en lugar de una llamada con clave. Multiplica eso por todo un proyecto y el trabajo de localización deja de ser un cambio de configuración para convertirse en un refactor.

Dejado a su suerte, el problema se acumula. La misma etiqueta se escribe de tres formas ligeramente distintas, los contadores se renderizan como 1 messages, y la primera vez que añades un idioma te encuentras con pantallas mitad en inglés y mitad no. Un Skill está pensado para detectar todo eso de una sola pasada, antes de que se convierta en cien tickets pequeños.

Un Skill codifica ese refactor como instrucciones que tu agente puede ejecutar. Detecta tu framework, confirma el runtime de i18n que ya usas, como next-intl o i18next, extrae las cadenas en inglés y genera claves y archivos de traducción. No estás importando un nuevo runtime que versionar y mantener. El Skill hace la configuración y luego se aparta.

¿En qué se diferencia un Skill de un servidor MCP?

Un servidor MCP es un servicio al que tu agente llama; un Skill son solo archivos en tu proyecto. El Model Context Protocol es una buena forma de dar a los agentes herramientas y datos en vivo a través de un servidor en ejecución. Pero un servidor es algo que tú o un proveedor tiene que alojar, y tu agente depende de que sea accesible.

Un Skill no tiene ningún servicio detrás. Es texto y código que se distribuye en tu repositorio, funciona sin necesidad de red y aparece en un pull request como cualquier otro cambio. Para un trabajo de configuración puntual, como internacionalizar un codebase, los archivos ganan a un servicio que hay que mantener con vida. Lees lo que va a hacer el Skill, lo ejecutas y revisas el diff.

Los Skills también se combinan. Puedes instalar varios y conviven sin problema, porque cada uno es solo instrucciones, no otro proceso que ejecutar y pagar.

¿Cómo se instala globalize.now como Skill de agente?

Un solo comando, y a partir de ahí se encarga tu agente.

npx skills add globalize-now/globalize-skills --all

El flag --all instala todos los Skills para todos los agentes en tu máquina, la opción segura por defecto si no estás seguro de qué agente usas. La CLI coloca el Skill de globalize.now donde tu agente busca los Skills. Funciona con el agente que ya usas, incluidos Claude Code y Cursor.

A partir de ahí, le pides a tu agente que configure i18n, y sigue el playbook: detecta el framework, confirma la biblioteca en tiempo de ejecución, encuentra las cadenas en inglés de cara al usuario y genera claves y archivos de traducción. El antes y el después es la parte que los desarrolladores reconocen.

// before
<button>Submit order</button>

// after
<button>{t("checkout.submit_order")}</button>

Las claves acaban en archivos de traducción que el Skill crea y mantiene por ti:

/locales
  en.json
  de.json
  es.json
  fr.json

Tu archivo en inglés se rellena con las cadenas que encontró el agente. Los demás idiomas se generan y se mantienen al día en cada push, así que añadir un mercado es un archivo de traducción, no un sprint.

Tras la configuración inicial, las traducciones se sincronizan en cada push a Git. No exportas nada, y no hay ninguna cola que vaciar. Si estás haciendo vibe coding de tu app, esto es todo el trabajo. Si eres un desarrollador que quiere los detalles, el mismo Skill ejecuta el refactor de forma limpia y te deja con archivos de traducción estándar.

¿Mis traducciones se quedan en mi repo?

Sí. Los archivos de traducción que genera el Skill se hacen commit en tu repositorio como cualquier otro archivo fuente. Esta es la parte que más importa respecto al lock-in.

Algunos enfoques mueven tus cadenas traducidas a un paso de build o a un panel alojado, así que el día que te vas, tu capa de traducción se va contigo. Con archivos de traducción nativos del repo, tu en.json, de.json y el resto son archivos normales dentro de tu proyecto. El Skill podría desaparecer mañana y tu app seguiría desplegando cada idioma que ya tiene. Irte es tan simple como no volver a instalar el Skill, sin nada que migrar, porque nada de lo tuyo estuvo nunca en otro sitio. Por eso globalize.now se sitúa en la capa de infraestructura de tu stack, generando las claves y los archivos de traducción, en lugar de envolver tu app por fuera.

¿El modelo de Skill te ata a un proveedor?

No, y evitar ese lock-in es justo la razón para preferirlo. El Skill se instala desde un registro abierto que cualquier agente compatible puede leer, no desde una tienda de plugins cerrada. El resultado son archivos de traducción estándar para la biblioteca en tiempo de ejecución que ya elegiste, no un formato propietario que luego tendrías que desmontar.

Puedes leer exactamente lo que hace el Skill antes de ejecutarlo, porque son solo archivos. Si quieres el recorrido completo en lugar del argumento, la guía cómo localizar una app generada por IA cubre la misma configuración de principio a fin.