Communitygithub.com

Experto en I18n

Esta habilidad se utiliza para configurar, auditar o implementar la internacionalización/localización en bases de código de interfaz de usuario (React/TS, i18next o similar, locales JSON), incluyendo la instalación/configuración del framework i18n, el reemplazo de cadenas hardcodeadas y la garantía de cobertura en en-US/zh-CN.

¿Qué es Experto en I18n?

El skill 'Experto en I18n' está diseñado para desarrolladores que necesitan implementar o auditar la internacionalización (i18n) de aplicaciones frontend con frameworks como React, Next.js o Vue. Su propósito es guiar al agente de IA (Claude Code, Cursor, etc.) a través de un flujo de trabajo completo: desde la configuración inicial del framework de i18n (react-i18next, next-intl, vue-i18n, etc.), la organización de archivos de locales, hasta el reemplazo sistemático de cadenas visibles para el usuario por claves traducibles. El skill también incluye la verificación de paridad entre idiomas (por defecto en-US y zh-CN), el manejo de plurales, formatos de fecha/número, y la localización de metadatos SEO y accesibilidad (aria-label). Una parte crítica es la auditoría de claves faltantes o asimétricas, utilizando scripts auxiliares como `scripts/i18n_audit.py`. El agente no debe exponer mensajes de error sin traducir y debe mantener términos técnicos o de marca sin traducir. El resultado final incluye archivos de locales actualizados, un conmutador de idioma funcional y pruebas actualizadas que verifican el texto visible.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/skills/localization-toolkit

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Experto en I18n?

Descripción general

Realiza una configuración completa de i18n junto con una auditoría: configura el framework de internacionalización, reemplaza las cadenas visibles para el usuario con claves, garantiza la paridad entre idiomas y valida la pluralización y el formato para en-US y zh-CN.

Capacidades principales

  • Selección y configuración de librerías (React, Next.js, Vue).
  • Arquitectura de claves y organización de archivos de localización.
  • Generación de traducciones y estrategia de calidad (IA, profesional, manual).
  • Enrutamiento y detección/cambio de idioma.
  • Localización SEO y de metadatos (cuando sea aplicable).
  • Soporte RTL (solo si los idiomas objetivo incluyen RTL).

Entradas de alcance (preguntar si no está claro)

  • Framework y estilo de enrutamiento.
  • Estado actual de i18n (ninguno, parcial, heredado).
  • Idiomas objetivo (por defecto: en-US + zh-CN).
  • Necesidades de calidad de traducción (IA vs profesional vs manual).
  • Formatos de localización en uso (JSON, YAML, PO, XLIFF).
  • Requisitos de formalidad cultural (si los hay).

Flujo de trabajo (Auditar -> Corregir -> Validar)

  1. Confirmar el alcance y los idiomas objetivo

    • Identificar el framework de i18n y las ubicaciones de los archivos de localización.
    • Confirmar los idiomas; por defecto usar en-US + zh-CN cuando se especifique.
  2. Configurar la base de i18n (si falta)

    • Elegir una librería adecuada al framework (ej., React: react-i18next; Next.js: next-intl; Vue: vue-i18n).
    • Instalar paquetes y crear el archivo de entrada/configuración de i18n.
    • Conectar el proveedor en la raíz de la aplicación y cargar los recursos de localización.
    • Agregar un conmutador de idioma y persistencia (ruta/parámetro/localStorage) según corresponda.
    • Establecer la estructura de archivos de localización y los espacios de nombres de claves.
    • Si el enrutamiento tiene en cuenta el idioma, definir la estrategia de segmento de idioma desde el principio (subruta, subdominio, parámetro de consulta).
    • Si los metadatos son visibles para el usuario, incluir la traducción de títulos/descripciones.
  3. Auditar el uso de claves y la paridad entre idiomas

    • Ejecutar:
      python scripts/i18n_audit.py --src <raíz-src> --locale <ruta/a/en-US.json> --locale <ruta/a/zh-CN.json>
      
    • Tratar las claves faltantes o las brechas de paridad como bloqueantes.
    • Verificar manualmente las claves dinámicas (t(var)).
  4. Encontrar cadenas sin procesar visibles para el usuario

    • Buscar:
      rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "<[^>]+>[^<{]*[A-Za-z][^<{]*<"
      rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "aria-label=\"[^\"]+\"|title=\"[^\"]+\"|placeholder=\"[^\"]+\""
      
    • Localizar etiquetas de accesibilidad.
  5. Reemplazar cadenas con claves

    • Usar t('namespace.key') para texto de interfaz.
    • Para plurales usar t('key', { count }) + claves _one/_other.
    • Usar formateadores Intl/de la aplicación para hora/fecha/número.
  6. Localizar el manejo de errores (crítico)

    • Mapear códigos de error a claves localizadas; mostrar solo la interfaz localizada.
    • Registrar solo los detalles del error sin procesar.
    • Proporcionar una alternativa localizada para códigos desconocidos.
  7. Actualizar archivos de localización

    • Agregar claves faltantes en ambos idiomas.
    • Mantener los marcadores de posición consistentes; evitar renombrar a menos que se solicite.
    • Generar traducciones usando el método acordado; preservar marcadores de posición y reglas de plurales.
  8. Validar

    • Volver a ejecutar la auditoría hasta que no haya problemas de claves faltantes o de paridad.
    • Validar JSON (ej., python -m json.tool <archivo>).
    • Actualizar las pruebas que verifican el texto visible.

