Agent Skills virou padrão aberto: o que muda pro seu SKILL.md

O MCP virou padrão do mercado quando a Anthropic soltou a mão dele.

Agora ela fez o mesmo com as Agent Skills.

E aquela pasta .claude/skills que você escreveu pro seu Claude Code pode estar a um passo de rodar em qualquer agente.

Agent Skills são pastas com um arquivo SKILL.md que ensinam uma tarefa específica a um agente de IA, carregadas só quando a tarefa pede. Em 22 de outubro de 2026 a Anthropic doou o padrão Agent Skills para a Agentic AI Foundation, o fundo da Linux Foundation que já cuida do MCP. Neste post eu explico o que são agent skills de verdade, por que a doação importa mais do que parece e o que fazer com as skills que você já tem. Com exemplo real: as oito skills que montam este próprio blog.

TL;DR

• O que é: Agent Skills é o formato de pasta com um SKILL.md (mais scripts e referências) que ensina uma tarefa específica pra um agente. Desde 22/10/2026 o padrão pertence à Agentic AI Foundation, não mais à Anthropic.
• O que foi doado: a especificação, o nome e o logo, a organização no GitHub e o domínio agentskills.io.
• Quem já usa: mais de 70 plataformas integraram o formato desde dezembro de 2025, segundo a Anthropic. Entre elas ChatGPT, Cursor, GitHub Copilot e VS Code.
• Custo/Acesso: padrão aberto. Não precisa ser membro da fundação pra usar nem pra contribuir.
• O que fazer agora: validar suas skills contra a spec, separar o que é portável do que é amarrado ao Claude Code e revisar as description.

O contexto: por que a doação das Agent Skills importa

Volta um ano.

Em 9 de dezembro de 2025 a Linux Foundation anunciou a Agentic AI Foundation (AAIF) com três projetos fundadores: o MCP da Anthropic, o goose da Block e o AGENTS.md da OpenAI. A partir dali o MCP deixou de ser "o protocolo da Anthropic" e virou infraestrutura neutra. Concorrente não adota padrão de concorrente. Adota padrão de fundação.

As skills seguiram o mesmo roteiro, só que mais rápido. A Anthropic publicou o formato como padrão aberto em dezembro de 2025. Segundo o anúncio de 22/10, de lá pra cá mais de 70 plataformas de agente integraram o formato, cerca de 1 milhão de skills foram publicadas e quase 280 milhões de instalações aconteceram.

O que muda com a doação é a governança:

• A Anthropic entregou especificação, nome, logo, a org do GitHub e o domínio agentskills.io.
• Engenheiros da Anthropic, do Google, da OpenAI e de outras empresas mantêm o padrão como indivíduos, não como representantes de empresa. Os lead maintainers são David Soria Parra e Mahesh Murag.
• O roadmap anunciado tem três itens: releases versionadas, processo formal de proposta de mudança e guia de segurança pra quem escreve e instala skills.

Tradução pra dev: a spec do seu SKILL.md agora tem dono neutro, versão e processo de mudança. É o tipo de coisa que faz time de plataforma parar de tratar skill como "feature do Claude" e começar a tratar como formato de empacotamento de conhecimento.

E aqui mora o ponto que pouca gente percebe. O padrão não é o diferencial. Todo mundo vai ter acesso ao mesmo formato. O diferencial é o que você coloca dentro da pasta: o processo do seu time, o seu harness, o seu jeito de validar entrega. É esse tipo de engenharia que a gente destrincha toda semana no Clã Beer and Code, com quem está colocando agente em produção e não só lendo anúncio.

O que são agent skills, na prática

Uma skill é uma pasta. Só isso.

Dentro dela, no mínimo, um arquivo SKILL.md com frontmatter YAML e instruções em Markdown. Opcionalmente, pastas scripts/ (código executável), references/ (documentação que o agente lê quando precisa) e assets/ (templates, schemas, dados). Esse é o desenho da especificação oficial.

O frontmatter tem dois campos obrigatórios:

---
name: revisar-seo-post
description: Revisão de SEO on-page + trava de segurança do MCP que roda como GATE logo antes de publicar um post no blog Beer & Code. Acionar sempre que um post estiver pronto para subir ao MCP, ou quando o usuário pedir para revisar/auditar o SEO de um post.
---

As regras que a spec impõe:

