# Guia Definitivo: agentskill.sh

> Como navegar, instalar e publicar skills no maior marketplace de agent skills com 127K+ opções para Claude Code, Cursor e Copilot.

Source: https://agentify.ia.br/blog/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):

 Categoria Skills disponíveis Development & Engineering ~149.000+ Product Management ~45.000+ Data & Analytics ~32.000+ Marketing ~30.000+ Operations ~23.000+ Sales ~15.000+ Design ~13.000+ Education & Research ~10.000+ Project & Program Management ~9.000+ Customer Support ~7.700+ Content & Media ~7.600+ Finance & Accounting ~4.700+ Healthcare & Life Sciences ~2.700+ Legal ~2.500+ Human Resources ~1.600+ Real Estate ~260

[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](/guias/skills-sh/) ou [SkillKit](/guias/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:

- Busca a skill no registry do agentskill.sh

- Verifica o security score

- Baixa o conteúdo para o diretório local de skills

- 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:

- **Por Role** — clique na categoria profissional (Development, Marketing, etc.)

- **Por Platform** — filtre por agente compatível (Claude Code, Cursor, Copilot)

- **Por Trending** — veja o que está em alta nas últimas 24h ou 7 dias

- **Por Quality Score** — ordene por pontuação de qualidade (0-100)

- **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:

 Ferramenta Descrição search_skills Busca por keyword com filtros de plataforma, categoria e security score get_skill Detalhes completos incluindo SKILL.md, análise de segurança e review de qualidade install_skill Instala uma skill com verificações de segurança get_trending Skills hot (24h), trending (7d), top (all time) ou latest browse_skillsets Navega coleções curadas por workflow ou role install_skillset Instala todas as skills de um skillset de uma vez rate_skill Avalia uma skill de 1-5

[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:

- Acesse agentskill.sh e clique em **“Create Skillset”**

- Dê um nome e descrição ao bundle

- Adicione as skills que compõem o conjunto

- 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:

 Dimensão O que avalia Peso Discovery Metadata clara, triggers bem definidos, descrição útil 0-3 Implementation Instruções acionáveis, exemplos, completude 0-3 Structure Organização do SKILL.md, progressive disclosure, formatação 0-3 Expertise Profundidade do conhecimento, nuances, edge cases 0-3

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:

- **Server-side** — análise automatizada no momento da publicação

- **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](https://agentskillreport.com/) 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:

- **Crie a estrutura** — um repositório GitHub com `SKILL.md` na raiz

- **Siga a especificação** — metadata obrigatória (name, description, triggers)

- **Submeta** — via interface web ou CLI

- **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:

 Modelo Como funciona Vendas diretas Preço fixo via Gumroad/Lemon Squeezy, criador fica com ~80% Open core Skill básica gratuita + versão avançada paga Consultoria Skill gratuita como porta de entrada para serviços Sponsorships Visibilidade no catálogo gera patrocínios Assinatura MCP Pool de receita distribuído por uso real [VERIFICAR: disponibilidade deste modelo]

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](https://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](/guias/skillscatalog-ai/) (security-scanned) ou o [officialskills.sh](/guias/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.

-->