Communitygithub.com

JantonioFC/skillsbank

Padrões de internacionalização e localização. Detecção de strings codificadas, gerenciamento de traduções, arquivos de idioma e suporte RTL.

O que é skillsbank?

Este skill oferece um guia completo para implementar internacionalização (i18n) e localização (L10n) em aplicações de software. Ele abrange desde conceitos fundamentais, como a diferença entre i18n e L10n, até padrões práticos de implementação usando bibliotecas populares como react-i18next para React, next-intl para Next.js e gettext para Python. O skill detalha a estrutura ideal de arquivos de tradução, boas práticas essenciais (como uso de chaves de tradução, namespacing, suporte a pluralização e formatação de datas/números), e fornece um checklist para garantir que a aplicação esteja pronta para múltiplos idiomas. Também inclui orientações específicas para suporte a idiomas RTL (da direita para a esquerda), como o uso de propriedades lógicas CSS, e um script utilitário (`scripts/i18n_checker.py`) para detectar strings codificadas e traduções ausentes. O skill é aplicável a qualquer projeto que exija suporte multilíngue, seja uma aplicação web pública, um produto SaaS ou uma ferramenta interna com potencial de expansão futura.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/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 efetivas
LocaleIdioma + Região (pt-BR, en-US)
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 o 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(_("Bem-vindo ao nosso aplicativo"))

4. Estrutura de Arquivos

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

5. Boas Práticas

FAÇA ✅

  • Use chaves de tradução, e não texto bruto
  • Namespace (agrupe) traduções por funcionalidade
  • Suporte pluralização
  • Formate datas/números por localidade
  • Planeje RTL desde o início
  • Use formato de mensagem ICU para strings complexas

NÃO FAÇA ❌

  • Não codifique strings nos componentes
  • Não concatene strings traduzidas
  • Não presuma o tamanho do texto (alemão é 30% mais longo)
  • Não esqueça do layout RTL
  • Não 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 formato de mensagem ICU

7. Suporte RTL

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

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

8. Checklist

Antes de lançar:

  • Todas as strings visíveis ao usuário usam chaves de tradução
  • Arquivos de idioma 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 nos componentes

Script

ScriptFinalidadeComando
scripts/i18n_checker.pyDetecta strings codificadas e traduções ausentespython scripts/i18n_checker.py <caminho_do_projeto>

Quando Usar

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

Limitações

  • Use este skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como substituta para validação, testes ou revisão especializada específica do ambiente.
  • Pare e peça esclarecimentos se entradas obrigatórias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.

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.

Habilidades Relacionadas