Como encontrar skills do Claude prontas antes de criar a sua do zero?

Fala aí, beleza? Escrever uma skill do zero e descobrir depois que ela já existia pronta num repositório público é o pior tipo de trabalho: dá esforço e ainda costuma entregar menos que a versão que já estava lá 😅

A estrutura de uma skill é simples: uma pasta com um arquivo SKILL.md dentro

E como esse formato virou uma especificação aberta, com spec e documentação em github.com/agentskills/agentskills e no site agentskills.io, ele deixou de ser exclusividade de um produto só

O resultado é que existem coleções públicas grandes de skills, umas oficiais da Anthropic, outras mantidas por gente de fora, cheias de pasta pronta esperando alguém achar

Aí a pergunta muda de figura: não é mais "como eu escrevo uma skill", é "como eu procuro direito antes de escrever"

Neste post eu te mostro o método de busca (quais palavras usar, quais comandos rodar) e o critério pra decidir em poucos minutos entre adaptar a que existe ou partir pra sua

O que você precisa saber antes de sair procurando

Antes do comando, o conceito, porque é ele que faz a busca funcionar

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Uma skill é uma pasta contendo um arquivo SKILL.md com frontmatter YAML de metadados

O frontmatter exige dois campos: name e description

E a pasta pode trazer bem mais que texto: scripts, referências e assets vão junto

---
name: gerar-changelog
description: Gera um changelog a partir dos commits do repositório. Usar quando o usuário pedir release notes ou changelog de uma versão.
---

Repara nas regras: o name aceita só letras minúsculas, números e hífens

E a description é escrita em terceira pessoa, dizendo o que a skill faz e quando usar

Por que a description é a chave da busca:

Aqui está o pulo do gato

O name e a description de todas as skills entram no system prompt na inicialização, e a description é justamente o que o Claude compara com o pedido do usuário

Ou seja: a description é o campo que habilita a descoberta da skill

Se é ela que descreve o que a coisa faz e quando dispara, é com o vocabulário dela que você tem que procurar também 🙂

Onde as skills moram no Claude Code:

No Claude Code, skill não sobe por API

Elas ficam em pastas do sistema de arquivos:

• ~/.claude/skills/ para as pessoais, que valem em qualquer projeto seu
• .claude/skills/ para as do projeto, que ficam versionadas junto com o repo

Saber disso importa na hora de instalar, porque é nessas pastas que a skill achada vai parar

E mais uma coisa prática: a CLI de busca que a gente vai usar roda via npx, então tenha Node disponível no ambiente

Como procurar uma skill pronta passo a passo

Se você já usou npm ou composer, o raciocínio é o mesmo: primeiro você procura o pacote, só depois escreve a função na mão

Bora ver na prática?

1. Escreva sua tarefa no formato de description

Antes de abrir qualquer site, escreva uma frase só, em terceira pessoa, com os dois pedaços obrigatórios: o que faz + quando usar

Algo como "Converte planilhas em relatório resumido. Usar quando o usuário enviar um arquivo de dados e pedir um resumo executivo"

Dessa frase você extrai as palavras da busca: os verbos e os objetos, não o nome do produto

O erro comum deste passo: procurar por "claude", "agente", "ia" e outros termos genéricos do ecossistema, que aparecem em absolutamente tudo e não filtram nada

2. Busque por palavra-chave no índice público

A CLI aberta npx skills, mantida pela Vercel Labs, tem um comando de busca que consulta um índice público:

    npx skills find changelog git commits

Ela mostra as skills que casam com as palavras-chave e já devolve junto as instruções de instalação, usando o mesmo registro do site skills.sh

O erro comum deste passo: jogar a frase inteira da description no comando, em vez das duas ou três palavras que realmente descrevem a tarefa

3. Procure de dentro do próprio Claude Code

O comando /plugin abre um gerenciador com abas, e uma delas é a Discover, feita pra navegar o que está disponível nos marketplaces já adicionados

    /plugin

O marketplace oficial da Anthropic, o claude-plugins-official, já vem adicionado automaticamente no primeiro uso interativo, então a aba Discover não começa vazia

Quando achar o que quer, a instalação é direta:

    /plugin install <nome>@claude-plugins-official

Prefere olhar fora do terminal? Existe um catálogo web oficial em claude.com/plugins pra consultar com calma

O erro comum deste passo: sair adicionando o marketplace oficial na mão achando que ele não está lá

4. Adicione marketplaces de terceiros antes de instalar

Fora do oficial, todo marketplace precisa ser adicionado primeiro:

    /plugin marketplace add <owner/repo ou URL>
    /plugin install <nome>@<marketplace>

O erro comum deste passo: rodar o install direto e não entender por que o nome não é encontrado, quando na verdade faltou o marketplace add

5. Varra as coleções públicas quando o índice não devolver nada

