Skills para agentes de código
Um jeito simples de empacotar processos, boas práticas e pequenos checklists para seus agentes repetirem melhor o trabalho.
O que é uma skill?
Uma skill é uma instrução reutilizável para um agente. Pense nela como um pequeno manual de operação: quando uma situação aparece, o agente carrega aquele processo e segue os passos.
Na prática, ela costuma ser uma pasta com um arquivo
SKILL.md, contendo um nome, uma descrição e as
instruções que o agente deve seguir.
skills/
quality-gate/
SKILL.mdPara que serve?
Skills funcionam melhor quando empacotam um comportamento pequeno, claro e repetível.
Quality gates
Rodar lint, testes, build ou type check antes de devolver uma mudança de código.
Revisão de PR
Revisar pull requests seguindo os critérios do time, não só preferências soltas.
Handoff
Preparar um resumo claro do que mudou, riscos, validações e próximos passos.
Comece pelo mínimo: instruções, exemplos pequenos e critérios de validação. Se a skill crescer, mova detalhes para arquivos de apoio dentro da pasta da skill. Assim o agente carrega o básico primeiro e consulta recursos extras só quando precisar.
Como a skill é ativada?
Uma skill não é uma garantia automática. Ela é uma capacidade
disponível para o agente. Em geral, o agente vê o nome e a descrição
da skill, decide se ela combina com a tarefa e só então carrega o
SKILL.md completo.
Por isso, a descrição importa muito. Ela precisa dizer o que a skill faz e quando deve ser usada. Se o gatilho ficar vago, o agente pode seguir sem usar a skill.
Implícita
O agente escolhe usar a skill quando a tarefa parece bater com a descrição.
Explícita
Você chama a skill pelo nome, quando a ferramenta oferece slash commands ou invocação direta.
Reforçada
Uma regra do projeto lembra o agente de considerar a skill em momentos críticos.
Claude Code, Cursor e o harness
Claude Code trata skills como capacidades descobertas pelo agente.
Você pode deixar Claude escolher automaticamente ou invocar
diretamente com /nome-da-skill. Em Claude Code, também
existem controles de frontmatter para criar skills só manuais ou só
automáticas.
Cursor também tem suporte a Agent Skills, mas o modelo mental mais forte no produto ainda passa por Rules. Rules entram como contexto persistente para o Agent e podem ser sempre aplicadas, aplicadas por arquivos, solicitadas pelo agente ou chamadas manualmente.
Na prática: se você quer que uma skill implícita rode com mais consistência no Cursor, vale acompanhar a skill com uma regra curta do projeto. A regra não precisa duplicar tudo. Ela só precisa lembrar o harness de quando considerar a skill.
---
description: Use the quality-gate skill after technical code tasks.
alwaysApply: true
---
After code edits, remind the agent to use the quality-gate skill
before handing the task back.Compartilhando skills
Existem dois caminhos úteis para distribuir skills: um comando
simples via npx, ou marketplaces/plugins quando você
precisa de descoberta, updates e escala.
Skills prontas
Começando pequeno: uma skill para lembrar o agente de validar o projeto antes de entregar código.
quality-gate
No final de uma tarefa técnica, o agente deve encontrar e rodar o melhor quality gate disponível: lint, testes, type check, build ou formatação.
npx skills@latest add baltazarparra/ai-native-engineering --skill quality-gate --agent codex --globalReferências
Comunidade
Pergunte, responda, destrave
Use este espaço para fazer perguntas sobre a sessão, compartilhar exemplos e ajudar outras pessoas a entenderem o tema.