Barreras de seguridad

  • Nunca exponer error.message sin procesar en la interfaz de usuario; mostrar solo cadenas localizadas.
  • No agregar idiomas adicionales a menos que se solicite explícitamente.
  • Preferir espacios de nombres estructurados (ej., errors.*, buttons.*, workspace.*).
  • Mantener las traducciones concisas y consistentes.
  • Algunos términos técnicos/de marca deben permanecer sin traducir (ej., nombre del producto, API, MCP, Bash).

Entregables (salidas esperadas)

  • Configuración de i18n / conexión del proveedor.
  • Archivos de localización para cada idioma objetivo.
  • Cadenas de interfaz reemplazadas con claves estables.
  • Conmutador de idioma y persistencia (si corresponde).
  • Pruebas actualizadas para verificar el texto visible.

Guía de arquitectura (mantener concisa)

  • Estructura de claves: preferir espacios de nombres anidados por área (ej., common.buttons.save, pricing.tier.pro).
  • Organización de archivos: un archivo por idioma o espacios de nombres por idioma; mantener las claves sincronizadas entre idiomas.
  • Marcadores de posición: preservar exactamente {nombre}/{{nombre}}; validar plurales según las reglas del idioma.
  • Formateo: usar ayudantes Intl/de la aplicación para formateo de fecha, hora, número y listas.
  • SEO/metadatos: localizar títulos y descripciones si la aplicación los expone.
  • RTL: solo necesario para idiomas RTL; usar propiedades CSS lógicas y probar el diseño.
  • Superficies no web (diálogos del proceso principal de Electron, indicaciones de CLI, menús nativos) también necesitan localización.

Notas de rendimiento (breve)

  • Cargar perezosamente los paquetes de localización cuando la aplicación lo soporte.
  • Dividir archivos de localización grandes por espacio de nombres.

Modos de fallo (lista de vigilancia)

  • Traducciones faltantes: recurrir al idioma por defecto y registrar advertencias.
  • Problemas de diseño RTL: verificar CSS lógico y probar páginas.
  • SEO faltante: asegurar que los enlaces alternativos y metadatos estén localizados cuando sea aplicable.

Lista de verificación de validación (breve)

  • Sin claves faltantes y sin cadenas sin procesar en la interfaz.
  • El cambio de idioma funciona y persiste.
  • Plurales y formato verificados en ambos idiomas.
  • Idioma de respaldo configurado.

Recursos

scripts/

  • scripts/i18n_audit.py: Extrae el uso de t('key') y lo compara con los archivos JSON de localización.

Desencadenantes de activación

Mapear códigos de error a mensajes localizados, y validar la paridad de claves, pluralización y formato.

Individual skills in this repo

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

JantonioFC/skillsbank

AI-powered image editing with style transfer and object removal

JantonioFC/skillsbank

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

JantonioFC/skillsbank

Analise e auditoria de editais de leilao judicial e extrajudicial. Riscos ocultos, clausulas perigosas, debitos, ocupante e classificacao da oportunidade.

JantonioFC/skillsbank

Embed Photopea in web apps using photopea.js. Covers embedding, file I/O, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.

JantonioFC/skillsbank

Best practices for Remotion - Video creation in React

JantonioFC/skillsbank

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

JantonioFC/skillsbank

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

JantonioFC/skillsbank

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

JantonioFC/skillsbank

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

JantonioFC/skillsbank

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

JantonioFC/skillsbank

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

JantonioFC/skillsbank

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

JantonioFC/skillsbank

Tool lifecycle UI components for React/Next.js from ui.inference.sh. Display tool calls: pending, progress, approval required, results. Capabilities: tool status, progress indicators, approval flows, results display. Use for: showing agent tool calls, human-in-the-loop approvals, tool output. Triggers: tool ui, tool calls, tool status, tool approval, tool results, agent tools, mcp tools ui, function calling ui, tool lifecycle, tool pending

JantonioFC/skillsbank

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

JantonioFC/skillsbank

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,'...

JantonioFC/skillsbank

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, expla...

JantonioFC/skillsbank

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awarene...

JantonioFC/skillsbank

Generate AI videos with Google Veo, Seedance, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 1.5 Pro, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, lipsync, avatar animation, video upscaling, fole...

JantonioFC/skillsbank

Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.

JantonioFC/skillsbank

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

Skills relacionados