Skill (Habilidade)
Procedimento reutilizável escrito em Markdown, carregado pelo agente no momento certo. É o que substitui o chat eterno de treinamento.
O problema que a skill resolve
Você já fez isso: abriu um chat, passou horas explicando exatamente como quer uma thumbnail e, dali em diante, sempre que precisava de uma voltava naquele mesmo chat.
Reutilizar conhecimento é certo. O jeito está errado. Aquele chat é uma janela de contexto que você já esgotou, cheia de lixo acumulado, e você reingere tudo aquilo toda vez.
O que é
Skills são procedimentos reutilizáveis: arquivos de texto em Markdown que fazem coisas específicas e bem definidas. A característica central delas é serem instrução especializada carregada no momento certo, e não o tempo todo.
O ganho é padronizar processos complexos que se repetem, reduzir inconsistência e depender menos de sorte.
Onde elas moram
Todo harness tem uma pasta própria na sua máquina:
| Harness | Pasta | Arquivo global |
|---|---|---|
| Claude Code | .claude |
CLAUDE.md |
| OpenCode | .agents |
AGENTS.md |
| Gemini | .gemini |
GEMINI.md |
| Codex | .codex |
AGENTS.md |
Dentro de cada pasta de skill existe um arquivo SKILL.md. Abrindo, não tem mistério: é texto muito bem estruturado, como um prompt gigante e organizado.
Markdown é o melhor formato para trabalhar com IA, porque os modelos são treinados para interpretá-lo com facilidade.
Cuidado com o arquivo global
O CLAUDE.md e equivalentes são lidos 100% das vezes, em toda requisição. Ler a mesma coisa sempre lota a janela e desperdiça token. Ali só entra o que vale para todos os projetos: responda em português, seja conciso, registre alterações. Nada específico de projeto.
Como criar as suas
- Abra um chat e converse. Explique tudo que você quer e o que não quer.
- Quando ele finalmente fizer exatamente o que você queria, digite: “transforme todo esse processo numa skill”.
- Pronto. Nunca mais precisa do chat nem de repetir o briefing.
Funciona em qualquer harness, e vale para qualquer coisa padronizável: pesquisa de canais, roteiro, storyboard, revisão.