Construí um repositório em torno de Agent Skills — Eis por que isso importa
Se estás a construir com agentes de IA neste momento, é provável que já tenhas esbarrado na mesma parede:
Continuas a repetir as mesmas instruções — e o teu agente continua a esquecer-se.
É exatamente esse o problema que os Agent Skills tentam resolver. Por isso, juntei um repositório para explorar a ideia na prática:
👉 github.com/andreab67/agent-skills
O que são Agent Skills?
Agent Skills são uma ideia simples, mas poderosa: empacotar como fazer algo em instruções reutilizáveis que o teu agente de IA pode carregar a pedido.
Tecnicamente, são apenas pastas que contêm um ficheiro SKILL.md, além de scripts opcionais, modelos e material de referência. Conceitualmente, são conhecimento portátil para agentes de IA.
Por que isto importa
A maioria dos fluxos de trabalho de IA hoje tem este aspeto:
- Copiar e colar prompts
- Reescrever o contexto sempre que inicias uma sessão
- Esperar que o modelo se comporte de forma consistente
Agent Skills invertem isso:
- Define um fluxo de trabalho uma só vez. Escreve as instruções, exemplos e restrições uma vez — bem feitas.
- Reutiliza-o entre projetos e ferramentas. A skill vive num repositório, não na tua área de transferência.
- Carrega-a apenas quando necessário. Sem excesso de contexto — os agentes trazem apenas a skill relevante para a tarefa em mãos.
Esse modelo de "carregar a pedido" é a ideia-chave. Os agentes não precisam de tudo logo à partida. Precisam da capacidade certa no momento certo.
Sobre o que é o repositório
O repositório agent-skills é a minha forma de explorar esta ideia na prática:
- Como estruturar skills para que sejam realmente reutilizáveis
- O que separa uma skill útil de um prompt prolixo dentro de uma pasta
- Como construir fluxos de trabalho componíveis para tarefas reais e recorrentes
Pensa nisto como um terreno de experimentação para transformar prompts repetidos em sistemas reutilizáveis.
O panorama mais amplo
Estamos a atravessar uma progressão clara:
prompts → ferramentas → agentes → ecossistemas de skills
Agent Skills encaixam num novo nível dessa pilha:
- Mais estruturadas do que prompts em bruto
- Mais reutilizáveis do que instruções personalizadas embutidas num prompt de sistema
- Mais leves do que lançar um agente personalizado completo
São algo como microplugins para o comportamento da IA — e isso é uma abstração verdadeiramente útil.
Uma verificação da realidade
Nem todas as skills são iguais. Ao experimentar isto:
- Skills más são prompts prolixos disfarçados — longos, genéricos, difíceis de delimitar
- Skills boas são claras, específicas e acionáveis — definem a tarefa, as restrições e o resultado esperado
- Skills excelentes mudam realmente os resultados — codificam conhecimento real, não apenas instruções
A diferença entre a segunda e a terceira é a especificidade e o enraizamento no mundo real. Uma skill que diz "escreve código limpo" não é uma skill. Uma skill que diz "ao refatorar um componente React, verifica estes cinco padrões específicos, por esta ordem, e corrige apenas o que foi pedido" — isso é útil.
A ligação com Yoga e arquitetura cloud
Há um princípio no yoga: a sequência importa tanto quanto as posturas. Podes conhecer todos os asanas e ainda assim construir uma prática que magoa pessoas se a ordem e as transições estiverem erradas. Aqui é o mesmo.
Agent Skills têm realmente a ver com codificar sequência e discernimento — não apenas conhecimento. O que fazer, quando fazer e o que omitir. É isso que as torna diferentes de um prompt mais longo.
Na arquitetura cloud, chamamos a isso um runbook. A ideia é a mesma: documenta o discernimento, não apenas os passos.
Para onde isto vai
O futuro de curto prazo é:
- Mercados de skills onde equipas partilham e gerem versões de capacidades de agentes
- Fluxos de trabalho componíveis onde skills se encadeiam para tarefas complexas
- Agentes de IA que aprendem o teu processo, e não apenas os teus prompts
Se estás a construir com agentes, vale a pena explorar isto cedo. Começa simples: pega numa tarefa que executas repetidamente, escreve um SKILL.md para ela e reutiliza-o entre sessões. A melhoria é imediata.
O repositório é aberto e aceito contributos: