humanizador-pt-br

Files (1)

• SKILL.md

SKILL.md (first lines)

# Text Humanizer — Brazilian Portuguese

Rewrite the provided text by removing AI-generation traces while preserving the author's voice, domain knowledge, and communicative intent.

## Core Principles

1. **Preserve the author's voice.** Do not homogenize style — if the author uses short, direct sentences, keep them. If they use more elaborate language, keep the register.
2. **Remove AI traces, not content.** Technical knowledge, arguments, and data remain intact.
3. **Naturalness over correctness.** A text that is "too correct" sounds artificial. Small rhythm variations, occasional longer sentences, and looser transitions are welcome.
4. **Brazilian context.** Respect regional variations, formal/informal registers, and the Brazilian cultural ecosystem.

## AI Traces to Remove

### 1. Excessive Formality

AI-generated text tends toward a formal-culto register even when inappropriate.

| AI Tell | Replace With |
|---|---|
| "Faz-se necessário" | "É preciso" / "Precisa" |
| "Ressalta-se" | "Vale destacar" / "Importante:" |
| "Outrossim" | "Além disso" / "Também" |
| "Destarte" | "Assim" / "Dessa forma" |
| "Doravante" | "Daqui em diante" / "A partir daqui" |
| Voz passiva em excesso | Voz ativa quando possível |

### 2. Generic Transition Crutches

AI overuses predictable connectors. Vary or remove them.

| AI Tell | Alternatives |
|---|---|
| "Além disso," (repetido) | "Também", "Outro ponto:", "Some-se a isso", "Fora isso", ou simplesmente justaponha |
| "Portanto," (repetido) | "Com isso", "Daí", "Por isso", "Logo", ou inferência implícita |
| "É importante ressaltar que" | Corte. Se é importante, o conteúdo mostrará. |
| "Não obstante" | "Mesmo assim", "Ainda assim", "Dito isso" |
| "Ademais" | "Além do mais", "E mais:", "Inclusive" |
| "Contudo" / "Todavia" | "Mas", "Só que", "Porém", "Acontece que" |

### 3. Anglicized Sentence Structures

Structures that sound like literal translations from English.

| AI Tell | Adjustment |
|---|---|
| "Isso permite que você [verbo]" | "Com isso você [verbo]" / "Assim dá para [verbo]" |
| "De forma a [verbo]" | "Para [verbo]" |
| "O fato de que" | Corte ou "Que" |
| "Em ordem de [verbo]" | "Para [verbo]" |
| Sujeito genérico "você" onde "a gente" seria mais natural | Use "a gente" em contextos informais |
| "É capaz de [verbo]" | "Consegue [verbo]" / "Dá para [verbo]" |

### 4. Repetition and Redundancy

AI frequently says the same thing in different ways within the same paragraph as a filler strategy.

- Identify sentences that repeat the same idea with different words
- Keep the clearest version, cut the redundant one
- Especially common in introductions and conclusions

### 5. Mechanical Enumeration

Lists with "Primeiramente... Em segundo lugar... Por fim..." sound artificial.

- Prefer a looser structure: markers, thematic paragraphs, or numbering only when order matters
- Avoid "Primeiramente" — use "Primeiro", "Para começar", or jump straight to the point

### 6. Excessively Neutral or "Corporate" Tone

AI avoids strong opinions, metaphors, humor, and vivid language.

- If the author has a clear position, let it show
- Brazilian metaphors and analogies are welcome (futebol, culinária, cotidiano)
- A touch of calculated informality humanizes: "Olha,", "Sabe quando...", "A real é que..."

## Regional Variations — "Você" vs "Tu"

Respect the register and region:

- **Sudeste/Centro-Oeste (default):** "você" com conjugação de 3ª pessoa
- **Sul (Porto Alegre, Florianópolis):** "tu" com conjugação correta (tu fizeste, tu vieste) em contextos informais
- **Nordeste:** "tu" pode aparecer com conjugação de 3ª pessoa informal (tu vai, tu faz)
- **Rio de Janeiro:** "você" mas com chiado característico; "a gente" muito frequente
- **São Paulo:** "você" e "a gente" padrão; informal tende a "cê" (cê viu? cê sabe?)

> Rule of thumb: If the text has no clear regional marker, use the default Sudeste "você". If the author has shown a regional preference, respect it.

## Formal vs Informal Register

- **Formal:** Adequado para documentos técnicos, relatórios, artigos, comunicação corporativa externa. Mantenha certa formalidade mas elimine o artificial.
- **Informal:** Adequado para mensagens, tutoriais, posts de blog, comunicação interna. Use contrações (pra, num, tá), "a gente", frases mais curtas.
- **Intermediate (recommended when in doubt):** Formal o suficiente para ser profissional, informal o suficiente para ser lido como humano. É o tom de uma boa conversa técnica entre colegas.

## Before and After Examples

### Example 1: Corporate Speech

**Before (AI):**
> Faz-se necessário ressaltar que a implementação de metodologias ágeis permite que as equipes de desenvolvimento obtenham resultados superiores. Além disso, é importante destacar que a comunicação entre stakeholders deve ser priorizada. Portanto, recomenda-se a adoção de cerimônias como daily standups e retrospectivas.

**After (Humanized):**
> Metodologias ágeis trazem resultados melhores para times de desenvolvimento. Um ponto-chave: a comunicação entre stakeholders precisa ser prioridade. Daí a importância de cerimônias como daily standups e retrospectivas.

### Example 2: Technical Tutorial

**Before (AI):**
> Primeiramente, é necessário instalar as dependências do projeto. Em segundo lugar, você deve configurar as variáveis de ambiente de acordo com as suas necessidades específicas. Por fim, execute o comando de build para gerar os artefatos.

**After (Humanized):**
> Comece instalando as dependências:
> ```bash
> npm install
> ```
> Depois configure as variáveis de ambiente — ajuste os valores pro seu contexto. Aí é só rodar o build:
> ```bash
> npm run build
> ```

### Example 3: Technical Analysis

From hcb2019/claude-code-skills, MIT.

More from hcb2019/claude-code-skills