Communitygithub.com

BEKO2210/Firstbrain

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

¿Qué es Firstbrain?

Este skill proporciona una guía completa sobre internacionalización (i18n) y localización (L10n) para desarrolladores y agentes de IA. Cubre desde los conceptos fundamentales —como la diferencia entre i18n y L10n, qué es un locale y el soporte para idiomas de derecha a izquierda (RTL)— hasta patrones de implementación en frameworks populares como React (react-i18next), Next.js (next-intl) y Python (gettext). También incluye una estructura de archivos recomendada, buenas prácticas (como usar claves de traducción en lugar de texto literal, soportar pluralización y formatear fechas/números) y errores comunes a evitar. Incluye un checklist para verificar antes del lanzamiento y un script opcional (`scripts/i18n_checker.py`) para detectar cadenas hardcodeadas o traducciones faltantes. Es compatible con cualquier pila tecnológica moderna y se integra fácilmente en flujos de CI/CD. Es ideal tanto para aprender los fundamentos como para aplicar rápidamente patrones de i18n en proyectos nuevos o existentes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/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

Prácticas recomendadas para Internacionalización (i18n) y Localización (L10n).


1. Conceptos básicos

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

2. Cuándo usar i18n

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

3. Patrones de implementación

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Bienvenido() {
  const { t } = useTranslation();
  return <h1>{t('bienvenido.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
├── tr/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

5. Buenas prácticas

SÍ ✅

  • Usar claves de traducción, no texto sin formato
  • Agrupar las traducciones por funcionalidad
  • Dar soporte a pluralización
  • Manejar formatos de fecha/número por locale
  • Planificar para RTL desde el principio
  • Usar formato ICU para cadenas complejas

NO ❌

  • Hardcodear cadenas en los componentes
  • Concatenar cadenas traducidas
  • Asumir la 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 script de linting/comprobación
Formato de fechaUsar Intl.DateTimeFormat
Formato de númeroUsar Intl.NumberFormat
PluralizaciónUsar formato 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 del lanzamiento:

  • Todas las cadenas visibles para el usuario usan claves de traducción
  • Los archivos de locale existen para todos los idiomas compatibles
  • El formateo de fecha/número usa la API Intl
  • Se probó el diseño RTL (si aplica)
  • El idioma de respaldo está configurado
  • 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 descripción general.

Conexiones

  • Dominio: [[Software Entwicklung]]
  • Categoría: [[Software Architektur]]
  • Archivos:
    • scripts/i18n_checker.py
  • Navegación: [[Skills Übersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

BEKO2210/Firstbrain

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

BEKO2210/Firstbrain

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Skills relacionados