10 nov 2026 · Actualizado 16 nov 2026 · 7 min de lectura
Agent Skills no Cursor e no Claude: o que são e como instalar
Agent Skills são pastas com SKILL.md. Veja o que são, como instalar no Cursor e no Claude e como baixar um skill por vez no catálogo da Ontoom.

Agent Skills são pastas com um arquivo SKILL.md que ensinam o agente a repetir um fluxo, como SEO, commit, design ou documentação. O formato aberto funciona no Cursor, no Claude Code, no Codex e em outras IAs compatíveis. Eu uso esse formato nos meus próprios agentes, e testei o caminho de baixar um skill por vez em vez de clonar um monorepo inteiro.
O erro comum é clonar um repositório gigante só para pegar um skill. Você leva dezenas de pastas que não precisa e perde a chance de descobrir skills com curadoria. Este guia mostra o formato, a instalação em 30 segundos e como o catálogo da Ontoom resolve isso.
O que são Agent Skills na prática

Um skill é, no fundo, uma pasta pequena. O arquivo principal é o SKILL.md, com um cabeçalho (nome, descrição, às vezes as ferramentas em que funciona) e o passo a passo que o modelo deve seguir. Quando o pedido da pessoa combina com essa descrição, o agente carrega as instruções.
Eu testei skills de commit, de revisão de SEO e de geração de documentação. O que funciona bem é uma descrição curta e um roteiro objetivo. O que falha é um texto vago, ou um script que ninguém revisou.
O formato circula em repositórios públicos, entre eles o orlandoneto/agent-skills, que alimenta o catálogo da Ontoom. Há também discussões e exemplos no GitHub, o que ajuda a comparar licenças e a ver como cada autor organiza a pasta.
Como a Ontoom organiza o catálogo de Agent Skills

No buscador de skills da Ontoom você filtra por origem, tag e ferramenta. O botão principal baixa um ZIP só daquele skill, hospedado no GitHub Releases do repositório orlandoneto/agent-skills. A Ontoom é a vitrine, com busca e páginas para indexação. O GitHub guarda o arquivo e recebe estrelas, issues e forks. Os dois lados ganham tráfego.
O catálogo não espelha milhares de skills de forma automática. Há gates de licença, anti-duplicata, quota diária e revisão manual quando existe pasta scripts/. Só o status published aparece no site e no sitemap. Isso reduz surpresa: o que você encontra no buscador passou por um filtro mínimo.
Se um skill tiver scripts, revise o código antes de rodar. Eu prefiro skills só em Markdown quando a tarefa cabe em instrução. Script faz sentido para um fluxo repetido, mas exige o mesmo cuidado que qualquer dependência de terceiros.
Como instalar Agent Skills em 30 segundos

O fluxo que eu uso é este:
- Baixe o ZIP do skill no catálogo.
- Extraia a pasta.
- Coloque em
.agents/skills/<nome>/(Cursor e várias IAs), ou.claude/skills/<nome>/no Claude Code, ou.cursor/skills/<nome>/. - Abra o agente e peça a tarefa que o description do skill descreve. O modelo carrega as instruções quando o contexto combina.
Se o agente não reagir, confira três coisas: o nome da pasta, se o SKILL.md está na raiz do skill (não um nível acima) e se o pedido que você fez parece com a descrição. Na prática, um "use o skill de SEO neste artigo" funciona melhor do que um pedido genérico.
Vale manter os skills versionados no próprio repositório do projeto, não só na máquina. Assim o time inteiro usa o mesmo roteiro. Isso combina com o jeito de trabalhar com JSON e contratos entre ferramentas, quando o skill precisa de uma saída previsível.
Qualidade, licença e segurança

Antes de instalar, leia a licença. Contribuições originais são bem-vindas por issue ou pull request, com licença clara, por exemplo MIT ou Apache, como o próprio repositório do catálogo documenta.
Checklist rápido que eu sigo:
- A descrição diz o que o skill faz e o que ele não faz?
- Existe pasta scripts/? Se existe, eu leio o código antes de executar.
- A licença permite uso no meu contexto (projeto pessoal, cliente, empresa)?
- O skill pede chaves, tokens ou acesso à rede? Se pede, eu trato isso como um ponto de atenção.
Skills não substituem revisão humana em tarefas sensíveis, como publicação ou mudança em produção. Eles aceleram o roteiro. A decisão continua sendo sua.
Exemplo: baixar um skill de SEO sem clonar o monorepo
Imagine que você quer um skill de revisão de artigo. Em vez de clonar um repositório com dezenas de pastas, abra o buscador, filtre por SEO, baixe o ZIP e instale só aquela pasta. Eu fiz esse caminho ao montar o fluxo de revisão dos meus sites. O tempo foi o do download e o de colocar a pasta no lugar certo, não o de clonar e limpar o que eu não ia usar.
Se o skill citar ferramentas da Ontoom, os links costumam apontar para utilitários como o conversor Base64 ou o gerador de UUID, úteis em testes e em conteúdo técnico.
Perguntas frequentes
Agent Skills funcionam só no Claude?
Não. O formato com SKILL.md é usado no Cursor, no Claude Code, no Codex e em outras IAs compatíveis, cada uma com um diretório típico. O importante é o arquivo na pasta certa e um pedido que combine com a descrição. Eu testei o mesmo skill em mais de um agente, só mudando o caminho da pasta.
Preciso clonar o repositório inteiro para usar um skill?
Não. No catálogo da Ontoom você baixa um ZIP só daquele skill, publicado no GitHub Releases. Clonar o monorepo inteiro só faz sentido se você for contribuir com vários skills ou estudar a organização do repositório. Para o dia a dia, o ZIP isolado é o caminho mais curto.
É seguro rodar um skill com scripts?
Só depois de ler o código. Scripts executam comandos na sua máquina. Por isso o catálogo da Ontoom reserva review manual quando existe pasta scripts/. Se a tarefa cabe em Markdown, prefira o skill sem script. Trate o código de terceiros como qualquer dependência: licença, permissões e o que ele acessa na rede.
Onde eu coloco a pasta no Cursor e no Claude Code?
No Cursor, o caminho mais comum é .cursor/skills/<nome>/ ou .agents/skills/<nome>/, conforme o agente. No Claude Code, use .claude/skills/<nome>/. O SKILL.md deve ficar na raiz dessa pasta. Se o agente não carregar o skill, comece conferindo esse caminho antes de mudar o texto do arquivo.
Quando um skill não é a ferramenta certa
Nem toda tarefa pede um Agent Skill. Se o fluxo muda a cada vez, um checklist curto no repositório pode bastar. Se a tarefa é única, um prompt bem escrito resolve. O skill brilha quando o time repete o mesmo roteiro: abrir um PR, revisar um artigo, gerar um changelog, validar um formulário com CPF sintético ou inspecionar um token no gerador JWT.
Eu também evito skills que tentam fazer dez coisas. Um skill focado é mais fácil de revisar e de trocar. Se a pasta crescer demais, divida. O catálogo da Ontoom funciona melhor justamente porque cada item é um recorte, não um monorepo.
Outro limite: o skill não substitui a documentação do produto. Ele aponta o caminho. As regras de negócio continuam no código e nos docs do time.
Fontes
Abrir o buscador de Agent Skills
Agent Skills são pastas com SKILL.md. Veja o que são, como instalar no Cursor e no Claude e como baixar um skill por vez no catálogo da Ontoom.
Abrir o buscador de Agent Skills