Guia Definitivo: agentskill.sh

O agentskill.sh é o maior diretório e marketplace de skills para agentes de codificação do mercado — com mais de 127.000 skills catalogadas para Claude Code, Cursor, GitHub Copilot, Windsurf, Zed e mais de 20 ferramentas. Se você quer especializar seus agentes com conhecimento de domínio sem escrever tudo do zero, esse é o lugar para começar.

Overview

O agentskill.sh se posiciona como o “npm de agent skills” — um repositório centralizado onde desenvolvedores encontram, instalam e publicam skills modulares que estendem as capacidades de agentes de codificação.

O que é e como funciona

Cada skill no agentskill.sh é um pacote estruturado contendo um arquivo SKILL.md com metadados, instruções e, opcionalmente, scripts ou documentos de referência. Quando você instala uma skill, seu agente ganha expertise específica de domínio — desde engenharia de software e análise de dados até marketing e compliance jurídico.

Números do catálogo

O catálogo é organizado por role (função profissional):

[IMAGEM: Visão geral das categorias do agentskill.sh com números]

Modelo de preço

O agentskill.sh opera como um diretório gratuito para busca e instalação de skills. A monetização para criadores acontece por caminhos externos (Gumroad, Lemon Squeezy, vendas diretas) ou via o modelo de marketplace com split de receita [VERIFICAR: modelo exato de monetização pode ter mudado — verificar termos atuais no site].

Plataformas suportadas

Skills do agentskill.sh funcionam com mais de 20 ferramentas:

• Claude Code (Anthropic)
• Cursor
• GitHub Copilot
• Windsurf
• Zed
• OpenAI Codex
• Cline
• Amp
• Manus
• Mistral Vibe
• OpenClaw (open-source)

Essa compatibilidade multi-plataforma é um diferencial importante — você não fica preso a um único agente.

Diferencial vs concorrentes

Comparado a outros catalogadores como skills.sh ou SkillKit, o agentskill.sh se destaca pelo volume massivo e pelo sistema de Quality Score + Security Audit automatizado em cada skill publicada. Enquanto o skills.sh foca em curadoria aberta e o SkillKit em CLI tipo npm, o agentskill.sh aposta em escala + verificação automatizada.

Tutorial

Instalação

O setup inicial é feito via npx — sem necessidade de instalação global:

npx @agentskill.sh/cli@latest setup

Esse comando configura o ambiente local para buscar e instalar skills. Pré-requisitos:

• Node.js 18+ instalado
• npm ou npx disponível no PATH
• Um agente de codificação compatível (Claude Code, Cursor, etc.)

Primeiro Uso: Instalando uma Skill

Para instalar uma skill específica, use o comando add com o identificador owner/repo:

npx skills add affaan-m/mcp-server-patterns

Esse comando:

1. Busca a skill no registry do agentskill.sh
2. Verifica o security score
3. Baixa o conteúdo para o diretório local de skills
4. Confirma a instalação

Após instalar, seu agente carrega automaticamente a skill quando o contexto da tarefa corresponde à descrição da skill.

Navegando o Catálogo

Com 127.000+ skills, navegar sem estratégia é como procurar agulha em palheiro. Aqui estão as formas de filtrar:

Via Web (agentskill.sh)

O site oferece múltiplas formas de navegação:

1. Por Role — clique na categoria profissional (Development, Marketing, etc.)
2. Por Platform — filtre por agente compatível (Claude Code, Cursor, Copilot)
3. Por Trending — veja o que está em alta nas últimas 24h ou 7 dias
4. Por Quality Score — ordene por pontuação de qualidade (0-100)
5. Busca textual — use a barra de busca com ⌘K

Via CLI

# Buscar skills por keyword
npx skills search "react testing"

# Filtrar por plataforma
npx skills search "deployment" --platform claude-code

# Ver trending
npx skills trending

Via MCP Server

O agentskill.sh oferece um MCP Server dedicado que permite ao seu agente buscar e instalar skills diretamente durante uma sessão de trabalho:

{
  "mcpServers": {
    "agentskill": {
      "command": "npx",
      "args": ["-y", "@agentskill.sh/mcp-server"]
    }
  }
}

Com o MCP Server configurado, seu agente ganha acesso a estas ferramentas:

[IMAGEM: Terminal mostrando o MCP Server do agentskill.sh em ação]

Uso Intermediário: Trabalhando com Skillsets (Bundles)

Skillsets são coleções curadas de skills que você instala juntas. Pense neles como “starter packs” temáticos.

Exemplos reais de skillsets disponíveis:

• “Paperasse” (5 skills) — automação de burocracia francesa
• “Claude Skills” (13 skills) — skills essenciais para Claude Code
• “Marketing Skills” (15 skills) — análise de mercado, conteúdo, promoção

Instalando um Skillset completo

npx skills install-skillset "Claude Skills"

Isso instala todas as 13 skills do bundle de uma vez, configurando seu agente com um conjunto coeso de capacidades.

