Validar Habilidades
Valida todas as habilidades em skills/ conforme a especificação agentskills.io e as melhores práticas do Claude Code.
Checklist de Validação
Para cada diretório de habilidade, verifique:
Conformidade com a Especificação (agentskills.io)
| Verificação | Regra |
|---|---|
Formato name | 1-64 caracteres, alfanumérico em minúsculas + hífens, sem hífens no início/fim/consecutivos |
name corresponde ao diretório | O nome do diretório deve ser igual ao campo name |
Tamanho description | 1-1024 caracteres, não vazia |
| Campos opcionais válidos | license, metadata, compatibility se presentes |
Melhores Práticas (Claude Code)
| Verificação | Regra |
|---|---|
| Formato da descrição | Terceira pessoa, descreve o que faz e quando usar |
| Tamanho do corpo | Menos de 500 linhas |
| Carregamento de um nível de profundidade | SKILL.md é o único ponto de entrada para disclosure progressiva: todo arquivo de referência deve ser acessível a partir de SKILL.md. Referências podem fazer cross-links entre si para navegação (veja nota abaixo). |
| Links estão em markdown | Use [texto](https://raw.githubusercontent.com/callstackincubator/agent-skills/main/caminho) e não nomes de arquivo simples |
| Sem redundância | Não repetir a descrição no corpo |
| Conciso | Adicionar apenas contexto que Claude ainda não possui |
Um nível de profundidade vs. cross-linking. A regra de um nível de profundidade tem como alvo cadeias de disclosure progressiva — uma referência que só pode ser descoberta ao carregar outra referência primeiro (
SKILL.md→a.md→b.md, ondeb.mdnão está linkado a partir deSKILL.md). Isso é um defeito: esconde conteúdo do carregador.A regra não proíbe cross-links de navegação. Conforme AGENTS.md, arquivos de referência terminam com um rodapé "Habilidades Relacionadas" que linka referências irmãs, e isso é obrigatório. Um cross-link é aceitável desde que ambos os pontos finais também sejam acessíveis diretamente a partir de
SKILL.md. Sinalize apenas uma referência que seja acessível exclusivamente por meio de outra referência.
Como Executar
-
Encontre todos os diretórios de habilidades:
fd -t d -d 1 . skills/ -
Para cada habilidade, leia
SKILL.mde verifique conforme as regras acima -
Relate problemas neste formato:
## Resultados da Validação ### skills/habilidade-exemplo - [PASS] formato name válido - [FAIL] name "exemplo" não corresponde ao diretório "habilidade-exemplo" - [PASS] tamanho da descrição OK (156 caracteres)