Communitygithub.com

diegosouzapw/awesome-omni-skills

Fluxo de trabalho de i18n e Localização. Use esta skill quando o usuário precisar de padrões de Internacionalização e localização: detectar strings hardcoded, gerenciar traduções, arquivos de locale, suporte a RTL e preservar o fluxo de trabalho upstream, arquivos de suporte copiados e proveniência antes de mesclar ou transferir.

O que é awesome-omni-skills?

Esta skill é uma cópia de repositório público do pacote `plugins/antigravity-awesome-skills/skills/i18n-localization` do repositório `https://github.com/sickn33/antigravity-awesome-skills`, embalado no formato editorial nativo do Omni Skills sem ocultar sua origem. Ela é projetada para ser usada quando o operador precisa manter intactos o fluxo de trabalho upstream, os arquivos de suporte e o contexto do repositório, enquanto o validador público e o aprimorador privado continuam seu fluxo normal downstream. A skill mantém os arquivos copiados intactos e usa o bloco `external_source` em `metadata.json` junto com `ORIGIN.md` como âncora de proveniência para revisão. Ela inclui conceitos central de i18n/L10n, padrões de implementação (React, Next.js, Python), estrutura de arquivos de locale, suporte a RTL com propriedades lógicas CSS, uma lista de verificação pré-lançamento e um script `scripts/i18n_checker.py` para detectar strings hardcoded e traduções ausentes. A skill é útil para desenvolvedores que precisam aplicaro boas práticas de internacionalização e localização em projetos web públicos, SaaS ou ferramentas internas, garantindo que a proveniência do código copiado seja rastreável e auditável durante revisões e mesclagens.

Funciona com✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI✓OpenCode
npx skills add https://github.com/diegosouzapw/awesome-omni-skills/tree/HEAD/skills/i18n-localization-v2

Perguntar na sua IA favorita

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

Documentação

i18n e Localização

Visão Geral

Esta cópia de repositório público empacota plugins/antigravity-awesome-skills/skills/i18n-localization de https://github.com/sickn33/antigravity-awesome-skills no formato editorial nativo do Omni Skills sem ocultar sua origem.

Use-a quando o operador precisar que o fluxo de trabalho upstream, os arquivos de suporte e o contexto do repositório permaneçam intactos enquanto o validador público e o aprimorador privado continuam seu fluxo downstream normal.

Esta cópia mantém intactos os arquivos upstream copiados e usa o bloco external_source em metadata.json mais ORIGIN.md como âncora de proveniência para revisão.

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

Seções importadas da fonte que não foram mapeadas claramente para os cabeçalhos públicos ainda estão preservadas abaixo ou nos arquivos de suporte. Seções importadas notáveis: 1. Conceitos Principais, 3. Padrões de Implementação, 4. Estrutura de Arquivos, 6. Problemas Comuns, 7. Suporte RTL, 8. Lista de Verificação.

Quando Usar Esta Skill

Use esta seção como o filtro de ativação. Ela deve tornar explícito o limite de ativação antes que o operador carregue arquivos, execute comandos ou abra um pull request.

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

Tabela de Operação

SituaçãoComece aquiPor que é importante
Primeiro usometadata.jsonConfirma repositório, branch, commit e caminho importado através do bloco external_source antes de tocar no fluxo de trabalho copiado
Revisão de proveniênciaORIGIN.mdFornece aos revisores uma trilha de auditoria em linguagem simples para a fonte importada
Execução do fluxo de trabalhoscripts/i18n_checker.pyComeça com o menor arquivo copiado que altera materialmente a execução
Contexto de suportescripts/i18n_checker.pyAdiciona o próximo arquivo fonte copiado mais relevante sem carregar o pacote inteiro
Decisão de transferência## Skills RelacionadasAjuda o operador a mudar para uma skill nativa mais forte quando a tarefa se desvia

Fluxo de Trabalho

