# Guia Definitivo: skillsmp.com

> SkillsMP é o maior marketplace de skills para agentes de IA com 1.4M+ skills, busca semântica e filtro por ocupação profissional.

Source: https://agentify.ia.br/blog/skillsmp/

Imagine ter 1,4 milhão de skills espalhadas pelo GitHub e precisar encontrar exatamente aquela que resolve seu problema. Você pode gastar horas navegando repositórios, lendo READMEs incompletos e testando skills que não fazem o que prometem. Ou pode usar o SkillsMP — um marketplace que indexa esse universo inteiro e te entrega resultados filtrados por profissão, categoria e relevância semântica. É a diferença entre procurar uma agulha no palheiro e pedir para alguém que já catalogou todas as agulhas te mostrar a certa.

## Overview

### O que é o SkillsMP

SkillsMP (Agent Skills Marketplace) é uma plataforma de descoberta de skills para agentes de codificação. Diferente de um diretório estático onde você navega por listas, o SkillsMP funciona como um motor de busca especializado — com busca por palavras-chave, busca semântica por IA, e um sistema único de classificação por ocupação profissional baseado na taxonomia SOC (Standard Occupational Classification) do Departamento do Trabalho dos EUA.

O projeto é independente — não é afiliado à Anthropic nem à OpenAI. Todas as skills são indexadas de repositórios públicos do GitHub e seguem o padrão aberto `SKILL.md`, compatível com Claude Code, OpenAI Codex CLI e ChatGPT.

### Números atuais

 Métrica Valor Skills indexadas 1.419.713+ Ocupações mapeadas 867 (23 grupos principais) Categorias 12 principais Idiomas da interface 9 Versão v0.1.0 API REST + MCP Server Preço Gratuito

### Posicionamento no mercado

O SkillsMP se diferencia dos outros catalogadores de skills em três eixos:

- **Escala** — com 1,4M+ skills indexadas, é o maior acervo disponível. Para comparação, o agentskill.sh tem 107K+ e o SkillKit agrega 400K+ de 31 fontes.

- **Busca inteligente** — oferece tanto busca por palavras-chave (full-text search) quanto busca semântica por IA (Cloudflare AI com embeddings vetoriais). Você pode digitar “como criar um web scraper” em linguagem natural e receber resultados relevantes.

- **Classificação por ocupação** — nenhum outro catalogador organiza skills por profissão. O SkillsMP mapeia cada skill para ocupações específicas usando a taxonomia SOC, permitindo que um contador encontre skills de contabilidade, um advogado encontre skills jurídicas, e um DevOps encontre skills de infraestrutura — sem precisar saber os termos técnicos exatos.

### Modelo de execução

O SkillsMP é uma plataforma web (não é CLI nem IDE). Você acessa pelo navegador, busca skills, e recebe comandos de instalação prontos para copiar no terminal. A plataforma também oferece:

- **API REST** para acesso programático

- **MCP Server** para integração direta com agentes

- **Integração com skills.sh** para instalação one-click via CLI

### Preço

Totalmente gratuito. O projeto é mantido por um desenvolvedor independente e aceita doações via Ko-fi. A API tem rate limits generosos:

 Acesso Limite diário Limite por minuto Anônimo (sem API key) 50 requests 10 requests Autenticado (com API key) 500 requests 30 requests

## Tutorial

### Navegação básica: encontrando skills

A forma mais direta de usar o SkillsMP é pela busca na homepage. Vamos ao passo-a-passo:

#### 1. Busca por palavras-chave

