Brazilian Portuguese (pt-BR) Localization

    1

    Natural pt-BR for apps and sites: correct formats (R$ 1.234,56, 31/12/2026), native microcopy, and the translation mistakes that make Brazilians cringe.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Brazilian Portuguese (pt-BR) Localization

    Example session with this skill installed

    Translate these UI strings to Brazilian Portuguese: "Are you sure you want to delete this project?", "Submit", "Forgot your password?", "You have 0 items", "Price: $1,234.56 (BRL)". Show a table.

    • Read your context and instructions
    • Compiled the brazilian portuguese pt-br
    Original (EN)pt-BRNotes
    Are you sure you want to delete this project?Excluir este projeto? Essa ação não poderá ser desfeita.Evita "Você tem certeza que deseja...?". "Excluir" é o verbo padrão de interface. A frase explica a consequência.
    SubmitEnviar"Submeter" é calque e soa pouco natural. Botões usam o verbo no infinitivo.
    Forgot your password?Esqueceu a senha?Forma natural. "Senha esquecida?" soa como tradução literal.
    You have 0 itemsVocê tem 0 itensEm pt-BR o zero leva o plural. Em código, use ICU: {count, plural, one {# item} other {# itens}}. Para um estado vazio, Nenhum item por aqui também funciona.
    Price: $1,234.56 (BRL)Preço: R$ 1.234,56Usa ponto como separador de milhar e vírgula como decimal. Mostra R$ no lugar de "(BRL)".

    Dicas de implementação

    • Gere o valor em reais com Intl.NumberFormat('pt-BR', {style:'currency', currency:'BRL'}). Ele insere um espaço não separável depois de R$, então testes que comparam com um espaço normal vão falhar.
    • Se o item "Price" aceitar entrada do usuário, aceite 1234,56 e 1234.56. Nunca use parseFloat("1.234,56"), que retorna 1.234.
    • Trate o primeiro texto como pergunta de confirmação. O botão de confirmação deve dizer Excluir, e o outro Cancelar.

    Real output from a Claude Code session with this skill installed.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Bad translations alienate users. When software feels like a literal machine translation or uses European Portuguese (pt-PT) terms like "ecrã" instead of "tela," Brazilian users lose trust. This skill ensures your UI microcopy, data formats, and tone sound like they were written by a native Brazilian product designer.

    What it does

    • Localizes formats for currency (R$ 1.234,56), dates (31/12/2026), and phone numbers ((11) 91234-5678).
    • Corrects UI microcopy by replacing word-for-word translations with natural Brazilian phrasing, including infinitive verbs on buttons (Salvar, not Salve).
    • Identifies regionalisms to prevent pt-PT vocabulary or "gerundismo" from entering your pt-BR codebase.
    • Adjusts gendered phrasing to use neutral alternatives like "Boas-vindas" instead of gender-specific greetings.
    • Formats document and address fields: CPF, CNPJ and CEP masks, and the CEP-first address form order.

    How it works

    1. Submit UI strings or code snippets containing hardcoded English or machine-translated Portuguese text.
    2. Review the audit which lists the original text, the proposed fix, and a specific reason for the change.
    3. Implement formatting logic using provided Intl snippets to handle decimal commas and non-breaking spaces correctly.

    Frameworks & tools

    The skill provides implementation guidance for the Intl JavaScript API, ICU MessageFormat for complex plurals, and standard Brazilian document structures (CPF/CNPJ).

    Why this beats prompting it yourself

    Standard LLMs often blend pt-PT and pt-BR or miss technical nuances like the non-breaking space that Intl inserts after "R$" (which breaks naive string tests). This skill enforces specific Brazilian UX conventions, like using infinitive verbs for buttons, which general-purpose prompts frequently get wrong.

    Use cases

    • Converting an existing English React/Next.js frontend to natural Brazilian Portuguese.
    • Auditing a translation vendor's delivery to ensure they didn't use European Portuguese terms.
    • Designing a checkout flow with correct CEP-first address logic and properly formatted CPF fields.

    Known limitations

    This skill focuses on linguistic and format localization. It does not perform legal audits for LGPD compliance or provide functional code for third-party payment gateways.

    Focuses on linguistic and format localization. Does not provide legal LGPD audits or functional payment gateway code. Overflows may occur as pt-BR strings are 15-30% longer than English.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 16 days ago

    • Free with an Agensi account

    Permissions

    Write Files
    Read Files
    Listed16 days ago

    What's inside

    Frequently Asked Questions

    Standard LLMs often mix European Portuguese (pt-PT) with Brazilian Portuguese (pt-BR) or use awkward literal translations. This skill enforces specific Brazilian UX conventions, such as using infinitive verbs for buttons and formatting R$ amounts the way `Intl` does (including its non-breaking space).

    You will receive a set of linguistic rules, formatting guidelines for Brazilian-specific data types (like CPF and CEP), and implementation snippets for tools like the JavaScript Intl API and ICU MessageFormat.

    The skill is designed to work with your existing code snippets or UI string exports, providing audits and localized replacements that you can immediately integrate into your frontend codebase.

    This skill focuses on UI microcopy, cultural tone, and data formatting; it does not provide legal advice for LGPD (Brazil's data privacy law) or functional code for connecting to Brazilian payment gateways like Pix.

    Yes, the skill is optimized for modern web frameworks and provides specific guidance for i18n libraries, ensuring that complex elements like gender-neutral phrasing and pluralization are handled correctly.

    New in Translation & Localization