Criando seu próprio Skillset

Você pode criar e publicar seus próprios bundles:

1. Acesse agentskill.sh e clique em “Create Skillset”
2. Dê um nome e descrição ao bundle
3. Adicione as skills que compõem o conjunto
4. Publique para a comunidade

Skillsets são especialmente úteis para:

• Onboarding de equipes — instale o bundle padrão da empresa em um comando
• Workflows completos — agrupe skills que funcionam juntas (ex: TDD + code review + deployment)
• Curadoria temática — compartilhe suas descobertas com a comunidade

Configuração Avançada: MCP Server

Para a experiência mais fluida, configure o MCP Server do agentskill.sh no seu agente. Isso permite que o próprio agente descubra e instale skills conforme necessário durante o trabalho.

No Claude Code, adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "agentskill-sh": {
      "command": "npx",
      "args": ["-y", "@agentskill.sh/mcp-server"]
    }
  }
}

No Cursor, adicione ao .cursor/mcp.json do projeto:

{
  "mcpServers": {
    "agentskill-sh": {
      "command": "npx",
      "args": ["-y", "@agentskill.sh/mcp-server"]
    }
  }
}

Com isso configurado, você pode pedir ao agente:

“Busque uma skill para otimizar queries PostgreSQL e instale a melhor opção.”

O agente usa o MCP Server para buscar, avaliar o quality/security score, e instalar — tudo dentro da mesma sessão.

Deep Dive

Sistema de Quality Score

Cada skill no agentskill.sh recebe uma pontuação de qualidade de 0 a 100, avaliada automaticamente em 4 dimensões:

A pontuação final é classificada em faixas:

• 90-100: Excellent
• 75-89: Good
• 50-74: Fair
• 0-49: Needs work

Na prática, skills com score abaixo de 50 geralmente são genéricas demais ou mal estruturadas. Mire em skills com 75+ para uso em produção.

Sistema de Security Audit

Esse é um diferencial crítico do agentskill.sh. Cada skill passa por auditoria automatizada de segurança que verifica 12 categorias de ameaça:

• Command injection
• Data exfiltration
• Credential harvesting
• Privilege escalation
• Supply chain risks
• E mais 7 categorias

O resultado é um Security Score de 0 a 100, com classificação de severidade:

100/100 — No security issues detected
99/100  — 1 low severity issue
80/100  — 4 medium severity issues
34/100  — 10 medium + 16 low issues
0/100   — 5 high + 7 medium issues

Importante: O scan acontece em duas camadas:

1. Server-side — análise automatizada no momento da publicação
2. Client-side — verificação local antes da instalação via CLI (/learn)

Isso significa que mesmo que uma skill passe no scan do servidor, o CLI faz uma segunda verificação no seu ambiente antes de instalar.

[IMAGEM: Diagrama do fluxo de segurança em duas camadas do agentskill.sh]

Padrões de Skills identificados

Ao navegar o catálogo, você vai encontrar skills seguindo padrões arquiteturais distintos:

• Tool wrapper pattern — skills que encapsulam uma ferramenta específica (API, CLI, SDK)
• Pipeline pattern — skills que definem workflows multi-etapa
• Domain expert pattern — skills que injetam conhecimento profundo de um domínio
• Verification pattern — skills focadas em validação e auditoria

Limites e Workarounds

Volume ≠ Qualidade: Com 127K+ skills, a realidade é que muitas são genéricas, duplicadas ou de baixa qualidade. O relatório independente Agent Skill Report analisou 673 skills e encontrou:

• 22% falham na validação — não seguem a especificação corretamente
• 52% dos tokens são arquivos não-padrão — LICENSE, build artifacts, schemas que desperdiçam janela de contexto
• 66 skills têm contaminação oculta — problemas invisíveis ao analisar apenas o SKILL.md

Workaround: Use sempre os filtros de Quality Score (75+) e Security Score (80+) como baseline. Não instale skills sem verificar esses scores primeiro.

Contexto window: Skills muito grandes consomem tokens preciosos. Prefira skills com progressive disclosure — que carregam apenas o necessário para a tarefa atual.

Integrações Avançadas

Com CI/CD

Você pode automatizar a instalação de skills no pipeline:

# GitHub Actions example
- name: Setup agent skills
  run: |
    npx @agentskill.sh/cli@latest setup
    npx skills add company/internal-standards
    npx skills add company/deployment-checks

Com regras de projeto

Combine skills do agentskill.sh com suas regras de projeto locais (CLAUDE.md, .cursorrules, AGENTS.md) para criar uma camada de especialização híbrida:

<!-- AGENTS.md -->
# Skills instaladas via agentskill.sh
- affaan-m/mcp-server-patterns (Quality: 100, Security: 99)
- affaan-m/product-capability (Quality: 100, Security: 100)

# Regras locais do projeto
- Seguir padrão de arquitetura hexagonal
- Testes obrigatórios para toda PR

