Criar Skills
Uma skill é simplesmente um arquivo Markdown com frontmatter YAML. Se você tem conhecimento de domínio que vale a pena compartilhar, escreva-o em um SKILL.md.
Estrutura do arquivo
SKILL.md
--- name: my-skill description: One sentence shown in lazy-load preview. version: 1.0.0 author: your-github-username tags: - laravel - php - testing --- # My Skill ## Overview What this skill teaches Claude and when to apply it. ## Conventions - Always use X instead of Y - Prefer Z pattern for ABC scenarios ## Examples ```php // Your code examples here ```
Campos do frontmatter
| Campo | Obrigatório | Descrição |
|---|---|---|
| name | Obrigatório | Identificador amigável para URL. |
| description | Obrigatório | Uma frase — exibida na prévia de lazy load e no catálogo. |
| version | Opcional | Versão semântica, ex. 1.0.0. |
| author | Opcional | Seu nome de usuário do GitHub. |
| tags | Opcional | Array de tags para busca e filtragem. |
Diretrizes de conteúdo
- ▸Seja específico. "Sempre usar
$query->whereNull('deleted_at')" é melhor do que "usar soft deletes". - ▸Inclua exemplos. Blocos de código tornam as instruções inequívocas.
- ▸Declare o contexto. A qual tipo de projeto, framework ou situação esta skill se aplica?
- ▸Mantenha o foco. Uma skill = um domínio. Não misture Laravel + segurança + testes em um único arquivo.
Enviar ao catálogo
- 1 Faça push da sua skill para um repositório público no GitHub.
- 2 Acesse a página de envio e insira a URL do repositório.
- 3 A API do Claude analisa sua skill quanto à segurança e qualidade.
- 4 Se aprovada, aparece no catálogo em minutos.
Análise de segurança
Cada skill enviada é analisada pelo Claude para detectar injeção de prompts, acesso não autorizado a arquivos e padrões de exfiltração de dados. Skills sinalizadas como perigosas são revisadas por um administrador. Manter sua skill focada em conhecimento — sem execução de código ou requisições externas — garante uma aprovação tranquila.