Em 22 de outubro de 2026, durante a AGNTCon + MCPCon North America em San Jose, a Agentic AI Foundation anunciou quatro novos projetos. Aquele que impacta diretamente qualquer equipe que utiliza agentes de código é o Agent Skills, o formato SKILL.md, contribuído pela Anthropic. Os outros três são o Open Responses da OpenAI, o OpenEnv da Hugging Face e o OpenSandbox da Alibaba. A fundação, vinculada à Linux Foundation, agora abriga 10 projetos, incluindo MCP, A2A, AGENTS.md e goose.
O post sobre a doação publicado pela Anthropic detalha o que foi transferido: o nome e o logotipo do Agent Skills, a organização no GitHub, o domínio agentskills.io e o próprio padrão. Ele também apresenta números de adoção compilados pela própria Anthropic: mais de 70 plataformas de agentes já integraram o Agent Skills desde o lançamento da especificação em dezembro de 2025, além de "1 milhão de skills publicadas e quase 280 milhões instaladas".
À primeira vista, parece apenas uma notícia burocrática sobre governança — e em grande parte é. No entanto, ela resolve uma questão prática para quem utiliza o Claude Code em uma tarefa e o Codex em outra: uma skill é apenas um recurso proprietário de um fornecedor ou um formato padronizado no qual vale a pena investir? Agora, trata-se de um formato com um guardião neutro.
Resumo (TL;DR)
O Agent Skills agora é um projeto neutro hospedado na Agentic AI Foundation, mantido por engenheiros da Anthropic, Google, OpenAI e outras empresas atuando de forma independente. Nada mudou na estrutura do arquivo em 22 de outubro. Seus arquivos SKILL.md existentes continuam funcionando normalmente, e os produtos que os carregam continuam buscando nos mesmos diretórios. O que realmente mudou foi quem define os rumos das próximas versões. Para equipes de desenvolvimento, a melhor prática é criar skills utilizando exclusivamente os seis campos oficiais da especificação, manter uma única cópia por repositório e permitir que cada agente a localize.
Entenda o Agent Skills em uma seção
Uma skill nada mais é do que um diretório contendo um arquivo SKILL.md: um frontmatter em YAML com ao menos name e description, seguido de instruções em Markdown. O diretório também pode incluir pastas como scripts/, references/ e assets/. A especificação é concisa e pode ser lida em dez minutos.
As skills mantêm um consumo baixo de tokens graças à divulgação progressiva (progressive disclosure). Na inicialização, o agente carrega apenas o nome e a descrição de cada skill — cerca de 100 tokens por skill, de acordo com a especificação —, lê o conteúdo completo do SKILL.md apenas quando uma tarefa corresponde a ela e só acessa os arquivos anexados quando as instruções solicitarem explicitamente.
Para uma explicação mais detalhada e dicas sobre como auditar skills de fontes públicas, confira o que é uma Skill para agentes de código.
O que muda com a transição — e o que permanece igual
| Antes de 22 de outubro | Depois | |
|---|---|---|
| Proprietário do nome, logo, org no GitHub e domínio | Anthropic | Agentic AI Foundation |
| Mantenedores | Publicado sob a organização da Anthropic | Engenheiros da Anthropic, Google, OpenAI e outras empresas, a título individual; David Soria Parra e Mahesh Murag foram nomeados Lead Maintainers |
O formato SKILL.md |
Especificação em agentskills.io | Mesma especificação, mesma URL |
| Onde os produtos buscam as skills | Critério de cada produto | Continua sendo critério de cada produto |
| Extensões específicas de cada produto | Definidas por produto | Continuam definidas por produto |
| Roadmap | Não formalizado | A Anthropic propõe versões formais de lançamento, um processo formal de propostas e diretrizes de segurança para autores e usuários de skills |
Três pontos mudam. Primeiro, a posse da marca e da infraestrutura: o nome, o domínio e a organização no GitHub não pertencem mais ao fornecedor de um produto que compete diretamente com as outras ferramentas que leem o formato. Segundo, os participantes das decisões técnicas: engenheiros da Anthropic, Google e OpenAI agora mantêm em conjunto um formato que seus produtos já suportam nativamente. Terceiro, um processo padronizado está sendo estruturado, e você não precisa se filiar à fundação para contribuir.
Por outro lado, três pontos não mudam — e são justamente os que afetam o seu repositório. O formato do arquivo é rigorosamente o mesmo de 21 de outubro. A especificação ainda não dita onde as skills devem residir; ela apenas define o conteúdo de um diretório de skill, deixando para cada ferramenta decidir quais pastas escanear. Além disso, extensões proprietárias continuam sendo extensões proprietárias: um campo que um agente interpreta perfeitamente pode ser simplesmente rejeitado por outro.
Um detalhe demonstra o quanto essa transição é recente: em 26 de outubro, o guia de contribuição do repositório ainda mencionava que pedidos de uso do logotipo "são revisados pela equipe da Anthropic", e a página da especificação não exibia nenhum número de versão. Versões formais estão previstas no roadmap proposto, mas ainda não foram lançadas. Na prática, trate a especificação como estável no uso real e sem versão formal no papel.
Escreva uma skill uma única vez e use-a em múltiplos agentes
Veja a seguir um exemplo mínimo de skill em total conformidade com a especificação. O campo name aceita letras minúsculas, números e hífens, com no máximo 64 caracteres, correspondendo exatamente ao nome do diretório. O campo description descreve o propósito da skill e quando executá-la, respeitando o limite de 1.024 caracteres. Todos os demais campos são opcionais.
.agents/skills/migration-review/
├── SKILL.md
└── references/
└── CHECKLIST.md
---
name: migration-review
description: Reviews a database migration before it merges. Checks reversibility, locking on large tables, and data backfills. Use when a diff adds or changes files under migrations/ or the user asks for a migration review.
license: Apache-2.0
metadata:
owner: platform-team
version: "1.2"
---
# Migration review
1. List every migration file in the diff.
2. For each one, confirm a down migration exists, or state why it cannot.
3. Flag any ALTER TABLE on a table listed in references/CHECKLIST.md as large.
4. Flag backfills that run inside the migration instead of a separate job.
5. Report one line per file: PASS, or FAIL with the reason.
Do not edit the migration. Report only.
Os valores de metadata são definidos entre aspas porque a especificação define metadata como um mapa de chaves e valores do tipo string. O arquivo de referência fica localizado um nível abaixo de SKILL.md, exatamente como recomenda a documentação. Valide a estrutura com o validador de referência antes de adotá-la em produção:
skills-ref validate ./.agents/skills/migration-review
Agora chegamos ao ponto que a fundação não padroniza: os caminhos de descoberta (discovery paths). A documentação de skills do Codex lista .agents/skills na raiz do repositório e $HOME/.agents/skills para o usuário. Já a documentação do Claude Code indica .claude/skills/<skill-name>/SKILL.md para projetos e ~/.claude/skills/ para o perfil individual. Ambas as ferramentas oferecem suporte a links simbólicos (symlinks). Portanto, a estratégia ideal é manter uma única cópia física em .agents/skills — convenção que o guia de implementação de clientes recomenda que as ferramentas monitorem — e criar um link simbólico para o Claude Code:
mkdir -p .claude/skills
ln -s ../../.agents/skills/migration-review .claude/skills/migration-review
git add .agents/skills .claude/skills
Um único diretório, uma única revisão de código, um único lugar para atualizar. Ferramentas que já monitoram .agents/skills nativamente não exigem symlinks adicionais; consulte a documentação de cada uma.
Três regras para garantir a portabilidade das suas skills:
- Use somente os seis campos da especificação (
name,description,license,compatibility,metadata,allowed-tools) na cópia compartilhada. A documentação do Claude Code informa que uploads no claude.ai e na Skills API rejeitam qualquer chave extra com um erro impeditivo, enquanto a CLI do Claude Code tolera extensões comocontext: fork. - Encare
allowed-toolscomo uma sugestão. A especificação classifica esse campo como experimental, e o suporte varia amplamente entre os agentes. - Mantenha configurações proprietárias fora do frontmatter compartilhado. O Codex lê opções adicionais de interface e execução a partir de um arquivo
agents/openai.yamldentro da pasta da skill, o qual é simplesmente ignorado por outros agentes.
Padronize no formato compartilhado quando mais de um agente — ou mais de um desenvolvedor — interagir com o mesmo repositório. Evite o excesso de formalidade quando apenas um desenvolvedor usar um único agente: manter uma skill pessoal no diretório nativo dessa ferramenta é perfeitamente aceitável, e a portabilidade pode ser implementada quando um segundo agente entrar no fluxo.
A governança da segurança continua sendo sua responsabilidade
Ter um guardião neutro para a especificação não torna nenhuma skill segura por padrão. O guia de implementação de clientes alerta que skills em nível de projeto são lidas diretamente do repositório em que se está trabalhando — que pode ser um clone recém-baixado de uma fonte de terceiros — e recomenda que os agentes exijam uma confirmação de confiança antes de executá-las. O roadmap sugerido pela Anthropic prevê diretrizes de segurança tanto para desenvolvedores quanto para instaladores de skills, o que evidencia que tais diretrizes ainda não existem de forma consolidada.
Até que sejam oficializadas, avalie cada skill como você avaliaria uma dependência de código: inspecione o SKILL.md e todos os scripts anexados antes que qualquer agente os execute, restrinja os comandos ao princípio do menor privilégio e nunca exponha segredos ou credenciais. Com 1 milhão de skills já publicadas, segundo a Anthropic, o desafio não é a disponibilidade. O gargalo é a auditoria.
Como o Sharkly se posiciona
Um formato padronizado responde à pergunta: "este arquivo funciona no meu agente?". No entanto, ele não determina qual agente tem acesso a qual skill, quem tem permissão para editá-la e onde os resultados são consolidados. Essa complexidade de gestão se multiplica a cada novo agente integrado à equipe.
No Sharkly, uma Skill adota o arquivo SKILL.md como ponto de entrada, com name e description em YAML seguidos pelas instruções, de acordo com a documentação de Skills. É possível fazer upload de um SKILL.md, arquivo .skill, arquivo ZIP ou pasta inteira; importar a partir de uma URL pública suportada; ou importar Skills já identificadas pelo Runtime de um Computer. Como as importações geram instâncias gerenciadas, a documentação recomenda revisá-las antes de vinculá-las. Toda Skill possui um escopo definido no momento da criação (Organization, Space ou Agent), e as permissões de edição são restritas ao criador e aos Administradores ou Proprietários da Organização. O artigo Sharkly Skills explora detalhadamente cada uma dessas opções.
A vinculação ocorre diretamente no Agent, que é também onde você define o Runtime. Uma Crew é "um grupo reutilizável de pessoas e agentes coordenado por um agente líder", conforme a documentação de Crews, e cada agente membro preserva sua própria configuração individual. Dessa forma, uma Crew cujo líder roda em Claude Code e cujo revisor roda em Codex pode vincular a mesma Space Skill, consolidando as respostas de todos os membros na mesma Task. Os agentes pesquisam, executam, testam e reportam; as pessoas decidem quais Skills recebem autoridade na equipe e aprovam as entregas finais.
Você pode sincronizar suas skills manualmente usando um único diretório e links simbólicos em cada repositório, ou utilizar o Sharkly para gerenciar quais agentes têm acesso a elas à medida que a equipe se expande. Para entender como operar ambos os agentes em paralelo, o artigo Claude Code e Codex em uma mesma base de código aborda a configuração prática de worktrees.
Perguntas frequentes (FAQ)
O formato do Agent Skills mudou após a transferência para a Agentic AI Foundation? Não. O anúncio oficial transferiu o nome, a identidade visual, a organização no GitHub, o domínio e o controle da especificação. O padrão disponível em agentskills.io é rigorosamente o mesmo arquivo, e as skills já criadas no padrão SKILL.md continuam funcionando perfeitamente.
Quem é responsável pela manutenção do Agent Skills agora? Engenheiros da Anthropic, Google, OpenAI e outras empresas, atuando a título individual, tendo David Soria Parra e Mahesh Murag como Lead Maintainers, conforme divulgado pela Anthropic. A empresa propôs a adoção de releases versionados e um processo formal de submissão de melhorias, mas nenhum dos dois foi implementado até o momento.
Quais agentes já suportam o Agent Skills? A Anthropic afirma que mais de 70 plataformas oferecem suporte, citando ferramentas como ChatGPT, Cursor, GitHub Copilot e VS Code. O catálogo de clientes em agentskills.io lista produtos como Claude Code, Codex, Gemini CLI, OpenCode, Goose e OpenHands. Como cada ferramenta escolhe onde buscar as skills, consulte a documentação de cada uma.
Preciso me associar à fundação para criar ou contribuir com skills? Não. O anúncio da Anthropic esclarece que é possível continuar utilizando e contribuindo com a especificação sem qualquer filiação, e sugestões para o padrão podem ser enviadas diretamente pelo servidor do projeto no Discord.
Uma skill desenvolvida para o Claude Code funcionará no Codex? Desde que o frontmatter utilize estritamente os seis campos oficiais da especificação e o arquivo esteja localizado em um diretório monitorado pelo Codex, sim. Extensões específicas do Claude Code, como context: fork, não serão interpretadas, devendo ser mantidas fora da versão compartilhada. Além disso, compatibilizar skills é apenas uma parte da transição; nosso guia sobre como manter o contexto ao alternar entre agentes de código explica o restante do fluxo.
