O que são Agent Skills?
O conjunto de competências que transforma uma IA passiva em um agente proativo e autônomo.
Autonomia
Capacidade de tomar decisões e executar tarefas sem supervisão constante.
Raciocínio
Decomposição de problemas complexos em passos lógicos e acionáveis.
Uso de Tools
Habilidade de interagir com APIs, bancos de dados e sistemas externos.
Adoção
As habilidades dos agentes são suportadas por ferramentas de desenvolvimento de IA de ponta.
Explosão do Ecossistema
Métricas de Adoção e Crescimento (Q1 2026)
O crescimento das agent skills e do repositório OpenClaw mostra uma adoção explosiva. Passe o mouse sobre o gráfico para explorar os dados detalhados de cada data.
Figura 1: Tendência de crescimento das agent skills. De acordo com a renomada plataforma skills.sh, o número de habilidades registradas experimentou um crescimento rápido de meados de janeiro até o início de fevereiro de 2026, ultrapassando 40.000 até o início de fevereiro. No mesmo período, a popular aplicação de skills de código aberto OpenClaw (OpenClaw Community, 2026) teve um aumento acentuado de estrelas no GitHub, atingindo mais de 25.000 estrelas em um único dia no final de janeiro, seguido por um declínio gradual, com o número total de estrelas ultrapassando 170 mil.
Especificação
O formato Agent Skills é um padrão aberto e extensível para definir capacidades que podem ser descobertas e utilizadas por agentes de IA em qualquer ambiente.
Estrutura de Diretórios
Um diretório contendo SKILL.md
(obrigatório) e pastas opcionais para scripts/,
references/ e assets/.
Formato SKILL.md
Arquivo Markdown com YAML frontmatter contendo
name, description, license e
compatibility.
---
name: data-analysis
description: Analyze complex datasets...
compatibility: Requires python, pandas
---
# Data Analysis Skill
Instructions for the agent...Arquitetura da Skill
Representação hierárquica da estrutura padrão de uma habilidade, garantindo modularidade e fácil descoberta pelos agentes.
Como Funciona o Skill Router
Arquitetura de 3 níveis para carregamento inteligente de skills
O Skill Router atua como um despachante semântico: recebe a query do usuário, identifica a intenção e carrega progressivamente apenas os dados necessários — preservando a context window.
Figura 2: Arquitetura do Skill Router em 3 níveis. O Level 1 (Metadata) é sempre carregado e custa apenas ~30 tokens por skill — inclui apenas nome e descrição no frontmatter YAML. O Level 2 (Instructions) é injetado sob demanda quando o router detecta um match semântico, consumindo entre 200 e 2.000 tokens. O Level 3 (Resources) contém scripts, referências e assets que só são carregados quando explicitamente solicitados pelo corpo do SKILL.md, com custo potencialmente ilimitado na context window.
Anatomia de uma Skill
Como o arquivo SKILL.md organiza o conhecimento do agente
O arquivo SKILL.md não é apenas documentação; é o cérebro modular da
habilidade. Ele define o que a skill faz, como deve ser usada e quais regras devem ser seguidas.
Figura 3: Estrutura interna de uma Skill. O
diretório da skill contém o arquivo central SKILL.md, que se desdobra em
quatro camadas críticas: Metadata (definição e compatibilidade),
Instructions (orientação principal por markdown), Guardrails (limites
e segurança) e Scripts Rules (lógica executável e pontos de entrada).
Campos do SKILL.md
| Campo | Obrigatório | Restrições |
|---|---|---|
| name | Sim | Máximo de 64 caracteres. Somente letras minúsculas, números e hífens. Não deve começar nem terminar com hífen. |
| description | Sim | Máximo de 1024 caracteres. Descreve o que a habilidade faz e quando usá-la. |
| license | Não | Nome da licença ou referência a um arquivo de licença incluído. |
| compatibility | Não | Máximo de 500 caracteres. Indica os requisitos do ambiente (produto pretendido, pacotes, acesso à rede, etc.). |
| metadata | Não | Mapeamento arbitrário de chave-valor para metadados adicionais. |
| allowed-tools | Não | Lista delimitada por espaços de ferramentas pré-aprovadas que a habilidade pode usar. (Experimental) |
Regras do Campo: name
Especificações obrigatórias:
- Deve ter entre 1 e 64 caracteres.
-
Pode conter apenas caracteres alfanuméricos minúsculos Unicode e hífens
(
a-ze-). -
Não deve começar nem terminar com
-. -
Não deve conter hífens consecutivos (
--). - Deve corresponder ao nome do diretório pai.
Exemplos de Nomes
Exemplos Válidos
Exemplos Inválidos
Regras do Campo: description
Diretrizes de Preenchimento:
- Deve ter entre 1 e 1024 caracteres.
- Deve descrever a função e quando usar a habilidade.
- Deve incluir palavras-chave para ajudar na identificação pelos agentes.
Campo: allowed-tools
- Uma lista de ferramentas pré-aprovadas para execução, separadas por espaços.
- O suporte para este campo pode variar entre as implementações do agente.
Conteúdo Corporal
O corpo em Markdown após o frontmatter contém as instruções da habilidade. Não há restrições de formatação. Escreva o que for necessário para ajudar os agentes a executar a tarefa com eficácia.
Nota Técnica
O agente carregará todo este arquivo assim que decidir ativar uma habilidade.
Considere dividir SKILL.md conteúdos mais longos em arquivos referenciados.
Seções Recomendadas:
-
Instruções passo a passo
-
Exemplos de entradas e saídas
-
Casos extremos comuns
Exemplo Real: apresentacao-cards
Praticando o que pregamos.
"Esta apresentação que você está assistindo foi gerada automaticamente através do design pattern Agent Skills, utilizando o skill específico de montagem de slides."
Estrutura do Skill
---name:apresentacao-cardsdescription:Motor de montagem atômica para criar apresentações interativas em HTML/Tailwind usando componentes Glassmorphism modulares...---# Skill: Apresentação de Dados em Cards...## 📝 Instruções de ExecuçãoVocê deve atuar como um engenheiro de front-end...
Documentação Completa
Explore o framework definitivo para o desenvolvimento de agentes autônomos de nova geração.
-
Guias Detalhados Arquitetura, padrões de projeto e melhores práticas de UI/UX.
-
Padrão Técnico Schemas JSON, interfaces e protocolos de comunicação universal.
-
Ecossistema Comunidade ativa e exemplos reais de implementação em escala.
Acesso livre para desenvolvedores