# Guia Definitivo: officialskills.sh

> Diretório curado de skills oficiais para agentes de codificação. Aprenda a navegar, instalar e submeter skills.

Source: https://agentify.ia.br/blog/officialskills-sh/

O officialskills.sh é um diretório curado de skills para agentes de codificação que se diferencia por um princípio simples: só entra o que foi escrito por quem realmente constrói o produto. Nada de filler gerado por IA, nada de skills genéricos sem manutenção. Se a Microsoft publica uma skill de Azure, é o time de Azure que escreveu. Se a Anthropic publica uma skill de MCP, é o time da Anthropic que mantém.

Num ecossistema onde diretórios como o skills.sh (Vercel) já ultrapassam 60.000 skills — e onde desenvolvedores reclamam que 80% do conteúdo comunitário é “AI slop” — o officialskills.sh aposta na curadoria como diferencial competitivo.

## Overview

O officialskills.sh é mantido pela equipe do [VoltAgent](https://voltagent.dev), um framework open-source de agentes em TypeScript. Funciona como frontend navegável para o repositório GitHub [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills), indexando skills publicados por times oficiais de desenvolvimento de software vendors.

### Números Atuais

 Métrica Valor Skills oficiais 581 Dev teams indexados 48 Categorias 9 Última atualização 16 de maio de 2026

### Posicionamento no Mercado

Enquanto o skills.sh da Vercel é o “npm de skills” — aberto, massivo, com leaderboard por instalações — o officialskills.sh é mais parecido com uma “awesome list” curada. A proposta não é competir em volume, mas em confiabilidade.

O modelo é gratuito. Não há planos pagos, assinaturas ou paywalls. O financiamento vem de sponsorships no repositório GitHub e slots de patrocínio na landing page.

### Compatibilidade com Agentes

As skills listadas no officialskills.sh são compatíveis com os principais agentes de codificação do mercado:

- **Claude Code** (Anthropic)

- **Codex** (OpenAI)

- **Google Antigravity**

- **Cursor**

- **GitHub Copilot**

- **OpenCode**

- **Kiro CLI**

A compatibilidade cross-platform é possível porque skills são, na essência, arquivos Markdown estruturados (SKILL.md) que qualquer agente compatível com o padrão pode consumir.

### Vendors Presentes

O diretório conta com skills de empresas como:

- Microsoft (Azure SDKs, M365, Copilot SDK)

- OpenAI (Codex, Figma, Playwright, Sentry)

- Anthropic (MCP builder, frontend design, PDF)

- Google (Workspace, Gemini, Firebase, Stitch)

- Cloudflare (Workers, D1, R2, Durable Objects)

- Sentry (SDKs para 15+ plataformas)

- Auth0 (SDKs para 10+ frameworks)

- Apollo GraphQL (Federation, Router, Rover)

- Hugging Face (CLI, datasets, model trainer)

- Flutter (20+ skills de desenvolvimento mobile)

- Trail of Bits (segurança, análise estática, smart contracts)

- Netlify (deploy, functions, edge, caching)

- HashiCorp (Terraform providers, stacks, modules)

- Expo (React Native, deployment, CI/CD)

- E mais 34 outros times

## Tutorial

### Navegando o Diretório

O officialskills.sh oferece uma interface web limpa com dois mecanismos de descoberta:

**1. Filtro por Publisher**

Na seção “Find Skills”, você encontra um dropdown com todos os publishers indexados. Selecione um vendor específico — como “Cloudflare” ou “Sentry” — para ver apenas as skills daquele time.

**2. Filtro por Categoria**

As 9 categorias disponíveis são:

 Categoria Skills infrastructure 146 development 100 ai-tools 77 security 63 workflows 61 data 56 design 38 testing 21 docs 19

Você pode combinar publisher + categoria para refinar a busca. Por exemplo: Microsoft + infrastructure mostra todas as skills de Azure.

### Instalando uma Skill

A instalação segue o padrão do ecossistema skills.sh. Cada skill no officialskills.sh aponta para um repositório GitHub, e a instalação é feita via CLI:

```
npx skills add <publisher>/<skill-name>
```

Por exemplo, para instalar a skill de Cloudflare Workers:

```
npx skills add cloudflare/skills/cloudflare
```

Ou a skill de Sentry para Next.js:

```
npx skills add getsentry/skills/sentry-nextjs-sdk
```

O comando `npx skills add` faz o seguinte:

- Clona o conteúdo da skill do repositório GitHub

- Coloca o arquivo SKILL.md no diretório canônico do seu projeto (geralmente `.kiro/skills/` ou `.claude/skills/` dependendo do agente)

- Cria symlinks para que o agente detecte a skill automaticamente

### Primeiro Uso: Instalando Skills de Segurança

Vamos a um cenário prático. Você está trabalhando num projeto Node.js e quer que seu agente tenha conhecimento de segurança. O Trail of Bits publica várias skills de segurança no officialskills.sh:

```
# Instalar skill de análise estática (CodeQL + Semgrep)
npx skills add trailofbits/skills/static-analysis

# Instalar skill de detecção de defaults inseguros
npx skills add trailofbits/skills/insecure-defaults

# Instalar skill de review diferencial de segurança
npx skills add trailofbits/skills/differential-review
```

Após a instalação, quando você pedir ao seu agente para “revisar a segurança deste PR”, ele terá o conhecimento procedimental do Trail of Bits para executar uma análise estruturada — não apenas sugestões genéricas.

### Uso Intermediário: Montando um Stack Completo

Digamos que você está construindo uma aplicação Next.js com Supabase e Sentry. Você pode montar um stack de skills oficial:

```
# Framework
npx skills add vercel-labs/skills/next-best-practices
npx skills add vercel-labs/skills/react-best-practices

# Database
npx skills add supabase/skills/postgres-best-practices

# Observabilidade
npx skills add getsentry/skills/sentry-nextjs-sdk
npx skills add getsentry/skills/sentry-workflow

# Deploy
npx skills add openai/skills/vercel-deploy

# Design
npx skills add addyosmani/skills/core-web-vitals
npx skills add addyosmani/skills/performance
```

Com esse stack instalado, seu agente de codificação passa a ter conhecimento especializado de cada camada da sua aplicação — escrito pelos próprios times que mantêm essas ferramentas.

### Configuração Avançada: Gerenciando Skills por Projeto

Cada projeto pode ter seu próprio conjunto de skills. A estrutura típica fica assim:

```
meu-projeto/
├── .kiro/
│ └── skills/
│ ├── next-best-practices/
│ │ └── SKILL.md
│ ├── sentry-nextjs-sdk/
│ │ └── SKILL.md
│ └── postgres-best-practices/
│ └── SKILL.md
├── src/
└── package.json
```

Para listar skills instaladas:

```
npx skills list
```

Para atualizar todas as skills para a versão mais recente:

```
npx skills update
```

Para remover uma skill:

```
npx skills remove <publisher>/<skill-name>
```

## Deep Dive

### Diferença entre Skills Oficiais e Community-Contributed

O officialskills.sh faz uma distinção clara que outros diretórios não fazem:

**Skills Oficiais (Vendor Skills)**

- Escritas pelo time de desenvolvimento do produto

- Mantidas junto com o produto (atualizadas quando a API muda)

- Documentação precisa e testada contra a versão atual

- Exemplos: `cloudflare/skills/cloudflare`, `getsentry/skills/sentry-nextjs-sdk`

**Skills Community-Adopted (Handpicked)**

- Escritas por contribuidores da comunidade

- Passaram pelo processo de review e curadoria

- Mantidas ativamente (skills abandonadas são removidas)

- Exemplos: `addyosmani/skills/performance`, `garrytan/skills/investigate`

A diferença prática é significativa. Uma skill oficial da Sentry para React Native, por exemplo, cobre:

- Setup completo do SDK

- Error monitoring

- Tracing

- Session replay

- Profiling

- Migrations de versões anteriores

Enquanto uma skill genérica de “Sentry setup” num diretório aberto pode ter informações desatualizadas, cobrir apenas o básico, ou até conter padrões incorretos.

### Processo de Submissão e Curadoria

O processo para adicionar uma skill ao officialskills.sh é deliberadamente simples mas seletivo:

- **Abra um PR** no repositório [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)

- **Adicione o link** do repositório GitHub da sua skill ao README

- **Aguarde avaliação** — o time do VoltAgent revisa a submissão

**Critérios de avaliação:**

- A skill é mantida ativamente?

- Tem documentação clara?

- Foi publicada por um time oficial ou contribuidor reputável?

- Não é conteúdo gerado por IA em massa?

O que **não** entra:

- Skills bulk-generated (geradas em lote por IA)

- Skills sem manutenção ativa

- Skills de autores sem histórico verificável

- Duplicatas de skills já existentes de vendors oficiais

Esse filtro é o que mantém o diretório em 581 skills enquanto o skills.sh tem 60.000+. É uma escolha deliberada de qualidade sobre quantidade.

### Arquitetura Interna

O officialskills.sh é tecnicamente simples:

- **Repositório GitHub** (`VoltAgent/awesome-agent-skills`) — fonte de verdade

- **Frontend web** (`officialskills.sh`) — interface de navegação e busca

- **Indexação automática** — o site lê os repositórios listados e extrai metadados (nome, descrição, publisher, categoria)

Cada skill no diretório aponta para um repositório GitHub real. Quando você instala via `npx skills add`, o CLI vai direto ao GitHub — o officialskills.sh é apenas o catálogo de descoberta.

### O Formato SKILL.md

Toda skill segue uma estrutura padronizada:

```
# Nome da Skill

Descrição curta do que a skill faz.

## Quando Usar

Triggers e contextos onde a skill deve ser ativada.

## Instruções

Conhecimento procedimental detalhado — como o agente
deve se comportar quando esta skill está ativa.

## Exemplos

Cenários concretos de uso.
```

O poder está na seção “Instruções”. É ali que o conhecimento especializado vive — padrões de código, decisões de arquitetura, workarounds conhecidos, best practices que não estão na documentação oficial.

### Integração com Agentes

A integração varia por agente, mas o princípio é o mesmo: o agente lê os arquivos SKILL.md do diretório de skills do projeto e incorpora esse conhecimento no seu contexto.

**Claude Code / Kiro CLI:**
Skills ficam em `.kiro/skills/` ou são referenciadas no `AGENTS.md`.

**Cursor:**
Skills podem ser referenciadas via `.cursorrules` ou diretório `.cursor/skills/`.

**GitHub Copilot:**
Copilot lê instruções de `.github/copilot-instructions.md` e diretórios de skills configurados.

**Google Antigravity:**
Suporta skills via diretório `.antigravity/skills/` ou configuração de projeto.

**OpenCode:**
Lê skills de `.opencode/skills/` automaticamente.

A beleza do formato Markdown é que ele é agnóstico de plataforma. A mesma skill funciona em qualquer agente que suporte o padrão — e em maio de 2026, são mais de 30 agentes compatíveis.

### Categorias em Detalhe

As 9 categorias do officialskills.sh cobrem o ciclo completo de desenvolvimento:

**Infrastructure (146 skills)** — A maior categoria. Dominada pela Microsoft com dezenas de skills de Azure (Blob Storage, Cosmos DB, Event Hubs, Key Vault, Service Bus, etc.), além de Cloudflare Workers, Netlify, e HashiCorp Terraform.

**Development (100 skills)** — Skills de frameworks e linguagens: Next.js best practices (Vercel), React Native (Callstack/Expo), Flutter (Google), Apollo GraphQL, e padrões de código.

**AI Tools (77 skills)** — Integrações com plataformas de IA: fal.ai (geração de imagem/vídeo/3D), Hugging Face (training, datasets), Google Gemini, OpenAI APIs, e Replicate.

**Security (63 skills)** — Dominada pelo Trail of Bits com skills de análise estática, property-based testing, threat modeling, e auditoria de smart contracts. Também inclui skills de segurança da OpenAI e Sentry.

**Workflows (61 skills)** — Automação e produtividade: Google Workspace (Gmail, Calendar, Drive, Sheets), Notion (knowledge capture, meeting intelligence), e skills de CI/CD.

**Data (56 skills)** — DuckDB (queries, file reading), MongoDB (schema design, query optimization), ClickHouse, e Neon Postgres.

**Design (38 skills)** — Frontend design (Anthropic), Figma integration (Figma + OpenAI), GSAP animations (GreenSock), e Stitch (Google Labs).

**Testing (21 skills)** — Playwright (OpenAI), property-based testing (Trail of Bits), Terraform acceptance tests (HashiCorp), e QA automatizado.

**Docs (19 skills)** — Geração e manutenção de documentação: PDF, PPTX, DOCX, Jupyter notebooks, e document release workflows.

## Prós e Contras

### Prós

**Confiabilidade das fontes** — Quando você instala `getsentry/skills/sentry-nextjs-sdk`, sabe que foi o time da Sentry que escreveu. Não é um random dev que leu a documentação e fez um resumo. É o conhecimento interno do time que constrói o produto.

**Zero AI slop** — O officialskills.sh rejeita explicitamente conteúdo gerado em massa por IA. Num ecossistema onde diretórios abertos estão inundados de skills genéricos e de baixa qualidade, essa curadoria é um diferencial real.

**Manutenção garantida** — Skills de vendors são atualizadas junto com o produto. Quando a Cloudflare lança uma nova feature de Workers, a skill `cloudflare/skills/cloudflare` é atualizada pelo mesmo time. Você não fica com conhecimento desatualizado.

**Profundidade técnica** — Skills oficiais tendem a ser significativamente mais detalhadas que skills comunitárias. A skill de Flutter, por exemplo, tem 22 sub-skills cobrindo desde layouts até concurrency e plugins nativos.

**Gratuito e aberto** — Sem paywalls, sem assinaturas, sem limites de instalação. O repositório é público no GitHub.

**Cross-platform** — As mesmas skills funcionam em Claude Code, Codex, Cursor, Copilot, Antigravity, OpenCode, e 30+ outros agentes.

### Contras

**Catálogo limitado** — 581 skills é muito menos que os 60.000+ do skills.sh ou 107.000+ do agentskill.sh. Se você precisa de uma skill de nicho (um framework obscuro, uma ferramenta interna), provavelmente não vai encontrar aqui.

**Viés para grandes vendors** — O diretório é dominado por Microsoft (150+ skills de Azure), o que faz sentido dado o critério de “times oficiais”, mas significa que ferramentas menores ou indie ficam sub-representadas.

**Sem busca textual avançada** — A interface web oferece filtro por publisher e categoria, mas não tem busca full-text. Se você não sabe o nome exato da skill ou do publisher, a navegação pode ser frustrante.

**Processo de submissão opaco** — Embora os critérios estejam documentados, não há SLA de review nem feedback estruturado para submissões rejeitadas. Você abre um PR e espera.

**Dependência de um único mantenedor** — O VoltAgent é uma empresa relativamente nova. Se o projeto for descontinuado, o diretório pode ficar desatualizado. O repositório GitHub mitiga parcialmente esse risco (é público e forkável), mas a interface web depende da manutenção ativa.

**Sem métricas de qualidade visíveis** — Diferente do skills.sh que tem leaderboard por instalações, o officialskills.sh não mostra popularidade, ratings, ou métricas de uso. Você confia na curadoria, mas não tem dados para comparar skills similares.

### Veredicto

**Ideal para:**

- Desenvolvedores que trabalham com stacks de grandes vendors (Azure, AWS via Cloudflare, Google Cloud, Sentry, Auth0)

- Times que priorizam confiabilidade sobre variedade

- Projetos enterprise onde skills não-verificadas representam risco

- Quem quer um ponto de partida curado sem garimpar em diretórios massivos

**Não é ideal para:**

- Desenvolvedores que precisam de skills de nicho ou ferramentas indie

- Quem busca skills comunitárias criativas e experimentais

- Projetos que precisam de skills customizadas para ferramentas internas

- Quem prefere métricas quantitativas (instalações, ratings) para decidir

### Quando Usar officialskills.sh vs Alternativas

 Cenário Melhor opção Preciso de skills confiáveis de vendors conhecidos officialskills.sh Quero explorar skills experimentais da comunidade skills.sh Preciso de volume e variedade máxima agentskill.sh Quero skills com security scan skills.sh (parceria com Snyk/Socket) Busco skills certificadas para Claude skillsdirectory.com

## Integrando officialskills.sh no Seu Workflow

A melhor forma de usar o officialskills.sh é como **ponto de partida curado**. Quando você inicia um novo projeto:

- Identifique as tecnologias do seu stack

- Navegue o officialskills.sh filtrando por publisher

- Instale as skills oficiais dos vendors que você usa

- Complemente com skills comunitárias de outros diretórios para gaps específicos

Essa abordagem em camadas dá a você o melhor dos dois mundos: a confiabilidade de skills oficiais como base, com a flexibilidade de skills comunitárias onde necessário.

Se você está construindo skills próprias e quer entender como estruturar, publicar e distribuir skills profissionais, o [skilldev.pro](https://skilldev.pro) oferece recursos avançados para desenvolvedores de skills — desde templates até marketplace com distribuição para múltiplos agentes.

## Conclusão

O officialskills.sh resolve um problema real: num ecossistema de skills que cresce exponencialmente, como você sabe em quem confiar? A resposta deles é simples — confie em quem constrói o produto.

Com 581 skills de 48 dev teams, o diretório não vai ganhar nenhuma competição de volume. Mas quando você instala uma skill do officialskills.sh, sabe que está recebendo conhecimento procedimental escrito por quem realmente entende a ferramenta — não um resumo da documentação feito por IA.

Para desenvolvedores que trabalham com stacks de grandes vendors e priorizam confiabilidade, é o melhor ponto de partida no ecossistema de skills de 2026.

[IMAGEM: Screenshot da interface do officialskills.sh mostrando a lista de publishers]

[IMAGEM: Diagrama comparando o modelo curado vs aberto de diretórios de skills]

[IMAGEM: Terminal mostrando instalação de skills via npx]

-->