🧩 O que é uma Agent Skill (e por que o formato venceu)
Da definição de uma skill ao motivo de o formato SKILL.md ter virado padrão de fato — e como o skills.sh virou o "npm de skills".
Uma skill é um arquivo SKILL.md — frontmatter YAML (name + description) mais um corpo Markdown — que descreve um comportamento. O agente lê e incorpora essa instrução ao seu próprio raciocínio.
É a unidade atômica de todo o ecossistema. Sem entender o que é um SKILL.md, o resto (catálogo, install count, grupos) não faz sentido.
SKILL.md · frontmatter YAML · name + description · corpo Markdown
Skill não é código que roda. É texto que o agente lê e segue quando o contexto da conversa bate com a description. A ativação é automática e por relevância, não por chamada explícita.
Essa diferença muda como você escreve. Você não programa passos — você descreve quando e o porquê, e deixa o agente decidir como aplicar.
ativação por contexto · description como gatilho · sem execução direta
SKILL.md é texto puro: roda em 50+ agentes, versiona via git como qualquer arquivo de repo, e já soma 53,9M de instalações no agregado do skills.sh. Markdown venceu por ser o menor denominador comum.
Entender por que o formato pegou explica por que vale investir nele em vez de prender conhecimento em ferramentas proprietárias.
portabilidade 50+ agentes · versionamento git · 53,9M installs
São camadas distintas: prompt é efêmero; CLAUDE.md é contexto fixo do projeto; MCP dá ferramentas/dados; subagente é um executor isolado; a skill é conhecimento reutilizável que dispara por contexto.
Saber escolher a camada certa evita transformar tudo em skill (ou nada). Cada problema tem o mecanismo adequado.
prompt efêmero · CLAUDE.md sempre ativo · MCP = ferramentas · subagente = execução · skill = conhecimento sob demanda
O skills.sh é o catálogo público: indexa skills por repo, mostra install count (sinal de qualidade) e instala com npx skills add owner/repo. É o npm do mundo de skills.
É onde você descobre o que já existe antes de criar, e onde você publica para outros instalarem.
catálogo · install count · npx skills add · leaderboard
Publicam grandes players — vercel-labs, anthropics, microsoft — e milhares da comunidade, totalizando 5.075 repos fonte. Não é um jardim murado de uma empresa só.
Saber quem domina e quem ainda não chegou mostra onde há espaço para a sua skill.
vercel-labs · anthropics · microsoft · comunidade · 5.075 repos
🗺️ O mapa do skills.sh: 39k skills, a lei de potência, os 16 grupos
O tamanho real do catálogo, a curva brutal de instalações e os 16 grupos temáticos — e o que tudo isso te ensina antes de criar a sua skill.
O skills.sh cataloga 39.366 skills vindas de 5.075 repos fonte, somando 53,9M de instalações distribuídas em 16 grupos temáticos.
O número total dá a escala: o ecossistema é grande o bastante para já ter quase tudo — e específico o bastante para ainda ter buracos.
39.366 skills · 5.075 repos · 53,9M installs · 16 grupos
A distribuição é uma lei de potência: 60,2% das skills têm menos de 100 installs, e apenas 0,3% (131 skills) passam de 100k. A maioria vive na cauda longa.
Te tira da ilusão de que "publicar = sucesso". A esmagadora maioria das skills quase não é instalada.
lei de potência · cauda longa · 60,2% <100 · 0,3% = 131 skills 100k+
As 100 skills mais instaladas concentram 43,7% de todas as instalações. Quase metade do bolo está em 100 nomes, entre quase 40 mil.
Mostra o efeito "vencedor leva quase tudo" — e por que competir de frente com as líderes é difícil.
top 100 = 43,7% · efeito de rede · winner-takes-most
O catálogo se divide em 16 grupos. Por contagem lidera AI/LLM/Agents (12.693 skills, 12,9M installs); por instalação por skill brilha DevOps&Cloud (907 skills, 8,3M installs). Web&Frontend tem 4.694 skills.
Ver volume vs instalação por grupo revela onde há muita oferta e onde poucas skills capturam muita demanda.
AI/Agents 12.693 · Web 4.694 · DevOps 8,3M · Backend 2.685 · Testing 1.339
Não é só skill que concentra — fonte também. Poucos repos (vercel-labs, anthropics, microsoft, larksuite) respondem por uma fatia gigante das instalações, mesmo entre 5.075 repos.
Marca e distribuição contam. Uma skill ótima num repo desconhecido começa em desvantagem.
vercel-labs · anthropics · microsoft · larksuite · marca + distribuição
A lição prática: descubra o que já existe antes de criar; mire nichos vazios em vez de duelar com líderes; e posicione sua skill do lado certo da curva (resolvendo dor real, não só repetindo o que já tem).
É a ponte da Trilha 1 para o resto do curso: o mapa orienta onde e como criar.
pesquisar antes de criar · nicho vazio · lado certo da curva
⭐ As Melhores para Começar (Starter Pack)
As skills canônicas que todo mundo deveria conhecer e instalar primeiro — oito nomes que ensinam o ecossistema mais rápido que qualquer tutorial, mais o kit mínimo recomendado.
Um conjunto pequeno de skills muito instaladas, bem escritas e de fontes confiáveis (vercel-labs, anthropics, supabase) que você instala e lê primeiro.
Instalar essas skills é o atalho mais rápido para entender o que uma skill boa parece por dentro — cada uma vira um exemplo comentado.
curadoria · fonte confiável · instalar é ler · 4-8 skills base
find-skills (vercel-labs/skills, 1.802.925 installs) ensina o agente a buscar, avaliar e instalar outras skills do catálogo sozinho. npx skills add vercel-labs/skills.
É a skill mais instalada do planeta e o ponto de entrada de tudo — transforma o agente em curador do próprio ecossistema.
find-skills · meta-skill · 1,8M installs · vercel-labs/skills
frontend-design (488k, anthropics), vercel-react-best-practices (443k) e web-design-guidelines (358k, vercel-labs) — as três referências de design e código de UI. npx skills add anthropics/skills e vercel-labs/agent-skills.
Mostram como escrever uma skill de "guideline" — instruções de estilo que o agente aplica sem você repetir, mesmo que não seja dev de front.
frontend-design 488k · vercel-react 443k · web-design-guidelines 358k · skill de guideline
skill-creator (246k, anthropics) guia o agente a escrever e otimizar SKILL.md; agent-browser (332k, vercel-labs) dá ao agente um navegador para automação e raspagem.
Mudam o que o agente consegue fazer: uma cria novas skills (você vai usar na 1.4), a outra destrava casos de uso reais na web.
skill-creator 246k · agent-browser 332k · meta + ferramenta
supabase-postgres-best-practices (203k, supabase) ensina SQL/RLS/schema; test-driven-development (107k, obra/superpowers) faz o agente escrever o teste antes do código.
Mostram skill de vendor (feita pelo time do produto) e skill de processo (muda comportamento, não dá ferramenta) — dois sabores além do front.
supabase 203k · TDD 107k · vendor · processo
O kit mínimo é find-skills + skill-creator (+ TDD se você codifica). Front adiciona frontend-design + web-design-guidelines; o resto entra por necessidade.
Cada skill gasta contexto: um pack enxuto e relevante funciona melhor que 40 skills concorrendo pela atenção. Instale o que usa.
kit mínimo · find-skills + skill-creator · expandir sob demanda · menos é mais
🛠️ Como Criar: Sua Primeira Skill em 10 Minutos
Hands-on do zero ao funcionando: escolher um caso real (padrão de commits), escrever o SKILL.md mínimo, instalar local e ver disparar — com o arquivo pronto para copiar.
Uma convenção que você repete e detesta repetir — o caso ideal de estreia. Nosso exemplo: o padrão de mensagens de commit (Conventional Commits).
Casos pequenos, concretos e testáveis em 1 minuto ensinam o formato; casos grandes ("deploy completo") frustram e não disparam.
caso real · testável · conventional-commits · pequeno por design
Um arquivo: frontmatter YAML com name + description obrigatórios, e um corpo Markdown imperativo embaixo.
name é o identificador; description é o gatilho (diz O QUE e QUANDO); corpo são as instruções. Saber os três é saber escrever qualquer skill.
frontmatter YAML · name · description = gatilho · corpo imperativo
A skill conventional-commits completa, para salvar em skills/conventional-commits/SKILL.md: frontmatter, description com gatilhos, corpo curto com tipos e regras.
Ver um SKILL.md real e enxuto desmistifica o formato — a description carrega o peso com um "Use SEMPRE que..." e gatilhos concretos.
SKILL.md pronto · gatilhos concretos · corpo curto · exemplo bom/ruim
Quatro passos: criar a pasta/arquivo, instalar com npx skills add ./skills/conventional-commits, disparar com um pedido real e confirmar o formato na saída.
Você não precisa publicar para usar — instala de caminho local. Sem build, sem deploy, sem dependência. Dez minutos de verdade.
npx skills add ./ · instalação local · dispara por contexto · confirmar
Os baldes de erro: description vaga, sem QUANDO usar, corpo gigante, frontmatter quebrado, regras em MAIÚSCULA gritada sem porquê.
Se a skill existe mas o agente ignora, 9 em 10 vezes é a description fraca, não o corpo. Saber isso poupa horas.
description vaga · sem QUANDO · corpo inflado · YAML quebrado
Evolução incremental: afinar a description com base no que falhou, adicionar exemplos sob demanda, versionar o SKILL.md junto com o repo.
Uma skill de 30 linhas usada e ajustada toda semana vale mais que uma de 500 escrita "completa" e nunca testada. Deixe o uso podar e crescer.
afinar description · exemplos sob demanda · versionar no git · incremental
🚀 Dicas Avançadas: Lendo o Ecossistema como um Pro
Install count mente um pouco. Aprenda a ler o catálogo criticamente: viés de quem chegou cedo, achar skills em ascensão e nichos vazios, avaliar a fonte, usar o CLI e saber quando NÃO instalar.
Install count é cumulativo: favorece quem chegou cedo, tem marca e virou pré-requisito. find-skills (1,8M) lidera por ser dependência de quase todo fluxo, não por ser "melhor".
É reputação, não nota. Use como filtro inicial ("vale olhar"), nunca como decisão final — ele não diz se a skill é mantida ou serve ao seu caso.
viés cumulativo · first-mover · marca · reputação ≠ nota
60,2% das skills têm <100 installs e só 131 passam de 100k. As joias subvalorizadas vivem entre 100 e 10k installs e nos grupos pequenos (Office, Finance, Productivity).
O topo está travado. Caçar recente + em alta na faixa do meio, e procurar a ausência (busca que volta vazia = nicho), rende mais que duelar com líderes.
faixa do meio · em ascensão · nicho vazio · grupos pequenos
Quatro perfis: fornecedor oficial (supabase, stripe) e plataforma (anthropics) = confiança alta; comunidade reconhecida = média; repo desconhecido = leia o SKILL.md antes.
Skill é instrução que o agente adota e às vezes executa. Uma fonte duvidosa pode embutir instruções ruins — e o SKILL.md é texto, leva 30 segundos para ler.
vendor oficial · plataforma · comunidade · ler o SKILL.md
npx skills find busca, add instala, list mostra o instalado, update atualiza. Com find-skills, o agente opera tudo por você.
Busque pela dor (não pelo nome) e compare descriptions antes de instalar. Mas update não é grátis — pode mudar comportamento; teste depois.
npx skills find/add/list/update · buscar pela dor · agente opera o CLI
Não instale para algo de uso único (prompt resolve), quando já tem skill parecida, de fonte desconhecida não lida, para contexto fixo (vai no CLAUDE.md) ou "por garantia".
Cada skill gasta contexto e adiciona gatilho indesejado. O teste de 3 perguntas (uso recorrente? confio na fonte? não tenho nada igual?) evita inchaço.
teste de 3 perguntas · contexto custa · faxina periódica · CLAUDE.md vs skill
Seis hábitos: ler a description não o número; preferir recente+em alta a antigo+grande; buscar pela dor e instalar o mínimo; tratar o catálogo como mapa de nichos; atualizar/revisar em ciclo; saber não instalar.
Esses hábitos separam quem só olha o leaderboard de quem extrai valor real — e fecham a Trilha 1 com o mapa completo para a Trilha 2 (qualidade).
description > número · movimento > tamanho · mínimo > acúmulo · mapa de nichos
Mapa da trilha
Um arquivo de texto que virou padrão em 50+ agentes e soma 53,9M de installs.
39 mil skills, uma curva brutal, e 100 nomes levando 43,7% de tudo.
Oito skills canônicas e o kit mínimo: o atalho para entender o ecossistema.
Do zero ao funcionando: um SKILL.md real, copiável, instalado e disparando.
Install count mente: ache nichos, avalie a fonte e saiba quando NÃO instalar.