Este fluxo de trabalho é intencionalmente editorial e operacional ao mesmo tempo. Ele mantém a fonte importada útil para o operador enquanto ainda satisfaz os padrões de recebimento público que alimentam o fluxo downstream do aprimorador.

  1. Confirme o objetivo do usuário, o escopo do fluxo de trabalho importado e se esta skill ainda é o roteador certo para a tarefa.
  2. Leia a visão geral e os arquivos de proveniência antes de carregar quaisquer arquivos de suporte upstream copiados.
  3. Carregue apenas as referências, exemplos, prompts ou scripts que alteram materialmente o resultado para a solicitação atual.
  4. Execute o fluxo de trabalho upstream mantendo a proveniência e os limites da fonte explícitos nas notas de trabalho.
  5. Valide o resultado em relação às expectativas upstream e às evidências que você pode apontar nos arquivos copiados.
  6. Escalone ou transfira para uma skill relacionada quando o trabalho sair do centro de gravidade deste fluxo de trabalho importado.
  7. Antes da mesclagem ou encerramento, registre o que foi usado, o que mudou e o que o revisor ainda precisa verificar.

Notas do Fluxo de Trabalho Importado

Importado: 1. Conceitos Principais

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

Exemplos

Exemplo 1: Solicitar o fluxo de trabalho upstream diretamente

Use @i18n-localization-v2 para lidar com <tarefa>. Comece pelo fluxo de trabalho upstream copiado, carregue apenas os arquivos que alteram o resultado e mantenha a proveniência visível na resposta.

Explicação: Este é o ponto de partida mais seguro quando o operador precisa do fluxo de trabalho importado, mas não do repositório inteiro.

Exemplo 2: Solicitar uma revisão baseada em proveniência

Revise @i18n-localization-v2 com base em metadata.json e ORIGIN.md, depois explique quais arquivos upstream copiados você carregaria primeiro e por quê.

Explicação: Use isso antes de revisão ou solução de problemas quando precisar de uma explicação precisa e auditável da origem e seleção de arquivos.

Exemplo 3: Restringir os arquivos de suporte copiados antes da execução

Use @i18n-localization-v2 para <tarefa>. Carregue apenas as referências, exemplos ou scripts copiados que alteram o resultado e nomeie os arquivos explicitamente antes de prosseguir.

Explicação: Isso mantém a skill alinhada com a divulgação progressiva em vez de carregar todo o pacote copiado por padrão.

Exemplo 4: Criar um pacote para o revisor

Revise @i18n-localization-v2 usando os arquivos upstream copiados mais a proveniência, depois resuma quaisquer lacunas antes da mesclagem.

Explicação: Isso é útil quando o PR está aguardando revisão humana e você deseja um pacote de auditoria reproduzível.

Melhores Práticas

Trate a skill pública gerada como uma camada de empacotamento revisável em torno do repositório upstream. O objetivo é manter a proveniência explícita e carregar apenas o material fonte copiado que melhora materialmente a execução.

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

Notas Operacionais Importadas

Importado: 5. Melhores Práticas

FAÇA ✅

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

NÃO FAÇA ❌

  • Strings hardcoded em componentes
  • Concatenar strings traduzidas
  • Assumir comprimento de texto (alemão é 30% mais longo)
  • Esquecer do layout RTL
  • Misturar idiomas no mesmo arquivo

Solução de Problemas

Problema: O operador pulou o contexto importado e respondeu de forma muito genérica

Sintomas: O resultado ignora o fluxo de trabalho upstream em plugins/antigravity-awesome-skills/skills/i18n-localization, não menciona proveniência ou não usa nenhum arquivo fonte copiado. Solução: Reabra metadata.json, ORIGIN.md e os arquivos upstream copiados mais relevantes. Verifique o bloco external_source primeiro, depois reafirme a proveniência antes de continuar.

Problema: O fluxo de trabalho importado parece incompleto durante a revisão

Sintomas: Os revisores podem ver o SKILL.md gerado, mas não conseguem identificar rapidamente quais referências, exemplos ou scripts são importantes para a tarefa atual. Solução: Aponte para as referências, exemplos, scripts ou ativos copiados exatos que justificam o caminho que você seguiu. Se a lacuna ainda for real, registre-a no PR em vez de escondê-la.

