Communitygithub.com

Desesbraker/agentes-vip

Padrões de internacionalização e localização. Detectando strings codificadas, gerenciando traduções, arquivos de locale e suporte RTL.

O que é agentes-vip?

Este skill fornece um conjunto abrangente de padrões e boas práticas para internacionalização (i18n) e localização (L10n) de aplicações. Ele orienta desenvolvedores sobre como estruturar arquivos de tradução, usar chaves em vez de texto fixo, e implementar suporte para múltiplos locales, incluindo idiomas da direita para a esquerda (RTL). O skill inclui exemplos práticos para React (react-i18next), Next.js (next-intl) e Python (gettext), além de scripts para verificação automática de strings codificadas e traduções ausentes. É ideal para projetos web públicos, produtos SaaS e qualquer aplicação que precise atingir audiências globais, ajudando a evitar problemas comuns como formatação de datas, pluralização e layout RTL.

Funciona com~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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

i18n e Localização

Melhores práticas de Internacionalização (i18n) e Localização (L10n).


1. Conceitos Principais

TermoSignificado
i18nInternacionalização – tornar o aplicativo traduzível
L10nLocalização – traduções reais
LocaleIdioma + Região (pt-BR, tr-TR)
RTLIdiomas da direita para a esquerda (árabe, hebraico)

2. Quando Usar i18n

Tipo de Projetoi18n Necessário?
Aplicativo web público✅ Sim
Produto SaaS✅ Sim
Ferramenta interna⚠️ Talvez
Aplicativo de região única⚠️ Considere no futuro
Projeto pessoal❌ Opcional

3. Padrões de Implementação

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(_("Welcome to our app"))

4. Estrutura de Arquivos

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

5. Melhores Práticas

FAÇA ✅

  • Use chaves de tradução, não texto bruto
  • Namespace traduções por funcionalidade
  • Suporte a pluralização
  • Trate formatos de data/número por locale
  • Planeje RTL desde o início
  • Use o formato de mensagem ICU para strings complexas

NÃO FAÇA ❌

  • Codifique strings em componentes
  • Concatene strings traduzidas
  • Presuma comprimento de texto (alemão é 30% mais longo)
  • Esqueça do layout RTL
  • Misture idiomas no mesmo arquivo

6. Problemas Comuns

ProblemaSolução
Tradução ausenteFallback para o idioma padrão
Strings codificadasUse script linter/verificador
Formato de dataUse Intl.DateTimeFormat
Formato de númeroUse Intl.NumberFormat
PluralizaçãoUse o formato de mensagem ICU

7. Suporte RTL

/* Propriedades CSS Lógicas */
.container {
  margin-inline-start: 1rem;  /* Não margin-left */
  padding-inline-end: 1rem;   /* Não padding-right */
}

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

8. Checklist

Antes de enviar:

  • Todas as strings voltadas ao usuário usam chaves de tradução
  • Arquivos de locale existem para todos os idiomas suportados
  • Formatação de data/número usa a API Intl
  • Layout RTL testado (se aplicável)
  • Idioma de fallback configurado
  • Nenhuma string codificada em componentes

Script

ScriptPropósitoComando
scripts/i18n_checker.pyDetectar strings codificadas e traduções ausentespython scripts/i18n_checker.py <project_path>

Quando Usar

Este skill é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

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.

Habilidades Relacionadas