Communitygithub.com

Desesbraker/agentes-vip

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 agentes-vip?

Esta habilidad proporciona un conjunto completo de patrones y mejores prácticas para implementar internacionalización (i18n) y localización (L10n) en proyectos de software. Es útil para desarrolladores que trabajan en aplicaciones web públicas, productos SaaS o herramientas internas que necesitan soporte multilingüe. La skill abarca desde conceptos básicos (i18n, L10n, locale, RTL) hasta implementaciones concretas en frameworks populares como React con react-i18next, Next.js con next-intl y Python con gettext. También incluye una estructura de archivos recomendada, mejores prácticas (como el uso de claves de traducción en lugar de texto sin formato), soporte para idiomas de derecha a izquierda (RTL) mediante propiedades lógicas CSS, y un checklist para garantizar una localización completa. Además, se menciona un script (`scripts/i18n_checker.py`) para detectar cadenas hardcodeadas y traducciones faltantes, lo que facilita la automatización del proceso. Está diseñada para plataformas como Claude Code, Cursor y Codex, y su documentación SKILL.md proporciona una guía paso a paso para integrar estos patrones en cualquier proyecto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/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 Clave

TérminoSignificado
i18nInternacionalización – hacer que la app sea traducible
L10nLocalización – traducciones efectivas
LocaleLengua + Región (en-US, tr-TR)
RTLIdiomas de derecha a izquierda (árabe, hebreo)

2. Cuándo Usar i18n

Tipo de Proyecto¿i18n Necesario?
App web pública✅ Sí
Producto SaaS✅ Sí
Herramienta interna⚠️ Quizás
App de una sola región⚠️ Considerar el 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('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 app"))

4. Estructura de Archivos

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

5. Mejores Prácticas

HACER ✅

  • Usar claves de traducción, no texto sin formato
  • Espacio de nombres (namespace) para las traducciones por funcionalidad
  • Soportar pluralización
  • Manejar formatos de fecha/número por locale
  • Planificar RTL desde el inicio
  • Usar formato de mensaje ICU para cadenas complejas

NO HACER ❌

  • 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 linter/script de verificación
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. Checklist

Antes de enviar:

  • Todas las cadenas visibles para el usuario usan claves de traducción
  • Archivos de locale existen para todos los idiomas soportados
  • El formato de fecha/número usa la API Intl
  • Diseño RTL probado (si aplica)
  • Idioma predeterminado 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_proyecto>

Cuándo Usar

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

Individual skills in this repo

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

Skills relacionados