Acesse [skillsmp.com](https://skillsmp.com) e use a barra de busca no topo. Digite termos técnicos específicos:

```
SEO optimization
terraform deployment
react testing
```

Os resultados aparecem em layout masonry com descrições expandidas. Você pode ordenar por:

- **Stars** — popularidade no GitHub (indicador de qualidade)

- **Recent** — skills mais recentemente atualizadas

#### 2. Filtro por categoria

Se você não sabe exatamente o que procura, navegue por categorias. As 12 principais:

 Categoria Skills Tools 340.854 Business 249.376 Development 202.543 Testing & Security 146.642 Data & AI 133.453 DevOps 114.069 Documentation 97.418 Content & Media 87.176 Research 51.212 Lifestyle 19.289 Databases 16.448 Blockchain 11.488

#### 3. Filtro por ocupação

Aqui está o diferencial matador. Clique em “Occupations” no menu superior e navegue pela taxonomia SOC:

```
Computer and Mathematical Occupations → 790.963 skills
 └── Software Developers → 500K skills
 └── Information Security Analysts → 46K skills
 └── Web Developers → 35K skills
 └── Database Architects → 13K skills

Business and Financial Operations → 119.144 skills
 └── Project Management Specialists → 50K skills
 └── Market Research Analysts → 34K skills
 └── Compliance Officers → 2.5K skills

Arts, Design, Entertainment → 54.901 skills
 └── Writers and Authors → 16K skills
 └── Graphic Designers → 12K skills
 └── Technical Writers → 7.5K skills
```

Isso significa que um gerente de projetos pode ir direto em “Project Management Specialists” e encontrar skills específicas para sua rotina — sem precisar filtrar manualmente entre milhares de skills de desenvolvimento.

#### 4. Busca semântica (AI Search)

A busca semântica entende intenção, não apenas palavras-chave. Exemplos:

 Busca O que retorna ”How to create a web scraper” Skills de web scraping, automação, parsing ”Skills for trading” Skills de finanças, análise de mercado, backtesting ”Help me write better tests” Skills de testing, TDD, code quality

A busca semântica usa Cloudflare AI com embeddings vetoriais. Ela é especialmente útil quando você não sabe o nome técnico do que precisa — descreva o problema em linguagem natural e deixe a IA encontrar.

[IMAGEM: Screenshot da interface de busca do SkillsMP mostrando resultados com filtros aplicados]

### Instalando skills encontradas

Quando você encontra uma skill no SkillsMP, a página de detalhes mostra:

- Descrição completa

- Estrutura de arquivos (file browser com syntax highlighting)

- Stars no GitHub

- Data da última atualização

- Comandos de instalação

#### Para Claude Code

```
# Clone o repositório da skill
git clone https://github.com/autor/repo-da-skill.git

# Copie para o diretório de skills pessoais
cp -r repo-da-skill/skill-name ~/.claude/skills/

# Ou para skills de projeto (compartilhadas com o time)
cp -r repo-da-skill/skill-name .claude/skills/
```

#### Para OpenAI Codex CLI

```
# Mesmo formato SKILL.md, diretório diferente
cp -r repo-da-skill/skill-name ~/.codex/skills/
```

#### Via skills.sh (one-click)

Desde janeiro de 2026, o SkillsMP integra com o [skills.sh](https://skills.sh) para instalação via CLI:

```
# Com npx
npx skills install nome-da-skill

# Com bunx
bunx skills install nome-da-skill

# Com pnpm
pnpm dlx skills install nome-da-skill
```

#### Via MCP Server

Se seu agente suporta Model Context Protocol, você pode conectar diretamente ao SkillsMP:

```
POST https://skillsmp.com/mcp
```

O MCP Server expõe 4 ferramentas:

- `search_skills` — busca por palavras-chave com filtros

- `get_skill` — detalhes de uma skill específica

- `list_categories` — listar categorias disponíveis

- `ai_search_skills` — busca semântica em linguagem natural

Isso permite que seu agente descubra e instale skills automaticamente durante uma sessão de trabalho.

[IMAGEM: Diagrama do fluxo de instalação: SkillsMP → GitHub → diretório local do agente]

### Uso intermediário: combinando filtros

O poder real do SkillsMP aparece quando você combina filtros. Cenário: você é um DevOps engineer que precisa de skills para automação de CI/CD.

```
# Via API — combinar ocupação + categoria + ordenação
curl -X GET "https://skillsmp.com/api/v1/skills/search?\
q=automation&\
occupation=software-developers-151252&\
category=devops&\
sortBy=stars" \
-H "Authorization: Bearer sk_live_sua_api_key"
```

Pela interface web, o mesmo fluxo:

- Vá em Occupations → Computer and Mathematical → Software Developers

- Na barra de busca, digite “CI/CD automation”

- Ordene por Stars para ver as mais populares primeiro

### Configuração avançada: API programática

Para integrar o SkillsMP em seus workflows, registre-se (Google ou GitHub OAuth) e gere uma API key no Developer Portal.

#### Autenticação

```
# Toda request autenticada usa Bearer token
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
-H "Authorization: Bearer sk_live_sua_api_key"
```

#### Exemplo em Python

```
import requests

def buscar_skills(query, categoria=None, ocupacao=None):
 params = {
 'q': query,
 'sortBy': 'stars',
 'limit':
 }
 if categoria:
 params['category'] = categoria
 if ocupacao:
 params['occupation'] = ocupacao

 response = requests.get(
 'https://skillsmp.com/api/v1/skills/search',
 params=params,
 headers={'Authorization': 'Bearer sk_live_sua_api_key'}
 )
 return response.json()

# Buscar skills de testing para desenvolvedores
resultados = buscar_skills(
 query='unit testing',
 categoria='testing-security',
 ocupacao='software-developers-151252'
)

for skill in resultados['data']['skills']:
 print(f"{skill['name']} - ⭐ {skill['stars']}")
```

#### Exemplo em JavaScript

```
const buscarSkills = async (query, options = {}) => {
 const params = new URLSearchParams({
 q: query,
 sortBy: 'stars',
 limit: '20',
 ...options
 });

 const response = await fetch(
 `https://skillsmp.com/api/v1/skills/search?${params}`,
 {
 headers: {
 'Authorization': 'Bearer sk_live_sua_api_key'
 }
 }
 );

 return response.json();
};

