Skip to content

Harness engineering beginner tutorial, from 0 to 1

refactor: Add Portuguese (Brazil) translation for skills documentation

João Paulo Fricks32d61ee11098
diff --git a/skills/README-AR.md b/skills/README-AR.md
index 882cadc..0e819a3 100644
--- a/skills/README-AR.md
+++ b/skills/README-AR.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills
diff --git a/skills/README-CN.md b/skills/README-CN.md
index cad9c34..58bbffd 100644
--- a/skills/README-CN.md
+++ b/skills/README-CN.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills(技能集)
diff --git a/skills/README-DE.md b/skills/README-DE.md
index 5fb916f..0cb69bc 100644
--- a/skills/README-DE.md
+++ b/skills/README-DE.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills
diff --git a/skills/README-ES.md b/skills/README-ES.md
index 2d62625..57ca4d4 100644
--- a/skills/README-ES.md
+++ b/skills/README-ES.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills
diff --git a/skills/README-FR.md b/skills/README-FR.md
index 66e2492..e9f1a19 100644
--- a/skills/README-FR.md
+++ b/skills/README-FR.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills
diff --git a/skills/README-JA.md b/skills/README-JA.md
index 264ab5a..1c28818 100644
--- a/skills/README-JA.md
+++ b/skills/README-JA.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills
diff --git a/skills/README-KO.md b/skills/README-KO.md
index 53372af..7d28fb9 100644
--- a/skills/README-KO.md
+++ b/skills/README-KO.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# 스킬(Skills)
diff --git a/skills/README-PT-BR.md b/skills/README-PT-BR.md
new file mode 100644
index 0000000..24ebdc3
--- /dev/null
+++ b/skills/README-PT-BR.md
@@ -0,0 +1,73 @@
+# Skills
+
+Este diretório contém skills reutilizáveis de agentes de IA para o projeto Learn Harness Engineering. Cada skill é um template de prompt independente que pode ser carregado por agentes de programação com IA (Claude Code, Codex, Cursor, Windsurf, etc.) para executar tarefas especializadas.
+
+## Skills Disponíveis
+
+### harness-creator
+
+Skill de engenharia de harness para agentes de programação com IA em ambientes de produção. Ajuda a criar, avaliar e melhorar arquivos de harness de agentes (`AGENTS.md`, listas de funcionalidades, fluxos de verificação, mecanismos de continuidade de sessão).
+
+- **7 padrões de referência**: Persistência de Memória, Runtime de Skills, Engenharia de Contexto, Registro de Ferramentas, Coordenação Multiagente, Ciclo de Vida e Bootstrap, Armadilhas
+- **Templates**: `AGENTS.md`/`CLAUDE.md`, `feature-list.json`, `init.sh`, `progress.md`, `session-handoff.md`
+- **Scripts**: criação de estrutura, validação, renderização de avaliação em HTML, execução de benchmark estrutural
+- **10 casos de teste de avaliação integrados**
+
+Consulte [harness-creator/README.md](harness-creator/README.md) para a documentação completa.
+
+## Como o harness-creator Foi Criado
+
+A skill `harness-creator` foi desenvolvida usando a metodologia **skill-creator** — a meta-skill oficial da Anthropic para criar, testar e iterar sobre skills de agentes. O skill-creator fornece um fluxo de trabalho estruturado (rascunho → teste → avaliação → iteração) com executores de avaliação, avaliadores e um visualizador de benchmark integrados.
+
+- **Fonte do skill-creator**: [anthropics/skills — skill-creator](https://github.com/anthropics/skills/tree/main/skills/skill-creator)
+- **Documentação de skills do Claude Code da Anthropic**: [anthropics/claude-code — plugin-dev/skills](https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills)
+
+## Estrutura de Diretórios
+```
+skills/
+├── README.md # Este arquivo
+├── README-CN.md # Versão em chinês
+├── README-ZH-TW.md # Versão em chinês tradicional
+├── README-JA.md # Versão em japonês
+├── README-ES.md # Versão em espanhol
+├── README-FR.md # Versão em francês
+├── README-AR.md # Versão em árabe
+├── README-VI.md # Versão em vietnamita
+├── README-DE.md # Versão em alemão
+├── README-TR.md # Versão em turco
+├── README-PT-BR.md # Versão em português (Brasil)
+└── harness-creator/ # Skill de engenharia de harness
+ ├── SKILL.md # Definição principal do skill
+ ├── SKILL.md.en # Versão apenas em inglês
+ ├── README.md # Documentação detalhada
+ ├── metadata.json # Metadados e gatilhos do skill
+ ├── agents/ # Metadados da UI do skill
+ ├── scripts/ # Auxiliares de scaffold, validação, benchmark
+ ├── evals/ # Casos de teste
+ ├── templates/ # Templates de scaffold
+ └── references/ # Documentos de padrões detalhados
+```
+
+## Como as Skills Funcionam
+
+Cada skill segue uma estrutura padrão:
+
+1. **SKILL.md** — O ponto de entrada. Contém frontmatter YAML (nome, descrição para acionamento) e instruções em Markdown para o agente.
+2. **references/** — Documentos adicionais carregados no contexto conforme necessário.
+3. **templates/** — Templates iniciais que a skill pode gerar para os usuários.
+
+As skills utilizam divulgação progressiva — o agente primeiro visualiza apenas o nome + descrição, depois carrega o conteúdo completo do SKILL.md quando acionado e lê os recursos incluídos somente quando necessário.
+
+## Auditoria de Segurança
+
+Todos os arquivos deste diretório foram auditados para segurança:
+
+- Sem backdoors, URLs ocultas ou payloads codificados
+- Sem exfiltração de dados ou credenciais armazenadas diretamente no código
+- Sem vulnerabilidades de injeção de comandos
+- Os scripts utilizam apenas módulos nativos do Node.js
+- O `init.sh` gerado executa comandos de verificação detectados do projeto
+
+## Licença
+
+MIT
\ No newline at end of file
diff --git a/skills/README-TR.md b/skills/README-TR.md
index 9a3891d..4946ed1 100644
--- a/skills/README-TR.md
+++ b/skills/README-TR.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skill'ler
diff --git a/skills/README-VI.md b/skills/README-VI.md
index ce240e2..0f61d81 100644
--- a/skills/README-VI.md
+++ b/skills/README-VI.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills
diff --git a/skills/README-ZH-TW.md b/skills/README-ZH-TW.md
index cc84bf4..8669fd4 100644
--- a/skills/README-ZH-TW.md
+++ b/skills/README-ZH-TW.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills(技能集)
diff --git a/skills/README.md b/skills/README.md
index b24e176..e6c6be8 100644
--- a/skills/README.md
+++ b/skills/README.md
@@ -10,6 +10,7 @@
<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
<a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>
+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a>
</p>
# Skills
@@ -50,6 +51,7 @@ skills/
├── README-VI.md # Vietnamese version
├── README-DE.md # German version
├── README-TR.md # Turkish version
+├── README-PT-BR.md # Portuguese (Brazil) version
└── harness-creator/ # Harness engineering skill
├── SKILL.md # Main skill definition
├── SKILL.md.en # English-only version