Communitygithub.com

BEKO2210/Firstbrain

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

O que é Firstbrain?

Esta skill fornece um guia completo e prático sobre internacionalização (i18n) e localização (L10n) para desenvolvedores e agentes de IA. Ela cobre desde conceitos fundamentais, como a diferença entre i18n e L10n, até padrões de implementação nas principais tecnologias (React com react-i18next, Next.js com next-intl e Python com gettext). A skill é extremamente útil para garantir que aplicações web, produtos SaaS e ferramentas internas sejam preparadas para múltiplos idiomas e regiões, evitando problemas comuns como strings hardcoded e falta de suporte para idiomas da direita para a esquerda (RTL). Suporta plataformas de desenvolvimento web e mobile, e seu workflow inclui a estruturação de arquivos de localidade, uso de chaves de tradução, formatação correta de datas e números, e verificação automatizada por meio de scripts. O objetivo é capacitar o agente a implementar ou revisar a localização de um projeto, seguindo as melhores práticas do setor.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/i18n-localization

Perguntar na sua IA favorita

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

Documentação

i18n & Localização

Práticas recomendadas de Internacionalização (i18n) e Localização (L10n).


1. Conceitos Básicos

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/
├── en/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── pt/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

5. Melhores Práticas

FAÇA ✅

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

NÃO FAÇA ❌

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

6. Problemas Comuns

ProblemaSolução
Tradução ausenteFallback para o idioma padrão
Strings hardcodedUse 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 margin-left */
  padding-inline-end: 1rem;   /* Não padding-right */
}

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

8. Lista de Verificação

Antes de publicar:

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

Script

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

Quando Usar

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

Conexões

  • Domínio: [[Desenvolvimento de Software]]
  • Categoria: [[Arquitetura de Software]]
  • Arquivos:
    • scripts/i18n_checker.py
  • Navegação: [[Visão Geral das Skills]], [[Início]]

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

Habilidades Relacionadas