// Buscar skills de automação
const resultado = await buscarSkills('automation', {
 category: 'devops',
 occupation: 'software-developers-151252'
});
```

## Deep Dive

### Como a busca inteligente funciona

O SkillsMP opera com dois motores de busca em paralelo:

#### Motor 1: Full-text search (palavras-chave)

A busca por palavras-chave usa indexação full-text otimizada. Quando você digita “terraform deployment”, o sistema:

- Tokeniza a query

- Busca matches exatos e parciais no título, descrição e conteúdo das skills

- Aplica filtros de categoria e ocupação como cláusulas adicionais

- Ranqueia por relevância textual + stars do GitHub

Esse motor é rápido ( Integração Status Descrição Claude Code ✅ Ativo Comandos de instalação diretos OpenAI Codex CLI ✅ Ativo Mesmo formato SKILL.md ChatGPT ✅ Comunidade Via extensões não-oficiais skills.sh ✅ Ativo One-click install via CLI Manus ✅ Ativo Run any skill with one click MCP Server ✅ Ativo Integração nativa com agentes Cursor 🟡 Parcial Via plugins da comunidade

### Como publicar skills na plataforma

O SkillsMP não tem um processo de “submit” tradicional. O fluxo é:

- **Crie sua skill** no formato `SKILL.md` (seguindo a [especificação oficial](https://agentskills.io))

- **Publique no GitHub** como repositório público

- **Garanta mínimo 2 stars** — o scraper do SkillsMP filtra repos com menos de 2 stars

- **Aguarde o sync** — o scraper roda regularmente e indexa novos repositórios automaticamente

#### Estrutura mínima de uma skill

```
---
name: minha-skill
description: "Descrição clara do que a skill faz"
---

# Minha Skill

## Quando usar

Descreva os cenários de ativação.

## Instruções

