📋 O Padrao Agent Skills

A especificacao AgentSkills.io nasceu da necessidade de criar um padrao aberto para que agentes AI de diferentes plataformas pudessem consumir instrucoes de forma uniforme. Antes dela, cada ferramenta tinha seu proprio formato proprietario, criando fragmentacao no ecossistema.

A ideia central e simples: se voce escreve uma skill usando o padrao AgentSkills.io, ela deveria funcionar no Claude Code, GitHub Copilot, Cursor, OpenAI Codex e qualquer outro agente que adote a especificacao. Isso elimina a necessidade de reescrever instrucoes para cada plataforma.

O SKILL.md e o arquivo central do padrao Agent Skills. Trata-se de um arquivo Markdown com um bloco YAML no topo (frontmatter) que contem metadata sobre a skill, seguido do conteudo em Markdown que o agente vai consumir como instrucoes.

A escolha do Markdown como formato base nao foi acidental. Markdown e universal, legivel por humanos, renderizavel em qualquer plataforma e ja e o formato nativo que LLMs melhor compreendem. O YAML frontmatter adiciona estrutura sem sacrificar legibilidade.

---
name: nextjs-developer
description: |
  Skill para desenvolvimento com Next.js 14+.
  Siga padroes de App Router e Server Components.
version: 1.0.0
globs:
  - "**/*.tsx"
  - "**/*.ts"
  - "app/**/*"
---

# Next.js Developer Skill

Voce e um especialista em Next.js 14+ com App Router.

## Regras
- Use Server Components por padrao
- Client Components apenas quando necessario
- Prefira fetch() com cache em vez de getServerSideProps

O YAML frontmatter e o bloco entre os delimitadores --- no topo do SKILL.md. Ele define metadata estruturada que os agentes usam para descobrir, filtrar e ativar skills automaticamente. Alguns campos sao obrigatorios e outros opcionais.

---
name: react-typescript
description: |
  Especialista em React com TypeScript.
  Use quando trabalhando com componentes .tsx.
version: 2.1.0
globs:
  - "**/*.tsx"
  - "**/*.jsx"
  - "src/components/**/*"
alwaysApply: false
tags:
  - react
  - typescript
  - frontend
---

Progressive disclosure e uma tecnica de design de informacao onde voce revela conteudo gradualmente conforme necessario, em vez de despejar tudo de uma vez. No contexto de skills, isso e critico porque agentes tem context windows limitadas e cada token conta.

A ideia e que o frontmatter fornece informacao minima para o agente decidir se a skill e relevante. Somente quando ativada, o corpo completo do Markdown e carregado no contexto. Skills podem ainda referenciar arquivos externos para conteudo muito longo.

Adotar um padrao universal para skills traz beneficios significativos tanto para desenvolvedores individuais quanto para equipes e a comunidade como um todo. A padronizacao elimina fragmentacao e cria um ecossistema mais rico.

A adocao do padrao SKILL.md pelas grandes plataformas tem sido gradual mas consistente. Cada plataforma trouxe seu proprio formato inicialmente, mas a tendencia de convergencia e clara. Entender o status de adocao ajuda a decidir onde investir esforco.