Communitygithub.com

JantonioFC/skillsbank

Patrones de internacionalización y localización. Detección de cadenas hardcodeadas, gestión de traducciones, archivos de configuración regional y soporte RTL.

¿Qué es skillsbank?

Este skill proporciona una guía completa de mejores prácticas para implementar internacionalización (i18n) y localización (L10n) en aplicaciones de software. Es útil para desarrolladores que trabajan con frameworks como React, Next.js o Python, y cubre desde la estructura de archivos de traducción hasta el soporte para idiomas de derecha a izquierda (RTL). Incluye patrones de implementación con bibliotecas populares (react-i18next, next-intl, gettext), una lista de verificación para evitar errores comunes como cadenas hardcodeadas o falta de soporte para pluralización, y un script auxiliar para detectar problemas. Aunque está diseñado para ser ejecutado como un flujo de trabajo automatizado, requiere validación específica del entorno y no sustituye revisiones expertas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/plugins/antigravity-awesome-skills-claude/skills/i18n-localization

Preguntar en tu IA favorita

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

Documentación

i18n y Localización

Mejores prácticas de Internacionalización (i18n) y Localización (L10n).


1. Conceptos Fundamentales

TérminoSignificado
i18nInternacionalización - hacer la aplicación traducible
L10nLocalización - traducciones reales
LocaleIdioma + Región (en-US, tr-TR)
RTLIdiomas de derecha a izquierda (árabe, hebreo)

2. Cuándo Usar i18n

Tipo de Proyecto¿Necesita i18n?
Aplicación web pública✅ Sí
Producto SaaS✅ Sí
Herramienta interna⚠️ Quizás
Aplicación de una sola región⚠️ Considerar futuro
Proyecto personal❌ Opcional

3. Patrones de Implementación

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Bienvenida() {
  const { t } = useTranslation();
  return <h1>{t('bienvenida.titulo')}</h1>;
}

Next.js (next-intl)

import { useTranslations } from 'next-intl';

export default function Pagina() {
  const t = useTranslations('Inicio');
  return <h1>{t('titulo')}</h1>;
}

Python (gettext)

from gettext import gettext as _

print(_("Bienvenido a nuestra aplicación"))

4. Estructura de Archivos

locales/
├── es/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── en/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

5. Buenas Prácticas

HACER ✅

  • Usar claves de traducción, no texto plano
  • Agrupar traducciones por funcionalidad
  • Soportar pluralización
  • Manejar formatos de fecha/número según la configuración regional
  • Planificar RTL desde el inicio
  • Usar formato de mensaje ICU para cadenas complejas

NO HACER ❌

  • Hardcodear cadenas en componentes
  • Concatenar cadenas traducidas
  • Asumir longitud del texto (el alemán es un 30% más largo)
  • Olvidar el diseño RTL
  • Mezclar idiomas en el mismo archivo

6. Problemas Comunes

ProblemaSolución
Traducción faltanteRecurrir al idioma predeterminado
Cadenas hardcodeadasUsar un script linter/verificador
Formato de fechaUsar Intl.DateTimeFormat
Formato de númeroUsar Intl.NumberFormat
PluralizaciónUsar formato de mensaje ICU

7. Soporte RTL

/* Propiedades Lógicas CSS */
.contenedor {
  margin-inline-start: 1rem;  /* No margin-left */
  padding-inline-end: 1rem;   /* No padding-right */
}

[dir="rtl"] .icono {
  transform: scaleX(-1);
}

8. Lista de Verificación

Antes de publicar:

  • Todas las cadenas visibles para el usuario usan claves de traducción
  • Existen archivos de configuración regional para todos los idiomas compatibles
  • El formato de fecha/número usa la API Intl
  • El diseño RTL se ha probado (si aplica)
  • Se ha configurado un idioma de respaldo
  • No hay cadenas hardcodeadas en los componentes

Script

ScriptPropósitoComando
scripts/i18n_checker.pyDetectar cadenas hardcodeadas y traducciones faltantespython scripts/i18n_checker.py <ruta_del_proyecto>

Cuándo Usar

Este skill es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la visión general.

Limitaciones

  • Use este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trate el resultado como un sustituto de la validación, prueba o revisión experta específica del entorno.
  • Deténgase y solicite aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

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

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

Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.

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