Problema: A tarefa se desviou para uma especialização diferente

Sintomas: A skill importada começa no lugar certo, mas o trabalho se transforma em depuração, arquitetura, design, segurança ou orquestração de lançamento que uma skill nativa lida melhor. Solução: Use a seção de skills relacionadas para transferir deliberadamente. Mantenha a proveniência importada visível para que a próxima skill herde o contexto certo em vez de começar às cegas.

Skills Relacionadas

  • @00-andruia-consultant - Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.
  • @00-andruia-consultant-v2 - Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.
  • @10-andruia-skill-smith - Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.
  • @10-andruia-skill-smith-v2 - Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.

Recursos Adicionais

Use esta matriz de suporte e os arquivos vinculados abaixo como o pacote do operador para esta skill importada. Eles devem refletir material fonte copiado real, não scaffolding genérico.

Família de recursosO que fornece ao revisorCaminho de exemplo
referencesnotas de referência copiadas, guias ou material de fundo do upstreamreferences/n/a
examplesexemplos trabalhados ou prompts reutilizáveis copiados do upstreamexamples/n/a
scriptsscripts auxiliares upstream que alteram a execução ou validaçãoscripts/i18n_checker.py
agentsnotas de roteamento ou delegação que são genuinamente parte do pacote importadoagents/n/a
assetsativos de suporte ou esquemas copiados do pacote de origemassets/n/a

Notas de Referência Importadas

Importado: 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"))

Importado: 4. Estrutura de Arquivos

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

Importado: 6. Problemas Comuns

ProblemaSolução
Tradução ausenteFalhar 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

Importado: 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);
}

Importado: 8. Lista de Verificação

Antes do lançamento:

  • 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 hardcoded em componentes

Importado: Script

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

Importado: Limitações

  • Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como substituta para validação, teste ou revisão especializada específica do ambiente.
  • Pare e peça esclarecimentos se as entradas necessá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.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AgentFolio workflow skill. Use this skill when the user needs Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

AI UGC Ads workflow skill. Use this skill when the user needs When the user wants to create UGC ad campaigns, recruit UGC creators, generate AI UGC content, or scale with user-generated content. Also use when the user mentions 'UGC,' 'user-generated content,' 'creator ads,' 'Spark Ads,' 'whitelisting,' 'AI UGC,' 'Arcads,' 'Creatify,' 'creator brief,' or 'UGC testing.' This skill covers the UGC growth framework from creator recruitment through AI-powered scaling. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Astro Web Framework workflow skill. Use this skill when the user needs Build content-focused websites with Astro \u2014 zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs 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 and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs 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 and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Copy Editing workflow skill. Use this skill when the user needs 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 and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Fal Image Edit workflow skill. Use this skill when the user needs AI-powered image editing with style transfer and object removal and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

frontend-design workflow skill. Use this skill when the user needs Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics. Do NOT use for design review or audit (use web-design-guidelines or web-quality-audit) and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Frontend Design (Distinctive, Production-Grade) workflow skill. Use this skill when the user needs You are a frontend designer-engineer, not a layout generator and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

i18n & Localization workflow skill. Use this skill when the user needs Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs 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 and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Landing Page Generator workflow skill. Use this skill when the user needs 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 and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Interactive Portfolio workflow skill. Use this skill when the user needs Expert in building portfolios that actually land jobs and clients - and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

Paid Creative AI workflow skill. Use this skill when the user needs When the user wants to create AI-generated ad creative, test performance creative, manage creative fatigue, or optimize paid media with AI tools. Also use when the user mentions 'ad creative,' 'performance creative,' 'creative testing,' 'creative fatigue,' 'Meta ads,' 'Google ads,' 'TikTok ads,' 'AI ads,' 'ad budget,' 'ROAS,' 'Advantage+,' or 'Performance Max.' This skill covers AI-powered paid creative from generation through performance optimization. Do NOT use for technical implementation, code review, or software architecture and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs 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 and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

diegosouzapw/awesome-omni-skills

SEO-AEO Landing Page Writer workflow skill. Use this skill when the user needs 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 and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.

Habilidades Relacionadas