• name: até 64 caracteres, só minúsculas, números e hífen. Não pode começar nem terminar com hífen, não pode ter hífen duplo. Tem que ser igual ao nome da pasta.
• description: até 1024 caracteres. Deve dizer o que a skill faz e quando usar.
• Opcionais: license, compatibility (até 500 caracteres, pra declarar requisito de ambiente), metadata (mapa chave-valor livre) e allowed-tools, que ainda é experimental e cada agente implementa do seu jeito.

Carregamento progressivo: o detalhe que faz skill funcionar

Skill não é prompt gigante colado no contexto. O agente carrega em três camadas, conforme a spec:

1. Metadados (~100 tokens por skill): só name e description entram no contexto na largada, de todas as skills instaladas.
2. Instruções (recomendado abaixo de 5.000 tokens): o corpo inteiro do SKILL.md só é carregado quando o agente decide ativar aquela skill.
3. Recursos (sob demanda): arquivos de scripts/, references/ e assets/ só entram quando a tarefa pede.

Por isso você pode ter dezenas de skills instaladas sem afogar o modelo. E por isso a description é o campo mais importante da pasta inteira. Ela é a única coisa que o agente vê antes de decidir. Description vaga, skill que nunca dispara. Description que promete demais, skill que dispara na hora errada.

É engenharia de contexto aplicada, a mesma lógica que a gente discutiu quando a Anthropic cortou o system prompt do Claude Code: o que entra sempre no contexto tem que ser mínimo e certeiro.

Raio-X: as skills que montam este blog

Este post foi produzido por um pipeline de skills do Claude Code. Então dá pra usar o próprio pipeline como cobaia.

Rodei uma checagem simples nas oito skills de .claude/skills/ do repositório editorial:

