i18n y Localización
Resumen
Esta copia de admisión pública empaqueta plugins/antigravity-awesome-skills-claude/skills/i18n-localization de https://github.com/sickn33/antigravity-awesome-skills en la forma editorial nativa de Omni Skills sin ocultar su origen.
Úsala cuando el operador necesite que el flujo de trabajo ascendente, los archivos de soporte y el contexto del repositorio permanezcan intactos mientras el validador público y el mejorador privado continúan su flujo descendente normal.
Esta admisión mantiene intactos los archivos ascendentes copiados y utiliza el bloque external_source en metadata.json junto con ORIGIN.md como ancla de procedencia para la revisión.
i18n y Localización > Prácticas recomendadas de Internacionalización (i18n) y Localización (L10n). ---
Las secciones de origen importadas que no se asignaron limpiamente a los encabezados públicos aún se conservan a continuación o en los archivos de soporte. Secciones importadas notables: 1. Conceptos Clave, 3. Patrones de Implementación, 4. Estructura de Archivos, 6. Problemas Comunes, 7. Soporte RTL, 8. Lista de Verificación.
Cuándo Usar Esta Habilidad
Usa esta sección como filtro de activación. Debe hacer explícito el límite de activación antes de que el operador cargue archivos, ejecute comandos o abra una solicitud de extracción.
- Tipo de Proyecto - ¿i18n Necesario?
- Aplicación web pública - ✅ Sí
- Producto SaaS - ✅ Sí
- Herramienta interna - ⚠️ Quizás
- Aplicación monoregión - ⚠️ Considerar futuro
- Proyecto personal - ❌ Opcional
Tabla de Operación
| Situación | Comenzar aquí | Por qué es importante |
|---|---|---|
| Primer uso | metadata.json | Confirma repositorio, rama, commit y ruta importada a través del bloque external_source antes de tocar el flujo de trabajo copiado |
| Revisión de procedencia | ORIGIN.md | Proporciona a los revisores un rastro de auditoría en lenguaje sencillo para la fuente importada |
| Ejecución del flujo de trabajo | scripts/i18n_checker.py | Comienza con el archivo copiado más pequeño que cambia materialmente la ejecución |
| Contexto de soporte | scripts/i18n_checker.py | Agrega el siguiente archivo fuente copiado más relevante sin cargar todo el paquete |
| Decisión de transferencia | ## Habilidades Relacionadas | Ayuda al operador a cambiar a una habilidad nativa más sólida cuando la tarea se desvía |
Flujo de Trabajo
Este flujo de trabajo es intencionalmente editorial y operativo al mismo tiempo. Mantiene la fuente importada útil para el operador mientras cumple con los estándares de admisión pública que alimentan el flujo del mejorador descendente.
- Confirmar el objetivo del usuario, el alcance del flujo de trabajo importado y si esta habilidad sigue siendo el enrutador correcto para la tarea.
- Leer los archivos de resumen y procedencia antes de cargar cualquier archivo de soporte ascendente copiado.
- Cargar solo las referencias, ejemplos, indicaciones o scripts que cambien materialmente el resultado para la solicitud actual.
- Ejecutar el flujo de trabajo ascendente manteniendo explícitos los límites de procedencia y fuente en las notas de trabajo.
- Validar el resultado contra las expectativas ascendentes y la evidencia que se puede señalar en los archivos copiados.
- Escalar o transferir a una habilidad relacionada cuando el trabajo salga del centro de gravedad de este flujo de trabajo importado.
- Antes de fusionar o cerrar, registrar qué se usó, qué cambió y qué necesita verificar el revisor.
Notas del Flujo de Trabajo Importado
Importado: 1. Conceptos Clave
| Término | Significado |
|---|---|
| i18n | Internacionalización - hacer que la aplicación sea traducible |
| L10n | Localización - traducciones reales |
| Locale | Idioma + Región (en-US, tr-TR) |
| RTL | Idiomas de derecha a izquierda (árabe, hebreo) |
Ejemplos
Ejemplo 1: Solicitar directamente el flujo de trabajo ascendente
Usa @i18n-localization para manejar <tarea>. Comienza desde el flujo de trabajo ascendente copiado, carga solo los archivos que cambien el resultado y mantén la procedencia visible en la respuesta.
Explicación: Este es el punto de partida más seguro cuando el operador necesita el flujo de trabajo importado, pero no todo el repositorio.
Ejemplo 2: Solicitar una revisión basada en procedencia
Revisa @i18n-localization contra metadata.json y ORIGIN.md, luego explica qué archivos ascendentes copiados cargarías primero y por qué.
Explicación: Úsalo antes de la revisión o solución de problemas cuando necesites una explicación precisa y auditable del origen y la selección de archivos.
Ejemplo 3: Reducir los archivos de soporte copiados antes de la ejecución
Usa @i18n-localization para <tarea>. Carga solo las referencias, ejemplos o scripts copiados que cambien el resultado, y nombra los archivos explícitamente antes de proceder.
Explicación: Esto mantiene la habilidad alineada con la divulgación progresiva en lugar de cargar todo el paquete copiado por defecto.
Ejemplo 4: Crear un paquete para el revisor
Revisa @i18n-localization usando los archivos ascendentes copiados más la procedencia, luego resume cualquier brecha antes de fusionar.
Explicación: Esto es útil cuando el PR está esperando revisión humana y deseas un paquete de auditoría repetible.
Prácticas Recomendadas
Trata la habilidad pública generada como una capa de empaquetado revisable alrededor del repositorio ascendente. El objetivo es mantener explícita la procedencia y cargar solo el material fuente copiado que mejore materialmente la ejecución.
- Usar claves de traducción, no texto sin formato
- Espaciar las traducciones por funcionalidad
- Soporte para pluralización
- Manejar formatos de fecha/número por configuración regional
- Planificar RTL desde el inicio
- Usar formato de mensaje ICU para cadenas complejas
- Cadenas codificadas en componentes
Notas Operativas Importadas
Importado: 5. Prácticas Recomendadas
SÍ ✅
- Usar claves de traducción, no texto sin formato
- Espaciar las traducciones por funcionalidad
- Soporte para pluralización
- Manejar formatos de fecha/número por configuración regional
- Planificar RTL desde el inicio
- Usar formato de mensaje ICU para cadenas complejas
NO ❌
- Codificar cadenas en componentes
- Concatenar cadenas traducidas
- Asumir longitud del texto (el alemán es 30% más largo)
- Olvidar el diseño RTL
- Mezclar idiomas en el mismo archivo
Solución de Problemas
Problema: El operador omitió el contexto importado y respondió de forma demasiado genérica
Síntomas: El resultado ignora el flujo de trabajo ascendente en plugins/antigravity-awesome-skills-claude/skills/i18n-localization, no menciona la procedencia, o no utiliza ningún archivo fuente copiado.
Solución: Vuelve a abrir metadata.json, ORIGIN.md y los archivos ascendentes copiados más relevantes. Verifica primero el bloque external_source, luego vuelve a establecer la procedencia antes de continuar.
Problema: El flujo de trabajo importado se siente incompleto durante la revisión
Síntomas: Los revisores pueden ver el SKILL.md generado, pero no pueden determinar rápidamente qué referencias, ejemplos o scripts importan para la tarea actual.
Solución: Señala las referencias, ejemplos, scripts o activos copiados exactos que justifican el camino que tomaste. Si la brecha sigue siendo real, regístrala en el PR en lugar de ocultarla.
Problema: La tarea se desvió hacia una especialización diferente
Síntomas: La habilidad importada comienza en el lugar correcto, pero el trabajo se convierte en depuración, arquitectura, diseño, seguridad u orquestación de lanzamiento que una habilidad nativa maneja mejor. Solución: Usa la sección de habilidades relacionadas para transferir deliberadamente. Mantén visible la procedencia importada para que la siguiente habilidad herede el contexto correcto en lugar de comenzar a ciegas.
Habilidades Relacionadas
@00-andruia-consultant- Úsalo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.@00-andruia-consultant-v2- Úsalo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.@10-andruia-skill-smith- Úsalo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.@10-andruia-skill-smith-v2- Úsalo cuando el trabajo sea mejor manejado por esa especialización nativa después de que esta habilidad importada establezca contexto.
Recursos Adicionales
Usa esta matriz de soporte y los archivos vinculados a continuación como el paquete del operador para esta habilidad importada. Deben reflejar material fuente copiado real, no andamios genéricos.
| Familia de recursos | Lo que proporciona al revisor | Ruta de ejemplo |
|---|---|---|
references | notas de referencia copiadas, guías o material de fondo del ascendente | references/n/a |
examples | ejemplos resueltos o indicaciones reutilizables copiados del ascendente | examples/n/a |
scripts | scripts auxiliares del ascendente que cambian la ejecución o validación | scripts/i18n_checker.py |
agents | notas de enrutamiento o delegación que son genuinamente parte del paquete importado | agents/n/a |
assets | activos de soporte o esquemas copiados del paquete fuente | assets/n/a |
Notas de Referencia Importadas
Importado: 3. Patrones de Implementación
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Bienvenido a nuestra aplicación"))
Importado: 4. Estructura de Archivos
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
Importado: 6. Problemas Comunes
| Problema | Solución |
|---|---|
| Traducción faltante | Recurrir al idioma predeterminado |
| Cadenas codificadas | Usar script linter/checker |
| Formato de fecha | Usar Intl.DateTimeFormat |
| Formato de número | Usar Intl.NumberFormat |
| Pluralización | Usar formato de mensaje ICU |
Importado: 7. Soporte RTL
/* Propiedades lógicas CSS */
.container {
margin-inline-start: 1rem; /* No margin-left */
padding-inline-end: 1rem; /* No padding-right */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
Importado: 8. Lista de Verificación
Antes de lanzar:
- Todas las cadenas visibles para el usuario usan claves de traducción
- Los archivos de configuración regional existen para todos los idiomas compatibles
- El formato de fecha/número utiliza la API Intl
- Diseño RTL probado (si aplica)
- Idioma de recurso predeterminado configurado
- Sin cadenas codificadas en componentes
Importado: Script
| Script | Propósito | Comando |
|---|---|---|
scripts/i18n_checker.py | Detectar cadenas codificadas y traducciones faltantes | python scripts/i18n_checker.py <ruta_del_proyecto> |
Importado: Limitaciones
- Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trates la salida como un sustituto de la validación, prueba o revisión de expertos específica del entorno.
- Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.