Criar & Publicar Skills

Qualquer pessoa com uma conta Claw Buff pode criar e publicar skills no Marketplace de Skills.

Criando uma Skill

Navegue até o Marketplace de Skills e clique em Publicar Skill, ou vá diretamente ao Editor de Skills.

O Editor

O editor de skills tem dois painéis:

Painel esquerdo — conteúdo do SKILL.md:

Escreva as instruções da sua skill em Markdown. Este é o núcleo da skill — o documento de prompt que ensina o agente a realizar uma tarefa. Você também pode enviar arquivos de script opcionais (JS/TS) para comportamentos avançados.

Painel direito — Metadados:

Escrevendo um bom SKILL.md

A qualidade de uma skill depende inteiramente da clareza das suas instruções. Siga esta estrutura:

---
name: my-skill
description: O que esta skill faz em uma frase
version: 1.0.0
---

# My Skill

## Visão Geral
Explicação breve do que o agente pode fazer com esta skill.

## Comandos / Workflows
Instruções passo a passo que o agente deve seguir.
Seja específico sobre quais ferramentas usar e em que ordem.

## Exemplos
Mostre exemplos concretos de entrada/saída para que o agente
entenda o comportamento esperado.

## Limitações
O que esta skill não pode fazer ou não deve tentar.

Salvando e Publicando

Você tem duas opções:

• Salvar Rascunho — Salva a skill sem publicar. Apenas você pode ver rascunhos. Útil para skills em desenvolvimento.
• Publicar — Envia a skill para revisão e a torna disponível no marketplace após aprovação.

Processo de Revisão

Quando você publica uma skill, o seguinte acontece:

1. Verificação de segurança automatizada — Arquivos de script (se houver) são verificados para padrões maliciosos conhecidos (reverse shells, exfiltração de dados, roubo de credenciais).
2. Status de revisão — Skills com scripts que passam na verificação ficam como "pendente de revisão." Skills sem scripts (apenas SKILL.md) são aprovadas automaticamente.
3. Notificação — Você será notificado quando sua skill for aprovada ou rejeitada. Skills rejeitadas incluem uma nota de revisão explicando o motivo.

Gerenciando Suas Skills

Minhas Skills

Clique na aba Minhas Skills na página do marketplace para ver todas as suas skills e seus status:

Editando

Clique em qualquer uma das suas skills para abri-la no editor. Você pode atualizar:

• Conteúdo do SKILL.md
• Metadados (nome, descrição, categoria, tags)
• Número da versão
• Arquivos de script

Alterações em skills publicadas entram em vigor imediatamente após salvar.

Despublicando

Para remover temporariamente uma skill do marketplace sem excluí-la:

1. Abra a skill no editor
2. Clique em Despublicar na zona de perigo

A skill se torna um rascunho. Você pode republicá-la a qualquer momento.

Excluindo

Para excluir permanentemente uma skill:

1. Abra a skill no editor
2. Clique em Excluir na zona de perigo
3. Confirme a exclusão

Boas Práticas

1. Seja específico nas instruções. "Ajude o usuário com GitHub" é vago. "Use gh pr create para criar um pull request com as alterações staged" é acionável.
2. Inclua exemplos. Mostre ao agente como são boas entradas e saídas. Isso melhora dramaticamente a confiabilidade da skill.
3. Declare dependências. Se sua skill precisa de uma API key ou binário, mencione claramente no frontmatter e na descrição do SKILL.md.
4. Versione de forma significativa. Incremente a versão quando fizer alterações. Usuários e a plataforma rastreiam o histórico de versões.
5. Teste antes de publicar. Instale sua skill no seu próprio agente e verifique se funciona como esperado antes de torná-la pública.
6. Escreva uma descrição clara. Isso é o que os usuários veem primeiro. Seja concreto — o que essa skill vai realmente fazer pelo agente deles?