Busca por palavra-chave é boa, mas não é onisciente

Quando ela vier seca, vale garimpar na mão nos repositórios públicos:

– anthropics/skills, o repositório público oficial de Agent Skills da Anthropic – anthropics/claude-plugins-official, o diretório oficial de plugins do Claude Code gerenciado pela Anthropic – travisvn/awesome-claude-skills, lista curada de skills e recursos para Claude, em especial Claude Code – microsoft/skills, que reúne Skills, MCP servers, Custom Agents e Agents.md – addyosmani/agent-skills, com engineering skills voltadas a agentes de código

Como o formato é uma spec aberta, skill que você achar numa coleção genérica continua sendo pasta + SKILL.md, e por isso costuma servir

O erro comum deste passo: parar no repositório oficial e concluir que "não existe", quando o que existe está numa coleção de terceiro

6. Inspecione o repositório antes de instalar

Esse passo é o que separa o cara que sabe procurar do que só copia comando

A mesma CLI instala skills a partir de um repositório Git, e antes disso deixa você listar o que tem lá dentro:

    npx skills add <owner/repo> --list
    npx skills add <owner/repo> --skill <nome>

O --list mostra as skills do repositório, o --skill instala só a que interessa, e o -g instala globalmente em vez de no projeto atual

Tome cuidado com uma coisa: o caminho de instalação varia por agente, indo para .agents/skills/ ou .claude/skills/ conforme o alvo

O erro comum deste passo: instalar o repositório inteiro sem listar, encher a sua pasta de skills que nunca vão ser acionadas e depois não achar onde a coisa foi parar

Adaptar a que existe ou escrever a sua: como decidir em poucos minutos

Achou uma candidata? Beleza, agora vem a decisão

E ela não se toma pelo nome da pasta, se toma lendo o SKILL.md inteiro, porque a pasta é o produto: o texto, os scripts, as referências e os assets

Repara que a maioria das linhas termina em "adaptar", e só a última manda criar

Isso não é preguiça, é aproveitamento: reescrever a description de uma skill pronta custa minutos, escrever os scripts que vêm junto com ela custa dias

E quando a decisão for mesmo criar a sua, o caminho vale para qualquer agente que siga o padrão, incluindo o que eu mostro no post sobre criar skills no ClawdBot

Um último teste antes de fechar a decisão: se você não consegue explicar em uma frase quando aquela skill deve ser acionada, ela ainda não está pronta pro seu fluxo, adaptada ou nova

O que eu aprendi usando skills prontas na prática

Esse método não nasceu de teoria, nasceu de apanhar

Num vídeo anterior eu tinha rodado o mesmo fluxo sem skill nenhuma, e o projeto complexo saía com erro e entregando menos do que eu pedia

Foi isso que me empurrou pra procurar skill pronta em vez de escrever a minha: eu recorri a um repositório público que já reúne um monte delas e escolhi de lá só as que serviam pro meu caso

A diferença é exatamente a que a tabela ali em cima descreve: o código gerado saiu melhor e o projeto saiu certo com menos tentativa, o que na prática significa gastar menos prompt e menos cota da ferramenta

E tem um detalhe de método que eu levo pra tudo: no mesmo vídeo, quando o NotebookLM me trouxe as fontes, eu entrei em cada uma, avaliei se fazia sentido e desmarquei as que não confiava antes de seguir

É o mesmo movimento do --list antes do install: você não aceita o pacote inteiro só porque veio pronto 😀

No vídeo abaixo eu mostro esse fluxo rodando de ponta a ponta, combinando NotebookLM e Antigravity com skills pra montar um app completo

Uma ressalva honesta: no vídeo eu não ensino a instalação das skills, eu aponto que o próprio repositório documenta o comando e remeto ao vídeo anterior dedicado só a ele

Se o que te interessa é a parte do editor, eu tenho um passo a passo separado sobre usar o Antigravity do Google do zero até o deploy

Conclusão

Recapitulando o método, que cabe em três movimentos antes de você criar qualquer pasta

Primeiro, escreva a description da sua tarefa: o que faz + quando usar, em terceira pessoa

Segundo, rode npx skills find com as palavras dessa frase e veja o que o índice público devolve

Terceiro, abra /plugin na aba Discover, lembrando que o marketplace claude-plugins-official já está lá desde o primeiro uso interativo

Se nada aparecer, aí sim você garimpa nas coleções públicas, e só depois disso escreve a sua em .claude/skills/

O ganho não é preguiça, é foco: o tempo que você não gastou reinventando uma skill genérica é o tempo que sobra pra escrever aquela que só faz sentido no seu projeto

Se curtiu, dá uma passada nos outros posts aqui do blog e no canal, que é onde eu mostro esses fluxos rodando de verdade

até o próximo post!