Como Publicar e Monetizar Skills

Publicando uma Skill

Para publicar no agentskill.sh:

1. Crie a estrutura — um repositório GitHub com SKILL.md na raiz
2. Siga a especificação — metadata obrigatória (name, description, triggers)
3. Submeta — via interface web ou CLI
4. Aguarde review — Quality Score e Security Audit são gerados automaticamente

Estrutura mínima de uma skill publicável:

minha-skill/
├── SKILL.md          # Obrigatório: instruções + metadata
├── resources/        # Opcional: docs de referência
│   └── api-docs.md
└── scripts/          # Opcional: automações
    └── validate.sh

Exemplo de SKILL.md mínimo:

---
name: "minha-skill-exemplo"
description: "Skill que faz X para contexto Y"
triggers:
  - "quando o usuário pedir X"
  - "quando o contexto envolver Y"
platforms:
  - claude-code
  - cursor
---

# Minha Skill

## Quando usar
Use esta skill quando...

## Instruções
1. Primeiro, faça...
2. Depois, verifique...
3. Finalmente, entregue...

Monetização

A monetização de skills no agentskill.sh segue modelos externos — a plataforma em si funciona como discovery layer, não como processador de pagamentos:

O caminho mais comum em 2026: publique skills gratuitas de alta qualidade para construir autoridade, depois monetize via consultoria ou versões enterprise.

💡 Se você desenvolve skills profissionalmente, o skilldev.pro é um marketplace focado em curadoria e qualidade — vale explorar como canal complementar ao agentskill.sh.

Prós e Contras

Prós

• Maior catálogo do mercado — 127K+ skills significa que provavelmente existe algo para seu caso de uso, por mais nichado que seja
• Security audit automatizado — verificação em 12 categorias de ameaça em duas camadas (server + client) é um diferencial real de segurança
• Quality Score transparente — pontuação 0-100 com breakdown por dimensão ajuda a filtrar rapidamente
• Multi-plataforma — funciona com 20+ agentes, sem lock-in
• MCP Server nativo — integração profunda que permite ao agente buscar e instalar skills autonomamente
• Skillsets/Bundles — instalação em lote para workflows completos
• CLI simples — npx skills add owner/repo e pronto

Contras

• Ruído massivo — 127K skills inclui muito lixo; 22% nem passam na validação básica segundo análises independentes
• Qualidade inconsistente — o volume cresce mais rápido que a curadoria; muitas skills são genéricas ou duplicadas
• Contaminação oculta — 52% dos tokens em skills analisadas são arquivos desnecessários que desperdiçam contexto
• Monetização imatura — não há checkout nativo; criadores dependem de plataformas externas
• Dependência de scores automatizados — Quality Score e Security Audit são úteis mas não substituem avaliação humana
• Curva de descoberta — mesmo com filtros, encontrar a skill certa entre 127K opções exige experiência

Veredicto

Ideal para: Desenvolvedores que querem acesso ao maior catálogo possível e sabem filtrar por qualidade. Times que precisam de skills para domínios nichados (healthcare, legal, finance) onde outros catálogos menores simplesmente não têm opções. Quem quer publicar skills e alcançar o maior público possível.

Não ideal para: Quem busca curadoria rigorosa sem esforço de filtragem. Se você prefere um catálogo menor mas 100% verificado manualmente, considere o skillscatalog.ai (security-scanned) ou o officialskills.sh (curado por vendors).

Recomendação prática: Use o agentskill.sh como seu catálogo primário de descoberta, mas aplique filtros rigorosos — Quality Score ≥ 75, Security Score ≥ 80. Configure o MCP Server para que seu agente faça a busca por você. E sempre revise o conteúdo de uma skill antes de instalar em projetos de produção.

Estratégia de Navegação: Como Encontrar Qualidade em 127K+ Skills

Para fechar, aqui vai um workflow prático para navegar o catálogo sem se perder:

1. Defina o problema primeiro

Não navegue por curiosidade. Comece com uma necessidade específica: “Preciso de uma skill para code review focado em segurança.”

2. Use filtros combinados

Platform: claude-code
Category: Development & Engineering
Quality: 75+
Security: 80+
Sort: Trending (7d)

3. Avalie os top 3 resultados

Para cada skill candidata, verifique:

• Quality Score breakdown (todas as dimensões ≥ 2?)
• Security Score (algum issue high?)
• Número de installs (validação social)
• Data da última atualização (skill abandonada?)

4. Teste antes de adotar

Instale em um projeto de teste primeiro. Verifique se a skill realmente melhora o output do agente para seu caso de uso específico.

5. Curadoria pessoal

Crie um skillset privado com suas skills validadas. Isso evita repetir o processo de descoberta toda vez.

O agentskill.sh é como um oceano — tem de tudo, mas você precisa saber pescar. Com os filtros certos e uma estratégia de avaliação, é a fonte mais completa de skills para agentes de codificação disponível hoje.