for f in .claude/skills/*/SKILL.md; do
  dir=$(basename "$(dirname "$f")")
  name=$(awk '/^name:/{print $2; exit}' "$f")
  desc=$(awk '/^description:/{sub(/^description: /,""); print; exit}' "$f")
  echo "$dir name=$name desc_chars=$(printf %s "$desc" | wc -m) lines=$(wc -l < "$f")"
done

Resultado:

Três leituras:

Todas passam no básico. name bate com o nome da pasta, só minúscula e hífen. Nenhum SKILL.md chega perto do teto recomendado de 500 linhas.

A minerar-evergreen está colada no limite. 930 de 1024 caracteres de description. Funciona hoje. Mas é a skill que vai quebrar primeiro se alguém acrescentar "mais um gatilho". E description longa demais é sintoma: ela está tentando fazer roteamento que deveria estar no corpo.

A portabilidade é o problema real, não o formato. A criar-post-blog tem scripts/ e references/ bonitinhos, tudo dentro do padrão. Mas o passo de áudio manda delegar a reescrita do roteiro pra um subagent do Claude Code (roteiro-narracao) via Agent tool. E a publicação depende do MCP do blog configurado na sessão. O SKILL.md é portável. O ambiente que ele pressupõe não é.

Esse é o ponto que ninguém fala quando comemora o "padrão aberto". O formato da pasta viaja. As dependências do harness, não.

O que fazer com as skills que você já tem

Não precisa migrar nada amanhã. A Anthropic deixa claro no anúncio que dá pra continuar usando o padrão como está. Mas tem quatro coisas que valem a meia hora.

Passo 1: valide contra a spec

O padrão tem uma biblioteca de referência, a skills-ref, que checa frontmatter e convenção de nomes:

skills-ref validate .claude/skills/criar-post-blog

Erro comum: pasta com nome CriarPost e name: criar-post. No Claude Code isso pode até rodar. Num agente que segue a spec ao pé da letra, não carrega.

Passo 2: declare o que é amarrado ao harness

Se a skill depende de subagent, hook, MCP específico ou ferramenta do Claude Code, diga isso no campo compatibility:

---
name: criar-post-blog
description: Cria, agenda e publica posts completos no blog Beer & Code...
compatibility: Designed for Claude Code. Requires the beer-and-code-blog MCP server, ffmpeg, aws CLI and the roteiro-narracao subagent.
---

E, dentro do corpo, escreva o fallback. "Se não houver subagent disponível, faça X." Quem abrir a skill em outro agente sabe na hora o que vai funcionar e o que não vai.

Passo 3: trate a description como roteador

Ela é carregada sempre, em todas as sessões, junto com as descriptions de todas as outras skills. Então:

• Comece pelo que a skill faz, em uma frase.
• Liste os gatilhos reais ("quando o usuário pedir X, Y ou Z").
• Diga o que ela não faz, se houver skill vizinha que pode ser confundida. As skills deste blog fazem isso: a planejar-pauta avisa que não escreve post e aponta pra criar-post-blog.
• Corte o resto. Detalhe de processo vai pro corpo, não pra description.

Passo 4: leia skill de terceiro antes de instalar

Um milhão de skills publicadas significa um milhão de pastas com instruções e scripts que o seu agente vai executar com as suas permissões. Skill é código. O próprio roadmap da fundação inclui guia de segurança pra quem instala, e não é à toa. A gente já viu um repositório "limpo" fazer o Claude Code instalar malware. Skill com scripts/ é o mesmo vetor, com convite formal.

E o Codex, o Gemini CLI, o Cursor?

Aqui é preciso separar o que está anunciado do que é aposta.

Anunciado: o post da Anthropic cita ChatGPT, Cursor, GitHub Copilot e VS Code entre as plataformas que já integraram Agent Skills. Do lado do Google, um codelab oficial do Gemini CLI mostra uma skill com SKILL.md na pasta .agents/skills sendo descoberta e usada pelo Gemini CLI.

Não confirmado no anúncio: o Codex aparece no texto da Anthropic só como um dos agentes pra quem devs escreveram loaders de skill em outubro de 2025. Suporte nativo e oficial do Codex ao padrão, sob a governança da AAIF, eu não encontrei anunciado. Trate como possibilidade, não como fato.

Repare também no caminho: .claude/skills é convenção do Claude Code, .agents/skills aparece no lado do Gemini CLI. A spec define o formato da pasta, não onde ela mora. Com releases versionadas e processo de proposta, é bem provável que um diretório comum vire assunto. Até lá, um symlink resolve:

mkdir -p .agents
ln -s ../.claude/skills .agents/skills

Limitações e pontos de atenção

• Formato portável não é comportamento portável. Modelos diferentes interpretam a mesma instrução de jeitos diferentes. Uma skill afinada pro Claude pode precisar de ajuste em outro agente. Sem eval, você não sabe.
• allowed-tools é experimental. A spec avisa que o suporte varia entre implementações. Não use esse campo como controle de segurança.
• A spec ainda vai mudar. Releases versionadas e processo formal de proposta estão no roadmap, não entregues. Acompanhe o agentskills.io e o GitHub antes de construir ferramenta interna em cima de detalhe da spec.
• Skill não substitui MCP nem AGENTS.md. MCP conecta o agente a ferramentas e dados. AGENTS.md (ou CLAUDE.md) é contexto fixo do projeto. Skill é conhecimento procedural carregado sob demanda. As três coisas convivem, e as três agora moram na mesma fundação.

FAQ rápido

O que são agent skills? São pastas com um arquivo SKILL.md (frontmatter com name e description mais instruções em Markdown) e, opcionalmente, scripts, referências e assets. O agente lê só nome e descrição na largada e carrega o resto quando a tarefa pede. É o formato que a Anthropic criou e agora doou pra Agentic AI Foundation.

Qual a diferença entre Claude skills e Agent Skills? Nenhuma no formato. "Claude skills" é como muita gente chama as skills no ecossistema da Anthropic. Agent Skills é o nome do padrão aberto, agora sob a AAIF. O SKILL.md que roda no Claude Code segue a mesma especificação.

Preciso mudar minhas skills por causa da doação? Não. A Anthropic diz que o padrão continua utilizável como está. Vale validar com o skills-ref, declarar dependências no campo compatibility e enxugar descriptions longas.

Qual a diferença entre skill e MCP? O MCP expõe ferramentas e dados pro agente por um protocolo. A skill ensina o agente a executar um processo, podendo usar essas ferramentas. Se quiser o lado do protocolo, o post sobre o que é MCP cobre a arquitetura.

Conclusão

A Anthropic repetiu com as Agent Skills o movimento que fez o MCP virar padrão: tirou o formato de casa e entregou pra uma fundação neutra, com mantenedores de Google e OpenAI na mesa.

Pra quem já escreve SKILL.md, a mudança imediata é pequena. A de médio prazo é grande. Sua pasta de skills deixa de ser configuração do Claude Code e vira um ativo portável do time.

Desde que você separe o que é processo do que é harness.

Se você ainda está montando a base, o post sobre hooks, slash commands e MCPs mostra as outras peças do harness onde as skills se encaixam.