Passo-a-passo do que o agente deve fazer.
```

#### Dicas para ser encontrado

- **Descrição clara** — a busca semântica indexa a descrição. Seja específico sobre o que a skill resolve.

- **Tags relevantes** — use termos que seu público-alvo buscaria.

- **README completo** — o file browser do SkillsMP mostra o conteúdo. Um README bem escrito aumenta a confiança.

- **Stars** — peça feedback da comunidade. Mais stars = mais visibilidade na ordenação.

### Timeline e Insights

O SkillsMP oferece uma página de Timeline (`/timeline`) que visualiza a atividade de skills ao longo do tempo:

- Granularidade diária, semanal ou mensal

- Gráficos de área ou barras

- Tendências de publicação e crescimento

Isso é útil para identificar quais categorias estão crescendo mais rápido e onde a comunidade está investindo energia.

### Segurança: o que considerar

Um estudo acadêmico (arXiv:2601.10338) analisou 31.132 skills de marketplaces e encontrou:

- **26,1%** contêm pelo menos uma vulnerabilidade

- **5,2%** apresentam padrões sugestivos de intenção maliciosa

Os riscos principais são:

- **Prompt injection** — skills que processam texto externo podem ter instruções embutidas

- **Vazamento de informação** — skills que interagem com APIs podem expor tokens

- **Supply chain attacks** — dependências externas podem ser substituídas depois

O SkillsMP mitiga parcialmente com o filtro de 2 stars mínimas e a verificação de fonte GitHub, mas **não faz scanning de segurança profundo**. A recomendação oficial é clara: **sempre revise o código antes de instalar**.

Para contexto, o [skillscatalog.ai](/guias/skillscatalog-ai/) é o único catalogador que oferece security scanning certificado. Se segurança é prioridade absoluta, considere usá-lo como complemento.

## Prós e Contras

### Prós

- **Maior acervo disponível** — 1,4M+ skills é uma ordem de magnitude acima de qualquer concorrente. Se a skill existe, provavelmente está aqui.

- **Busca semântica genuinamente útil** — a capacidade de descrever um problema em linguagem natural e receber skills relevantes reduz drasticamente o tempo de descoberta. Não é gimmick — funciona.

- **Classificação por ocupação é inovadora** — nenhum outro catalogador pensa em termos de “para qual profissional isso serve”. Isso abre o ecossistema de skills para além de desenvolvedores.

- **API e MCP Server** — acesso programático permite integrar a descoberta de skills em pipelines automatizados. O MCP Server é particularmente elegante para agentes que precisam se auto-equipar.

- **Gratuito e sem fricção** — não precisa de conta para buscar. A API anônima (50 req/dia) é suficiente para uso pessoal casual.

- **Multi-idioma** — interface em 9 idiomas (incluindo português) reduz a barreira de entrada.

- **File browser integrado** — ver o código-fonte da skill sem sair da plataforma economiza cliques e contexto.

### Contras

- **Sem curadoria de qualidade** — 1,4M de skills significa muito ruído. O filtro de 2 stars é mínimo. Muitas skills são geradas por IA sem revisão humana, e distinguir qualidade exige inspeção manual.

- **Sem sistema de reviews/ratings** — diferente de um marketplace maduro (npm, VS Code extensions), não há reviews de usuários, ratings, ou badges de qualidade. Está no roadmap, mas ainda não existe.

- **Classificação por ocupação incompleta** — 76% classificadas significa que ~24% das skills não aparecem quando você filtra por ocupação. Skills recém-indexadas podem demorar para serem classificadas.

- **Sem verificação de segurança** — o SkillsMP não escaneia skills por vulnerabilidades. Dado que 26% das skills em marketplaces têm alguma vulnerabilidade (segundo pesquisa acadêmica), isso é um risco real.

- **Projeto de uma pessoa** — mantido por um desenvolvedor independente. Isso traz risco de continuidade e limita a velocidade de evolução. Se o mantenedor parar, o projeto pode estagnar.

- **Busca semântica requer autenticação** — o recurso mais diferenciado (AI search) não funciona sem API key. Para uso casual, você fica limitado à busca por palavras-chave.

- **Sem instalação nativa** — o SkillsMP mostra comandos de instalação, mas não instala diretamente. Você ainda precisa clonar repos e copiar arquivos manualmente (exceto via integração com skills.sh).

### Veredicto

**Ideal para**: desenvolvedores que trabalham com Claude Code ou Codex CLI e precisam descobrir skills rapidamente. Especialmente valioso se você trabalha em domínios específicos (finanças, legal, saúde) e quer encontrar skills de nicho sem vasculhar o GitHub manualmente. Também excelente para quem quer integrar descoberta de skills em pipelines automatizados via API/MCP.

**Não ideal para**: quem prioriza segurança acima de tudo (prefira skillscatalog.ai), quem quer instalação one-click sem fricção (prefira SkillKit CLI), ou quem precisa de curadoria humana rigorosa (prefira officialskills.sh).

**Recomendação**: use o SkillsMP como seu **motor de descoberta principal** — a escala e a busca semântica são imbatíveis. Mas trate-o como o primeiro passo, não o último. Sempre revise o código, verifique a reputação do autor no GitHub, e teste em ambiente isolado antes de adotar uma skill em produção.

---

Se você está construindo skills e quer que elas sejam encontradas por profissionais do seu domínio, o SkillsMP é onde você quer estar. Com 1,4M+ skills indexadas e crescendo, a plataforma se consolidou como o ponto de entrada para descoberta no ecossistema de agentes de codificação.

Quer ir além da descoberta e criar skills profissionais que se destacam no marketplace? O [skilldev.pro](https://skilldev.pro) oferece ferramentas e templates para desenvolvedores que querem publicar skills de alta qualidade — com estrutura, documentação e padrões que garantem visibilidade e adoção.

-->