Guias

Agent Skills (SKILL.md) em todo agente de IA para programação: Claude Code, Codex, Cline, Amp e OpenHands (2026)

Onde cada agente de IA para programação procura skills SKILL.md, e uma única pasta de skill funciona em todos?

Todos esses agentes leem uma pasta com um arquivo SKILL.md cujo frontmatter YAML tem name e description. O Claude Code usa .claude/skills/ e ~/.claude/skills/. Codex, Amp e OpenHands usam .agents/skills/ no repo e ~/.agents/skills/ para você. O Cline usa .cline/skills/ e ~/.cline/skills/, e também lê .claude/skills/. O Amp também lê .claude/skills/. Então uma skill em .agents/skills/ cobre Codex, Amp e OpenHands, e uma cópia em .claude/skills/ cobre Claude Code, Cline e Amp.

Esta página é uma tradução do guia em inglês. Comandos, chaves de configuração e código não foram alterados; em caso de diferença, vale a versão em inglês. Ler em inglês → · Outros idiomas: 简体中文 · 日本語 · 한국어 · Español

Saiba quando a configuração mudar

Quando uma configuração, flag ou regra de permissão dessas ferramentas mudar, você recebe um e-mail semanal (em inglês), conferido na documentação oficial.

Resposta rápida: locais das pastas de skills

  • Claude Code: .claude/skills/NAME/SKILL.md (projeto) e ~/.claude/skills/NAME/SKILL.md (pessoal). Plugins também trazem skills, invocadas como /plugin-name:skill-name.
  • OpenAI Codex: .agents/skills na pasta onde você inicia o Codex, nas pastas pais até a raiz do repo, ~/.agents/skills, /etc/codex/skills (admin) e skills de sistema embutidas.
  • Cline: .cline/skills/ (recomendado), .clinerules/skills/ ou .claude/skills/ no projeto, e ~/.cline/skills/ globalmente.
  • Amp: .agents/skills/ e .claude/skills/ no projeto e nas pastas pais, ~/.config/agents/skills/, ~/.agents/skills/, ~/.config/amp/skills/, ~/.claude/skills/ e pastas listadas em amp.skills.path.
  • OpenHands: .agents/skills/NAME/SKILL.md no repo (os legados .openhands/skills e .openhands/microagents ainda funcionam) e ~/.agents/skills para o usuário.

Um SKILL.md que funciona em todos

Os cinco agentes aceitam o mesmo arquivo mínimo: frontmatter YAML com name e description, depois instruções em Markdown. Mantenha o name igual ao nome da pasta, porque o Cline e o OpenHands exigem que coincidam.

.agents/skills/release-notes/SKILL.md

---
name: release-notes
description: Draft release notes from recent commits. Use when the user asks for release notes or a changelog.
---

1. Read the commits since the last tag.
2. Group changes into Features, Fixes and Other.
3. Write the notes in plain Markdown.
  • Coloque em .agents/skills/release-notes/ para Codex, Amp e OpenHands.
  • Coloque a mesma pasta em .claude/skills/ para o Claude Code. O Cline e o Amp também leem essa pasta.
  • Escreva a description como um gatilho: o que a skill faz e quando usá-la. Claude Code, Codex, Cline e Amp decidem se carregam uma skill com base nesse texto.

Como executar uma skill

  • Claude Code: digite /skill-name, ou deixe o Claude carregá-la quando seu pedido corresponder à description. O texto depois do nome preenche $ARGUMENTS.
  • Codex: execute /skills ou digite $ e o nome da skill, ou deixe o Codex escolhê-la pela description.
  • Cline: digite / e escolha a skill, ou deixe o Cline carregá-la quando seu pedido corresponder.
  • Amp: o modelo vê o name e a description de cada skill e carrega o SKILL.md completo quando a skill é invocada. Instale skills com amp skill add <source>.
  • OpenHands: adicione uma lista triggers ao frontmatter para carregar uma skill só quando uma dessas palavras-chave aparecer em uma mensagem.

Impedir que o agente use uma skill por conta própria

  • Claude Code: disable-model-invocation: true no frontmatter. Aí só você pode executá-la.
  • Codex: policy.allow_implicit_invocation: false em agents/openai.yaml. Chamadas explícitas com $skill continuam funcionando. Para desativar uma skill por completo, adicione uma entrada [[skills.config]] com enabled = false ao ~/.codex/config.toml.
  • Cline: desative a skill na aba Skills do menu com o ícone de balança abaixo do chat.
  • Amp: defina amp.skills.disableClaudeCodeSkills para ignorar as pastas compatíveis com o Claude.
  • OpenHands: use uma lista triggers para que a skill carregue só com palavras-chave correspondentes.

Qual cópia vence quando os nomes coincidem

  • Claude Code: enterprise vence pessoal, e pessoal vence projeto. Uma skill vence um arquivo em .claude/commands/ com o mesmo nome.
  • Codex: skills com o mesmo nome não são mescladas; ambas aparecem no seletor.
  • Cline: uma skill global vence uma skill de projeto com o mesmo nome.
  • Amp: a primeira skill encontrada na sua ordem de busca vence.

Pegadinhas

  • O Codex limita a lista inicial de skills a 2% da janela de contexto (8.000 caracteres se o tamanho for desconhecido) e encurta primeiro as descriptions quando você tem muitas skills.
  • O Cline sugere manter o SKILL.md abaixo de 5k tokens; os metadados de cada skill custam cerca de 100 tokens na inicialização.
  • O Amp não recarrega skills em uma thread em execução quando você roda amp skills list em outro lugar. Peça ao Amp para recarregar suas skills.
  • O Claude Code incorporou os comandos personalizados às skills, então arquivos .claude/commands/*.md ainda criam comandos /name.

Guia completo de skills para cada agente

Fontes

Documentação oficial (em inglês) usada para conferir este guia. Versão em inglês revisada em: 2026-10-18

Mais guias em português